Metadata-Version: 2.1
Name: mtcli
Version: 0.27.4
Summary: Converte gráfico do MetaTrader 5 para texto
Home-page: https://github.com/vfranca/mtcli
License: BSD-3-Clause
Keywords: MetaTrader 5,trading,CLI
Author: Valmir Franca
Author-email: vfranca3@gmail.com
Requires-Python: >=3.8,<4
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: click (>=8.0.3,<9.0.0)
Requires-Dist: metatrader5 (>=5.0.43,<6.0.0)
Requires-Dist: numpy (>=1.24,<2.0)
Requires-Dist: python-dotenv (>=0.19,<0.20)
Project-URL: Documentation, https://vfranca.github.io/mtcli/
Project-URL: Repository, https://github.com/vfranca/mtcli
Description-Content-Type: text/markdown

# mtcli  
  
Aplicativo de Linha de comando para converter dados do MetaTrader 5 para formato TXT.  
O formato TXT é especialmente acessado por tecnologias assistivas para cegos.  

[mtcli no PyPI](https://pypi.python.org/pypi/mtcli)  
  
## Pré-requisitos  

1. Windows 10 ou 11 com conta Administrador ativada.  
2. Leitor de tela NVDA instalado.  
  
Para ativar a conta administrador execute o seguinte comando no terminal CMD:  
```CMD
> net user Administrador /active:yes
```
    
O mtcli não foi testado com outros leitores de tela além do NVDA.  
  

## Instalação  

### MetaTrader 5 (mt5)
Faça o download do MT5 e execute o instalador.  
[clique aqui para baixar o instalador MT5para Windows](https://www.metatrader5.com/pt)  
  
### Indicador mtcli
Faça o download do indicador mtcli e anexe a um gráfico  no MetaTrader 5.  
[Clique aqui para baixar o indicador mtcli](https://tinyurl.com/vfranca-mtcli)  
  
### Python
Instale o interpretador de comandos Python.  
Execute o comando abaixo no CMD do Windows:  
```CMD
> winget install --scope machine Python.Python.3.11
```

[Clique aqui para ver outras formas de instalar o Python](python.md)


### mtcli

Execute o comando abaixo no CMD do Windows para instalar o mtcli:  
```CMD
> pip install mtcli
```

## Comandos  
  
comando | descrição
:----- | :------
mt bars --period d1 --count 20 ibov | exibe 20 barras do diário do IBOV
mt mm --period d1 --count 20 ibov | exibe a média móvel simples de 20 dias do IBOV
mt rm --period d1 --count 20 ibov | exibe o range médio de 20 dias do IBOV
  
Digite a opção --help para exibir um resumo das opções.  

## abreviaturas  

abreviaturas empregadas na exibição da barra/candle:    

abreviatura | descrição 
:----- | :------
ASC | barra ascendente 
DESC |  barra descendente
OB | barra externa 
IB | barra interna 
G | gap do fechamento em relação à máxima ou mínima anterior
TOP | sombra superior
BOTTOM | sombra inferior
R | range
MP | ponto médio da barra


## Agradecimentos  
  
Ao @MaiconBaggio fornecedor do primeiro EA exportador das cotações para CSV.  
Ao Claudio Garini que transferiu a exportação das cotações para um indicador.  

