KeySpam

⬇️ Download KeySpam

KeySpam é um macro desenvolvido em Python que permite ao utilizador repetir automaticamente uma tecla ou uma ação do rato à velocidade definida.

A tecla predefinida é E, mas o utilizador pode alterar rapidamente a ação do macro através de atalhos de teclado. Também é possível ajustar o intervalo entre ações e guardar diferentes configurações através de presets.

Funcionalidades

• ⌨️ Tecla personalizável — por predefinição, o KeySpam utiliza a tecla E.
• 🖱️ Cliques do rato — permite utilizar o botão esquerdo ou direito do rato como ação do macro.
• 🔄 Alteração rápida da tecla ou do rato — pressione CTRL + ALT + [tecla] para definir uma nova tecla ou CTRL + ALT + clique para selecionar um botão do rato.
• ⏱️ Velocidade personalizável — permite aumentar ou diminuir o intervalo entre cada ação do macro.
• 🎮 Utilização em segundo plano — não é necessário minimizar o jogo ou aplicação para utilizar o macro.
• ⚡ Atalho de activação — pressione CTRL + ENTER para ligar ou desligar o macro enquanto utiliza outra aplicação.
• 💾 Presets — permite guardar configurações, atribuir-lhes um nome e carregá-las posteriormente.
• ✏️ Gestão de presets — permite carregar, editar e eliminar presets guardados.
• 🖥️ Interface renovada — interface gráfica moderna em modo escuro, com indicadores visuais do estado do macro.
• ❓ Aba de ajuda — acesso rápido à página do projecto e à informação de ajuda.

Como utilizar

Tecla predefinida

Ao iniciar o KeySpam, a ação configurada por predefinição é:

E

Alterar a tecla

Para alterar a tecla que será repetida:

CTRL + ALT + [tecla pretendida]

Por exemplo, para utilizar a tecla F:

CTRL + ALT + F

A partir desse momento, o KeySpam passará a utilizar a tecla F.

Utilizar o rato

O KeySpam também permite utilizar os botões do rato como ação do macro.

Para selecionar o botão esquerdo:

CTRL + ALT + Clique esquerdo

Para selecionar o botão direito:

CTRL + ALT + Clique direito

Na interface, estas ações são apresentadas como M1 e M2.

Alterar a velocidade

O intervalo entre as ações pode ser ajustado através da roda do rato.

Para aumentar o intervalo:

CTRL + SHIFT + Roda ↑

Para diminuir o intervalo:

CTRL + SHIFT + Roda ↓

Quanto menor for o intervalo, mais rapidamente o macro repete a ação. O intervalo mínimo configurado é de 0.1s.

Iniciar ou parar o macro

Não é necessário minimizar o jogo ou a aplicação.

Basta pressionar:

CTRL + ENTER

O macro será ligado ou desligado utilizando a ação actualmente configurada.

O estado do macro é apresentado visualmente na interface.

Presets

O KeySpam permite guardar configurações para utilização posterior.

Cada preset guarda:

• Nome personalizado
• Tecla ou botão do rato configurado
• Intervalo do macro

Através do menu Presets, é possível:

• ▶️ Carregar um preset
• ✎ Editar o nome de um preset
• ❌ Eliminar um preset

Os presets são guardados localmente no computador e podem ser reutilizados sempre que a aplicação for iniciada.

Ajuda

A aplicação inclui uma aba de ajuda acessível através do menu principal.

A partir daí é possível aceder rapidamente à página do projecto no GitHub e obter informação adicional sobre o KeySpam.

Compatibilidade e testes

O KeySpam foi desenvolvido para Windows e foi testado em diferentes ambientes, incluindo:

• Grand Theft Auto V
• FiveM

O funcionamento pode variar dependendo do jogo ou aplicação utilizada, bem como das respectivas configurações e sistemas de entrada.

Nota: alguns jogos, servidores ou aplicações podem restringir ou não permitir a utilização de macros e ferramentas de automatização. Verifique sempre as regras aplicáveis antes de utilizar o KeySpam.

Requisitos

• Windows
• Python 3.x
• Dependências listadas em requirements.txt

Instalação

Clone o repositório:

git clone https://github.com/fsafaradias/KeySpam.git

Entre na pasta do projecto:

cd KeySpam

Instale as dependências:

pip install -r requirements.txt

Execute o programa:

python main.py

Executável

O projecto pode ser compilado para um executável utilizando o PyInstaller.

python -m PyInstaller --clean --noconfirm --onefile --windowed --name KeySpam --icon "assets\icon.ico" --add-data "assets;assets" --add-data "font;font" main.py

O executável será gerado na pasta:

dist/

Também é possível utilizar o ficheiro .spec gerado pelo PyInstaller.

Tecnologias utilizadas

• Python
• Tkinter
• Pillow
• Keyboard
• Pynput
• PyDirectInput
• PyInstaller

Autor

Francisco Safara Dias

GitHub

---

⭐ Se este projecto te for útil, considera deixar uma estrela no repositório!