TapDucky - Iniettore di sequenze di tasti HID USB per Android

Eseguire script DuckyScript open-source per Android rooted con supporto USB Gadget (ConfigFS)
TapDucky ti permette di creare, personalizzare, programmare ed eseguire DuckyScript su Android emulando una tastiera USB, un mouse o un dispositivo HID composito per test autorizzati e automazione. Include parametrizzazione dei payload, molteplici trigger dello scheduler, log di esecuzione e una libreria di payload basata su GitHub con validazione automatica DuckyScript e conversione opzionale Digispark .ino.

Panoramica

• Profili gadget USB HID (nessun dongle USB esterno richiesto su dispositivi supportati/rooted):
  • Profili Tastiera, Mouse e Composito con VID/PID configurabili, stringhe produttore/prodotto e consumo energetico.
• Pipeline DuckyScript:
  • Validazione in tempo reale con problemi/avvisi leggibili, parametri segnaposto, moltiplicatore di ritardo e jitter opzionale per tempistiche umane.
• Gestione dei payload:
  • Crea/modifica payload con nome/descrizione/tag/parametri, condivisione/esportazione rapida e modelli/guida integrati.
• Negozio di Payload GitHub:
  • Aggiungi sorgenti, sfoglia repository, visualizza file con validazione, importa script supportati; rileva automaticamente DuckyScript e converte sketch Digispark .ino quando possibile.
• Scheduler:
  • Una tantum a data/ora, all'avvio a freddo dell'app, quando l'app è in primo piano o quando la sessione HID è armata (device_connected), con finestra temporale giornaliera opzionale.
• Esecuzione e Log:
  • Visualizzazione esecuzione a schede, richieste parametri, esecuzione/annullamento, cronologia esecuzioni e log strutturati con esportazione/cancellazione e filtro per livello.
• Diagnostica del dispositivo:
  • Istantanea del dispositivo, stato del kernel/gadget, informazioni UDC, layout tastiera; copia negli appunti; nota di rilevamento emulatore.

Nota: è richiesto un dispositivo rooted con supporto gadget USB Linux (ConfigFS). Utilizzare un dispositivo fisico poiché gli emulatori non possono validare il comportamento HID.

Funzionalità

• Editor Payload e Parametri

  • Crea payload con nome/descrizione/tag.
  • Aggiungi parametri tipizzati con valori predefiniti, flag obbligatori e override per esecuzione.
  • Validatore DuckyScript integrato con mappatura righe/problemi e conteggio comandi.
  • Condividi un singolo payload o esporta un pacchetto.

• Negozio Payload GitHub

  • Gestisci più sorgenti GitHub (utente/repo/branch/percorso).
  • Sfoglia directory e visualizza file con rilevamento del formato (DuckyScript, TapDucky JSON, script Digispark (.ino) convertito).
  • Importa script validati direttamente nella tua libreria; le validazioni fallite mostrano anteprime motivate.

• Esecuzione e Test

  • Valida prima dell'esecuzione; chiedi valori dei parametri; esegui o annulla con ID di esecuzione.
  • Test HID rapidi: pressione tasto tastiera, movimento mouse e Ctrl+Alt+Canc.
  • Stima del tempo di esecuzione basata sul motore (corrisponde al modello di temporizzazione reale).
  • Controllo wakelock per mantenere le sessioni attive durante l'esecuzione.

• Scheduler e Trigger

  • Trigger: one_time, app_cold_start, app_foreground, device_connected (sessione armata).
  • Finestra temporale giornaliera opzionale (HH:MM → HH:MM), inclusa la gestione del passaggio a mezzanotte.
  • Abilita/disabilita, modifica ed elimina pianificazioni; ultima esecuzione tracciata.
  • Collegamenti rapidi tramite codici segreti (armatura automatica + esecuzione in background).
    • Codici supportati: ##38250##, ##38251##, ##38252##, ##38253##
    • Tasti di associazione per codice: abilitato, modalità (ultimo eseguito | payload selezionato), payload (quando modalità = payload selezionato)

• Profili Dispositivo e HID

  • Attiva profili Tastiera, Mouse o Composito con ID/stringhe/potenza configurabili.
  • Selezione layout tastiera e risoluzione codice/ID.
  • Flusso di stato mostra ATTIVO/INATTIVO, prontezza scrittore e richieste di configurazione host.

• Log e Cronologia

  • Scheda log con filtro per livello (tutti/info/debug/avviso/errore), esportazione per condividere, cancella tutto.
  • Dettagli cronologia esecuzione con metadati e condivisione.

Aspetto utente

• Dashboard con schede di stato rapide, statistiche payload/libreria e riepilogo scheduler.
• Stati vuoti chiari e guide passo-passo per la configurazione/importazione iniziale.
• Tema Material 3, schemi colore dinamici chiaro/scuro.

Tecnico/architetturale

• Canali piattaforma (Android):
  • Canale metodo: org.kaijinlab.tap_ducky/gadget
    • checkRoot, checkSupport, listUdcs, getStatus, getDiagnostics
    • getKeyboardLayouts, setKeyboardLayout, resolveKeyboardLayoutId, setKeyboardLayoutByCode
    • activateProfile, deactivate, panicStop, retryOpenHidWriters
    • executeDuckyScript(script, delayMultiplier, executionId?), cancelExecution(executionId)
    • Helper di test: testKeyboardKey(label), testMouseMove(dx,dy,wheel,buttons), testCtrlAltDel()
  • Canali evento:
    • org.kaijinlab.tap_ducky/gadget_logs
    • org.kaijinlab.tap_ducky/gadget_status
    • org.kaijinlab.tap_ducky/gadget_exec
• Modello profili HID: tastiera/mouse/composito con VID/PID, stringhe, seriale, potenza.
• DuckyScript:
  • Parsing in passi; supporta comandi DELAY/STRING/tasti/raw; risoluzione segnaposto; ritardo base tasto; jitter.
  • Validatore restituisce problemi con gravità e mappatura righe; utilizzato nei flussi editor/negozio/esecuzione.
  • TRY/CATCH/END_TRY, WAIT_FOR, SLEEP_UNTIL, argomenti FUNCTION e variabili con scope.
  • Modalità fallback Unicode (warn+skip / skip / traslitterazione ASCII).
  • Codici di errore di esecuzione strutturati nel flusso di esecuzione.
• Motore di scheduling:
  • Trigger (avvio a freddo, primo piano, armato, una tantum), regole finestra temporale giornaliera, persistenza in SharedPreferences.
• Gestione stato: Riverpod 3, navigazione go_router, separazione pulita repository/servizi/controller.

Motore DuckyScript / Tastiera