Gerenciador de ações manuais para Windows com perfis por aplicativo, sequências de teclado e mouse, repetição controlada, cooldowns e HUD transparente.
Baixar a versão mais recente · Relatar um problema
Interface principal do KeyFlow Assistant.
O KeyFlow Assistant permite transformar um acionamento manual em uma sequência organizada de entradas de teclado e mouse. As ações podem ser separadas por perfil, conjunto e aplicativo-alvo, facilitando a manutenção de configurações diferentes para jogos, programas e rotinas de acessibilidade.
O aplicativo foi desenvolvido com foco em:
- configuração visual, sem edição manual de arquivos;
- execução previsível e fácil de interromper;
- HUD discreto e reposicionável;
- armazenamento local das configurações;
- reutilização dos mesmos atalhos em aplicativos diferentes;
- proteção contra entradas presas e execuções fora de contexto.
Important
O KeyFlow Assistant não lê memória, pixels, vida, inventário, inimigos ou qualquer estado interno do aplicativo-alvo. Ele não injeta código em outros processos e não procura contornar mecanismos de proteção. Todas as ações são configuradas e iniciadas pelo usuário.
- Principais recursos
- Requisitos
- Download e instalação
- Primeiros passos
- Repetição da sequência
- Cooldowns, grupos e cargas
- Overlay e menu radial
- Dados, backup e privacidade
- Solução de problemas
- Limites operacionais
- Uso responsável
- Relatar problemas
- Distribuição e direitos autorais
- Perfis associados ao executável de cada jogo ou programa.
- Detecção do aplicativo em primeiro plano.
- Uso do mesmo atalho em perfis diferentes.
- Conjuntos independentes dentro de um perfil.
- Organização por classes, personagens, builds ou contextos de trabalho.
- Atalhos próprios para alternar conjuntos sem abrir a janela principal.
O KeyFlow Assistant reconhece:
- teclado e combinações com modificadores;
- Mouse 4 e Mouse 5;
- roda do mouse para cima e para baixo;
- controles compatíveis com XInput, em caráter experimental;
- botões A, B, X, Y, LB, RB, LT, RT, direcional, Start, Back, L3 e R3.
Modos disponíveis:
| Modo | Comportamento |
|---|---|
| Ao pressionar | Executa quando o botão é pressionado. |
| Ao soltar | Executa quando o botão é liberado. |
| Duplo toque | Exige dois acionamentos dentro do intervalo configurado. |
| Pressionamento longo | Executa após manter o botão pressionado pelo tempo definido. |
| Enquanto segura | Repete somente enquanto o botão físico permanecer pressionado. |
Cada ação pode combinar etapas de:
- pressionar uma tecla;
- aguardar um intervalo;
- clicar ou segurar botões do mouse;
- usar Mouse 4 ou Mouse 5;
- rolar a roda do mouse;
- executar outra ação como subação reutilizável;
- reproduzir um aviso sonoro.
O editor também oferece:
- captura visual de teclas e botões;
- reordenação e duplicação de etapas;
- gravador de sequência finita;
- variáveis de tecla e tempo por perfil;
- estimativa da duração de cada ciclo;
- diagnóstico de entradas, bloqueios e execuções.
- Quantidade configurável entre
1e9.999ciclos. - Valor
-1para repetição contínua. - Intervalo configurável entre os ciclos.
- Interrupção ao pressionar novamente o mesmo atalho.
- Botão Parar execução na interface.
- Parada automática opcional ao perder o foco do aplicativo-alvo.
- Progresso exibido no editor e no overlay.
- Cooldown individual por ação.
- Início do cooldown ao começar ou ao finalizar a execução completa.
- Grupos de cooldown compartilhado.
- Até dez cargas por ação.
- Recarga individual de cada carga.
- Reset e reinício manual do contador.
- Valores fixos ou vinculados a variáveis do perfil.
- HUD sempre acima do aplicativo-alvo.
- Fundo da janela transparente.
- Modos Minimalista, Micro HUD e Barra horizontal.
- Exibição de tecla, nome, estado, repetição, cargas e cooldown.
- Opacidade e escala configuráveis.
- Opção para mostrar somente ações em atividade.
- Ocultação automática fora do perfil associado.
- Passagem de cliques para não interferir no aplicativo.
- Reposicionamento livre, com posição salva automaticamente.
- Até oito ações por conjunto.
- Acionamento por teclado ou mouse.
- Seleção pela direção do cursor.
- Zona central para cancelar.
- Janela transparente, sem captura permanente do foco.
- Busca por nome, descrição ou tecla.
- Fila opcional quando outra ação já está em execução.
- Minimização para a bandeja do Windows.
- Inicialização automática opcional.
- Pausa global do motor.
- Parada de emergência em
Ctrl + Shift + F12. - Importação e exportação de perfis.
- Backup completo das configurações.
- Migração automática de versões anteriores.
| Requisito | Observação |
|---|---|
| Sistema operacional | Windows 10 ou Windows 11, 64 bits. |
| PowerShell | Normalmente já incluído no Windows. |
| Permissões | O Assistant e o aplicativo-alvo devem usar o mesmo nível de permissão. |
| Modo de exibição | Para o overlay, prefira modo janela ou janela sem bordas. |
| Controle | Opcional; deve ser compatível com XInput. |
A versão instalada não exige VS Code, Node.js, npm ou ferramentas de desenvolvimento.
- Abra a página de Releases.
- Entre na versão mais recente.
- Em Assets, baixe o instalador para Windows, com nome semelhante a:
Assistant-0.4.1-x64.exe
- Execute o instalador.
- Escolha a pasta de instalação.
- Abra o KeyFlow Assistant pelo menu Iniciar ou pelo atalho da área de trabalho.
Note
O GitHub adiciona automaticamente arquivos chamados Source code (zip) e Source code (tar.gz) em todas as Releases. Esses arquivos correspondem apenas ao conteúdo público deste repositório e não contêm o código-fonte do aplicativo. Para instalar o programa, baixe o arquivo .exe anexado em Assets.
Warning
O aplicativo pode ser distribuído sem assinatura digital. Nesse caso, o Windows SmartScreen ou algum antivírus pode solicitar confirmação. Baixe o instalador somente das Releases oficiais deste repositório.
Tip
Caso o jogo ou programa-alvo seja executado como administrador, abra o KeyFlow Assistant como administrador também. Um processo sem elevação normalmente não consegue enviar entradas para outro processo elevado.
- Selecione ou crie um perfil.
- Abra o jogo ou programa desejado.
- Clique em Detectar.
- Mude para a janela-alvo e aguarde a detecção.
- Confirme o nome do executável.
- Clique em Nova ação.
- Escolha o conjunto ao qual ela pertence.
- Defina o acionamento, como
F7,Ctrl + QouMouse 4. - Escolha o modo de acionamento.
- Adicione uma ou mais etapas.
- Ative a ação e salve.
Exemplo:
Acionamento: F7
1. Pressionar tecla 1 por 40 ms
2. Aguardar 150 ms
3. Pressionar tecla 2 por 40 ms
4. Aguardar 180 ms
5. Pressionar tecla 3 por 40 ms
Antes de usar em um jogo:
- abra o Bloco de Notas;
- desative temporariamente a exigência de primeiro plano ou associe um perfil ao Bloco de Notas;
- configure uma ação que envie uma tecla simples;
- confirme se a quantidade, os intervalos e a interrupção funcionam como esperado.
A repetição envolve a sequência completa da ação.
Quantidade: 10
Intervalo: 500 ms
A sequência será executada dez vezes. O intervalo é aplicado entre os ciclos, sem espera adicional após o último.
Quantidade: -1
Intervalo: 500 ms
A execução continua até uma destas condições:
- o mesmo atalho ser pressionado novamente;
- o botão Parar execução ser acionado;
- a parada de emergência ser utilizada;
- o motor ser pausado;
- o aplicativo-alvo perder o foco, quando essa proteção estiver ativada;
- o KeyFlow Assistant ser encerrado.
Warning
Use intervalos adequados. No modo contínuo, o intervalo mínimo efetivo é de 50 ms. O modo Enquanto segura possui repetição própria e não pode ser combinado com a repetição da sequência.
O cooldown do KeyFlow Assistant é um contador local. Ele não lê o cooldown real do jogo ou programa.
É possível escolher quando o contador começa:
- Ao iniciar: começa no primeiro ciclo.
- Ao finalizar: começa após a última repetição ou após uma interrupção já iniciada.
As cargas e os cooldowns são consumidos uma vez por acionamento da ação, não uma vez por ciclo.
Os grupos compartilhados permitem que várias ações utilizem o mesmo bloqueio. Um exemplo comum é um grupo de poções, no qual o uso de uma ação bloqueia temporariamente as demais.
- Abra Preferências.
- Clique em Reposicionar overlay.
- Arraste pela alça exibida no HUD.
- Clique em Concluir.
A posição é salva automaticamente. O mesmo comando também está disponível no menu da bandeja.
Ocultar fora do perfil: ativado
Mostrar somente ativos: ativado
Ignorar cliques: ativado
Opacidade: 0,80 a 0,90
Escala: 0,85 a 1,00
Caso o overlay não apareça sobre um jogo em tela cheia, use janela sem bordas ou modo janela.
Na versão atual:
- as configurações permanecem no computador do usuário;
- não é necessário criar conta;
- não há telemetria;
- não há sincronização online;
- o funcionamento normal não depende de internet após a instalação.
A pasta de dados pode ser aberta por:
Preferências → Abrir pasta de dados
No Windows, ela normalmente corresponde a:
%APPDATA%\Assistant\
O arquivo principal de configuração é:
assistant-config.json
Antes de atualizar, formatar o computador ou alterar configurações importantes, utilize Exportar backup ou Exportar perfil.
Verifique:
- se Ação ativa está habilitada;
- se o executável do perfil está configurado corretamente;
- se o conjunto correto está ativo;
- se a janela-alvo está em primeiro plano;
- se a ação está em cooldown ou sem cargas;
- se o motor está pausado;
- se outra ação está em execução;
- se o KeyFlow Assistant e o aplicativo-alvo usam o mesmo nível de permissão.
- Ative o overlay em Preferências.
- Confirme se a ação está marcada para aparecer no overlay.
- Desative temporariamente Mostrar somente ativos.
- Confirme se o perfil foi identificado.
- Teste com Ocultar fora do perfil desativado.
- Use modo janela ou janela sem bordas.
- Use Preferências → Reposicionar overlay.
- Arraste pela alça exibida durante o modo de posicionamento.
- Clique em Concluir para restaurar a passagem de cliques.
Feche o KeyFlow Assistant e abra-o usando Executar como administrador. O nível de permissão precisa ser igual ao do aplicativo-alvo.
Ferramentas que capturam atalhos globais e enviam entradas podem receber análise adicional de antivírus. Confirme que o instalador foi obtido das Releases oficiais.
Isso ocorre apenas nas versões usadas durante desenvolvimento ou testes internos. A versão instalada pela Release deve funcionar sem terminal aberto.
- Abra o diagnóstico e confirme se o motor está pronto.
- Utilize a opção de reparar ou recompilar o componente de entrada, quando disponível.
- Para controles, confirme que o dispositivo é reconhecido como XInput pelo Windows.
- O suporte a controles ainda é experimental.
| Item | Limite atual |
|---|---|
| Etapas configuradas por ação | 30 |
| Etapas após expansão de subações | 60 |
| Duração máxima de cada ciclo | 20 segundos |
| Repetições finitas | 1 a 9.999 |
| Intervalo mínimo no modo contínuo | 50 ms |
| Cargas por ação | 1 a 10 |
| Itens no menu radial | Até 8 |
| Variáveis por perfil | Até 40 |
| Tamanho máximo da fila | Até 10 ações |
A parada de emergência padrão é:
Ctrl + Shift + F12
Ela interrompe execuções, repetições, fila e temporizadores, além de liberar entradas mantidas pelo KeyFlow Assistant.
O KeyFlow Assistant foi projetado como uma ferramenta local de atalhos, acessibilidade e qualidade de vida.
O aplicativo não oferece:
- leitura de memória de outros processos;
- reconhecimento de tela ou análise de pixels;
- seleção automática de alvos;
- movimentação autônoma;
- coleta automática;
- injeção de código;
- ocultação do processo;
- evasão de sistemas de proteção ou anti-cheat.
Cada jogo, programa ou serviço possui regras próprias. Verifique os termos de uso do aplicativo-alvo antes de utilizar sequências de entrada, especialmente repetições contínuas.
O usuário é responsável pelas ações configuradas e pelo uso do aplicativo em conformidade com as regras do software-alvo.
Para relatar uma falha ou sugerir uma melhoria, abra uma Issue.
Ao relatar um problema, inclua, quando possível:
- versão do KeyFlow Assistant;
- versão do Windows;
- nome do aplicativo-alvo;
- modo de acionamento utilizado;
- passos para reproduzir;
- captura de tela sem informações pessoais;
- mensagem apresentada no diagnóstico.
Não publique arquivos de configuração que contenham informações pessoais ou caminhos privados sem revisá-los antes.
O KeyFlow Assistant é distribuído em formato compilado para usuários finais.
O código-fonte do aplicativo não é distribuído por este repositório. O acesso ao instalador não concede autorização para copiar, modificar, redistribuir, revender ou criar versões derivadas do aplicativo.
Copyright © 2026 Daniel. Todos os direitos reservados.
Para solicitações relacionadas a distribuição, parceria ou autorização de uso, utilize a área de Issues do repositório.
