TapDucky - Injetor de Teclas HID USB para Android

Executor de DuckyScript de código aberto para Android rooteado com suporte a USB Gadget (ConfigFS)
TapDucky permite criar, personalizar, agendar e executar DuckyScript no Android emulando um teclado USB, mouse ou dispositivo HID composto para testes autorizados e automação. Inclui parametrização de payload, múltiplos gatilhos de agendamento, logs de execução e uma biblioteca de payloads baseada no GitHub com validação automática de DuckyScript e conversão opcional para Digispark .ino.

Visão Geral

• Perfis de dispositivo HID USB (sem necessidade de dongle USB externo em dispositivos com suporte/rooteados):
  • Perfis de Teclado, Mouse e Composto com VID/PID configuráveis, strings de fabricante/produto e consumo de energia.
• Pipeline DuckyScript:
  • Validação ao vivo com problemas/avisos legíveis por humanos, parâmetros de espaço reservado, multiplicador de atraso e jitter opcional para temporização mais natural.
• Gerenciamento de payloads:
  • Criar/editar payloads com nome/descrição/tags/parâmetros, compartilhamento/exportação rápida e modelos/assistente integrados.
• Loja de Payloads GitHub:
  • Adicionar fontes, navegar repositórios, visualizar arquivos com validação, importar scripts suportados; detecta automaticamente DuckyScript e converte sketches Digispark .ino quando possível.
• Agendador:
  • Única vez em data/hora, ao iniciar o app (cold start), ao abrir o app (foreground) ou quando a sessão HID é armada (device_connected), com janela de horário diária opcional.
• Execução e Logs:
  • Visualização de execução em abas, prompts de parâmetros, executar/cancelar, histórico de execução e logs estruturados com exportar/limpar e filtro por nível.
• Diagnóstico do dispositivo:
  • Instantâneo do dispositivo, status do kernel/gadget, informações de UDC, layouts de teclado; copiar para área de transferência; nota de detecção de emulador.

Nota: É necessário um dispositivo rooteado com suporte a Linux USB gadget (ConfigFS). Use um dispositivo físico, pois emuladores não podem validar o comportamento HID.

Recursos

• Editor de Payloads e Parâmetros

  • Criar payloads com nome/descrição/tags.
  • Adicionar parâmetros tipados com valores padrão, flags obrigatórias e substituições por execução.
  • Validador DuckyScript integrado com mapeamento linha/problema e contagem de comandos.
  • Compartilhar um único payload ou exportar um pacote.

• Loja de Payloads GitHub

  • Gerenciar múltiplas fontes GitHub (usuário/repo/branch/caminho).
  • Navegar por diretórios e visualizar arquivos com detecção de formato (DuckyScript, TapDucky JSON, script Digispark (.ino) convertido).
  • Importar scripts validados diretamente para sua biblioteca; validações falhas mostram visualizações com justificativa.

• Executar e Testar

  • Validar antes de executar; solicitar valores de parâmetros; executar ou cancelar com IDs de execução.
  • Testes HID rápidos: pressionamento de tecla, movimento do mouse e Ctrl+Alt+Del.
  • Estimativa de tempo de execução baseada no motor (corresponde ao modelo de temporização real).
  • Controle de wakelock para manter sessões ativas durante a execução.

• Agendador e Gatilhos

  • Gatilhos: one_time (única vez), app_cold_start (início do app), app_foreground (app em primeiro plano), device_connected (sessão armada).
  • Janela de horário diária opcional (HH:MM → HH:MM), incluindo atravessar meia-noite.
  • Ativar/desativar, editar e excluir agendamentos; última execução registrada.
  • Atalhos de discagem via códigos secretos (armar automaticamente + execução em segundo plano).
    • Códigos suportados: ##38250##, ##38251##, ##38252##, ##38253##
    • Chaves de vinculação por código: ativado, modo (último executado | payload selecionado), payload (quando modo = payload selecionado)

• Perfis de Dispositivo e HID

  • Ativar perfis de Teclado, Mouse ou Composto com IDs/strings/potência configuráveis.
  • Seleção de layout de teclado e resolução de código/ID.
  • Fluxo de status mostra ATIVO/OCIOSO, prontidão do escritor e solicitações de configuração do host.

• Logs e Histórico

  • Aba de logs com filtro por nível (todos/info/debug/warn/error), exportar para compartilhar, limpar todos.
  • Detalhes do histórico de execução com metadados e compartilhamento.

Para o usuário

• Painel com cartões de status rápidos, estatísticas de payload/biblioteca e resumo do agendador.
• Estados vazios claros e assistentes passo a passo para configuração/importação inicial.
• Tematização Material 3, esquemas de cores dinâmicos claro/escuro.