{"id":23681713,"url":"https://github.com/vilhalva/cmd-autonomo","last_synced_at":"2026-02-23T18:33:39.338Z","repository":{"id":224609901,"uuid":"763676626","full_name":"VILHALVA/CMD-AUTONOMO","owner":"VILHALVA","description":"👨‍🏫CMD AUTÔNOMO É UM APP EM PYTHON COM INTERFACE GRÁFICA (CUSTOMTKINTER) PARA EXECUTAR SCRIPTS PYTHON DE FORMA SIMPLES, SEM USAR O TERMINAL.","archived":false,"fork":false,"pushed_at":"2025-09-15T15:13:08.000Z","size":129405,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-25T22:26:55.531Z","etag":null,"topics":["aplicativo","customtkinter","framework","installer","interface","projeto","python","txt","update","windows"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/VILHALVA.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-02-26T18:12:44.000Z","updated_at":"2025-09-15T15:13:12.000Z","dependencies_parsed_at":"2024-04-11T02:29:09.728Z","dependency_job_id":"4cbb6e83-4389-4991-970b-80afc55060e0","html_url":"https://github.com/VILHALVA/CMD-AUTONOMO","commit_stats":null,"previous_names":["vilhalva/cmd-autonomo"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/VILHALVA/CMD-AUTONOMO","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VILHALVA%2FCMD-AUTONOMO","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VILHALVA%2FCMD-AUTONOMO/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VILHALVA%2FCMD-AUTONOMO/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VILHALVA%2FCMD-AUTONOMO/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/VILHALVA","download_url":"https://codeload.github.com/VILHALVA/CMD-AUTONOMO/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VILHALVA%2FCMD-AUTONOMO/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29750609,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-23T07:44:07.782Z","status":"ssl_error","status_checked_at":"2026-02-23T07:44:07.432Z","response_time":90,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aplicativo","customtkinter","framework","installer","interface","projeto","python","txt","update","windows"],"created_at":"2024-12-29T18:41:24.576Z","updated_at":"2026-02-23T18:33:39.314Z","avatar_url":"https://github.com/VILHALVA.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# CMD AUTONOMO\r\n👨‍🏫CMD AUTÔNOMO É UM APP EM PYTHON COM INTERFACE GRÁFICA (CUSTOMTKINTER) PARA EXECUTAR SCRIPTS PYTHON DE FORMA SIMPLES, SEM USAR O TERMINAL.\r\n\r\n\u003cimg src=\"FOTO.png\" align=\"center\" width=\"400\"\u003e \u003cbr\u003e\r\n\r\n## DESCRIÇÃO:\r\n**CMD AUTÔNOMO** é uma aplicação desenvolvida em Python com interface gráfica utilizando a biblioteca `customtkinter`. Seu objetivo é permitir a execução fácil e visual de scripts Python diretamente a partir de um ambiente gráfico, sem a necessidade de abrir o terminal.\r\n\r\n## RECURSOS:\r\n1. **Seleção de arquivos Python**: O usuário pode selecionar qualquer arquivo `.py` do sistema por meio de um botão que abre o explorador de arquivos.\r\n\r\n2. **Botões de controle**:\r\n   * **INICIAR**: Executa o script Python selecionado.\r\n   * **PARAR**: Interrompe a execução do script em andamento.\r\n   * **COPIAR**: Copia a saída gerada (stdout) para a área de transferência.\r\n   * **LIMPAR**: Limpa o campo de seleção de arquivo e a área de status, reseta o switch de **LOG** para OFF e desabilitado, e retorna a aplicação ao estado inicial.\r\n\r\n3. **Área de status**: Exibe a saída do script em tempo real, além de mensagens informativas, avisos e erros.\r\n\r\n4. **Log de execução (opcional)**: O usuário pode ativar o modo de log, que salva automaticamente toda a saída gerada em um arquivo `CMD AUTONOMO_DATA_HORA.txt` dentro do subdiretório **LOG** da pasta do arquivo selecionado. O sistema também cria ou atualiza o `.gitignore` para incluir a pasta `LOG`, evitando que os arquivos de log sejam versionados.\r\n\r\n5. **Gerenciamento seguro de processos**: Utiliza a biblioteca `psutil` para encerrar processos Python de forma segura, incluindo subprocessos filhos.\r\n\r\n## COMPORTAMENTO DOS CAMPOS E BOTÕES:\r\n1. **Campo de seleção de arquivo**:\r\n   * Inicialmente desabilitado para edição direta e vazio.\r\n   * Habilita os botões **INICIAR** e **LIMPAR**, além do **switch de LOG**, após a seleção de um arquivo válido.\r\n\r\n2. **Botões de controle**:\r\n   * **INICIAR**:\r\n     * Inicia a execução do script.\r\n     * Desabilita o botão de seleção de arquivo.\r\n     * Habilita os botões **PARAR** e **COPIAR**.\r\n   * **PARAR**:\r\n     * Interrompe a execução do script em andamento.\r\n     * Reabilita o botão de seleção de arquivo.\r\n     * Habilita os botões **INICIAR**, **COPIAR** e **LIMPAR**.\r\n   * **LIMPAR**:\r\n     * Limpa o campo de seleção de arquivo e a área de status.\r\n     * Reseta o switch de **LOG** para OFF e desabilitado.\r\n     * Desabilita todos os botões, exceto o de seleção de arquivo.\r\n   * **COPIAR**:\r\n     * Copia a saída da execução para a área de transferência.\r\n     * Exibe uma mensagem temporária de confirmação (\"TEXTO COPIADO!\").\r\n\r\n3. **Switch de LOG**:\r\n   * Inicialmente desabilitado até que um arquivo seja selecionado.\r\n   * Ao ser ativado, cria um novo arquivo de log dentro do subdiretório **LOG** da pasta do arquivo selecionado, usando data e hora no nome para organizar os registros por sessão.\r\n   * Se o `.gitignore` não existir, é criado; caso exista mas não contenha `LOG`, a linha é adicionada ao final.\r\n   * Toda a saída posterior é salva automaticamente nesse arquivo.\r\n   * Pode ser desativado a qualquer momento, voltando para a posição OFF e mantendo consistência visual.\r\n\r\n## PORQUE CRIEI ESSE APP?\r\n- O aplicativo `CMD AUTÔNOMO` foi desenvolvido para simplificar a execução de bots Python diretamente pelo console, inspirado no conceito do \"nodemon\", eliminando a necessidade de reinicialização manual após modificações no código.\r\n\r\n## OBSERVAÇÃO:\r\n1. **Limitações da Ferramenta:**\r\n   - O CMD AUTÔNOMO não substitui um ambiente de desenvolvimento integrado (IDE) ou outras ferramentas mais avançadas para desenvolvimento e execução de código.\r\n   - Não oferece suporte para a execução de comandos complexos do sistema operacional diretamente pelo aplicativo.\r\n\r\n2. **Requisitos de Instalação e Configuração:**\r\n   - É necessário que o **Python esteja instalado e corretamente configurado** no sistema para que o aplicativo funcione como esperado.\r\n   - Além disso, **todas as dependências do script que será executado devem estar previamente instaladas**. Isso inclui bibliotecas e pacotes utilizados no código Python que você pretende rodar por meio da aplicação.\r\n\r\n3. **Suporte de Linguagem:**\r\n   - O aplicativo suporta apenas a execução de scripts Python e não oferece suporte para outras linguagens de programação.\r\n\r\n## COMO USAR O APLICATIVO?\r\n1. **Instale as Dependências:**\r\nAntes de iniciar o aplicativo, é necessário instalar as bibliotecas utilizadas no projeto. No terminal, execute:\r\n\r\n```bash\r\npip install -r requirements.txt\r\n```\r\n\r\n\u003e 💡 O arquivo `requirements.txt` está localizado dentro da pasta `./CODIGO`.\r\n\r\n2. **Executando o Aplicativo:**\r\n   Navegue até o diretório `./CODIGO` e execute o script com o comando:\r\n\r\n   ```bash\r\n   python CODIGO.py\r\n   ```\r\n\r\n3. **Interface e Funcionalidades:**\r\n   * Clique em **SELECIONAR** → escolha um script `.py`.\r\n   * Clique em **INICIAR** → execute o script escolhido (habilitado só após selecionar arquivo válido).\r\n   * Clique em **PARAR** → interrompa a execução em andamento.\r\n   * Clique em **COPIAR** → copie toda a saída exibida para a área de transferência (mensagem de confirmação aparece).\r\n   * Clique em **LIMPAR** → apague seleção, saída, desative LOG e volte ao estado inicial.\r\n   * Ative o **switch LOG** → grave saída em `LOG/CMD_AUTONOMO_DATA_HORA.txt`, crie/atualize `.gitignore` e evite versionamento.\r\n   * Desative o **switch LOG** → pare o registro mantendo consistência visual.\r\n\r\n4. **Campo de Seleção de Arquivo:**\r\n   * Exibe o caminho do script escolhido (somente leitura).\r\n   * Atualiza automaticamente após **SELECIONAR**.\r\n   * Ativa os botões **INICIAR** e **LIMPAR** ao escolher um arquivo válido.\r\n\r\n## SOBRE O EXECUTAVEL E O INSTALADOR:\r\n### 1. EXECUTANDO O INSTALADOR:\r\n   - O instalador está localizado no diretório `./APP` e está disponível apenas para sistemas **Windows x64**. Para realizar a instalação, basta **dar dois cliques no arquivo** e seguir as instruções exibidas na tela.\r\n\r\n   - Ao executar o **instalador** deste aplicativo, **é possível que seu antivírus exiba um alerta de segurança**. Isso **não significa que o aplicativo é malicioso**, mas sim que o antivírus está reagindo ao comportamento comum de programas que executam comandos do sistema, como é o caso deste projeto.\r\n\r\n   **Para lidar com isso, há 2 alternativas:**\r\n\r\n   1. **Adicionar uma exceção no antivírus:**\r\n      - Inclua o arquivo `instalador` do aplicativo na **lista de exclusões (exceções)** do seu antivírus. Esse procedimento pode variar conforme o antivírus utilizado, mas normalmente está disponível nas configurações de segurança, na seção de \"Exclusões\", \"Ameaças permitidas\" ou \"Pastas confiáveis\". Isso permitirá que o aplicativo rode normalmente sem gerar bloqueios ou alertas.\r\n\r\n   2. **Executar diretamente o código-fonte (`CODIGO.py`):**\r\n      - Caso prefira uma abordagem mais transparente, você pode simplesmente **executar o script Python original** (`CODIGO.py`) utilizando um ambiente Python instalado na sua máquina. Essa abordagem permite verificar o código antes da execução, e **reduz drasticamente a chance de alertas**, pois o antivírus entende que você está executando um script legítimo de forma explícita.\r\n\r\n### 2. GERANDO O EXECUTAVEL:\r\n\u003e **IMPORTANTE:** Antes de criar o instalador, é necessário gerar o arquivo `CMD AUTONOMO.exe`. Para isso, siga os passos abaixo:\r\n\r\n   **1. Instalação do PyInstaller:**\r\n   * Certifique-se de ter o PyInstaller instalado. Se não tiver, instale usando o comando abaixo:\r\n   ```bash\r\n   pip install pyinstaller\r\n   ```\r\n\r\n   **2. Gerando o Executável:**\r\n   * No diretório `./CODIGO`, utilize o comando abaixo para gerar o executável:\r\n\r\n   ```bash\r\n   pyinstaller EXECUTAVEL.spec\r\n   ```\r\n\r\n   * O executável `CMD AUTONOMO.exe` será criado na pasta `./CODIGO/dist`.\r\n   * Após a geração, você pode excluir a pasta `./CODIGO/build`.\r\n\r\n### 3. GERANDO O INSTALADOR:\r\n#### PASSO 1: BAIXAR E INSTALAR O INNO SETUP:\r\n1. **Download**: Baixe o Inno Setup do site oficial: [Inno Setup](http://www.jrsoftware.org/isdl.php).\r\n2. **Instalação**: Siga o assistente de instalação para instalar o Inno Setup no seu sistema.\r\n\r\n#### PASSO 2: CRIAR O INSTALADOR:\r\n\u003e **IMPORTANTE:** Antes de criar o novo instalador, certifique-se de excluir o arquivo `./APP/CMD AUTONOMO.exe`.\r\n\r\n1. **Editar o arquivo do instalador:**\r\n   * No diretório `./CODIGO`, abra o arquivo `INSTALADOR.iss` e atualize o seguinte trecho:\r\n\r\n   * Localize a diretiva `#define Diretorio` e substitua pelo caminho correto do diretório do projeto. Exemplo:\r\n\r\n     ```ini\r\n     #define Diretorio \"C:\\Users\\HP\\Downloads\\GITHUB\\REPOSITORIO\\02-PROJETOS PUBLICOS\\02-APLICATIVOS\\CMD AUTONOMO\\CODIGO\"\r\n     ```\r\n\r\n2. **Gerar o instalador no Inno Setup:**\r\n   * Abra o arquivo `./CODIGO/INSTALADOR.iss` com o **Inno Setup**.\r\n   * Clique em **\"Compile\"** para gerar o instalador.\r\n\r\n3. **Limpar arquivos temporários:**\r\n   * Após a criação do instalador, você pode excluir o executável temporário `./CODIGO/dist/CMD AUTONOMO.exe`.\r\n\r\n4. **Instalando o Aplicativo:**\r\n   * Se o `Aplicativo` não iniciar automaticamente a instalação, você pode executar manualmente o arquivo `./APP/CMD AUTONOMO.exe` clicando duas vezes sobre ele.\r\n   * O assistente de instalação será iniciado e, por padrão, o aplicativo será instalado no seguinte caminho: `C:\\Program Files\\CMD AUTONOMO`.\r\n\r\n## NÃO SABE?\r\n- Entendemos que para manipular arquivos em muitas linguagens e tecnologias, é necessário possuir conhecimento nessas áreas. Para auxiliar nesse aprendizado, oferecemos cursos gratuitos e alguns subsídios:\r\n* [CURSO DE PYTHON](https://github.com/VILHALVA/CURSO-DE-PYTHON)\r\n* [CURSO DE CUSTOMTKINTER](https://github.com/VILHALVA/CURSO-DE-CUSTOMTKINTER)\r\n* [CONFIRA MAIS CURSOS](https://github.com/VILHALVA?tab=repositories\u0026q=+topic:CURSO)\r\n* [DOCUMENTAÇÃO OFICIAL DO PYINSTALLER](https://pyinstaller.org/en/stable/)\r\n* [DOCUMENTAÇÃO OFICIAL DO INNO SETUP](http://www.jrsoftware.org/isinfo.php)\r\n\r\n## CREDITOS E MAIS:\r\n- [PROJETO CRIADO PELO VILHALVA](https://github.com/VILHALVA)\r\n- [CLIQUE AQUI PARA VER O HISTÓRICO DE ATUALIZAÇÕES](./UPDATES.md)\r\n\r\n\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvilhalva%2Fcmd-autonomo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvilhalva%2Fcmd-autonomo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvilhalva%2Fcmd-autonomo/lists"}