TapDucky - Inyector de pulsaciones de teclado USB HID para Android
TapDucky - Inyector de pulsaciones de teclado USB HID para Android
Ejecutor de DuckyScript de código abierto para Android rooteado con soporte de USB Gadget (ConfigFS)
TapDucky te permite crear, personalizar, programar y ejecutar DuckyScript en Android emulando un teclado USB, un ratón o un dispositivo HID compuesto para pruebas autorizadas y automatización. Incluye parametrización de payloads, múltiples disparadores de programación, registros de ejecución y una biblioteca de payloads respaldada por GitHub con validación automática de DuckyScript y conversión opcional de .ino de Digispark.
Resumen
- Perfiles de gadget HID USB (no requiere dongle USB externo en dispositivos compatibles/rooteados):
- Perfiles de Teclado, Ratón y Compuesto con VID/PID configurables, cadenas de fabricante/producto y consumo de energía.
- Pipeline de DuckyScript:
- Validación en vivo con problemas/advertencias legibles, parámetros de marcador de posición, multiplicador de retardo y jitter opcional para un tiempo similar al humano.
- Gestión de payloads:
- Crear/editar payloads con nombre/descripción/etiquetas/parámetros, compartir/exportar rápido, y plantillas/asistente integrados.
- Tienda de payloads de GitHub:
- Agregar fuentes, navegar repositorios, previsualizar archivos con validación, importar scripts compatibles; detecta automáticamente DuckyScript y convierte bocetos
.ino de Digispark cuando sea posible.
- Programador:
- Única vez en fecha/hora, al inicio en frío de la app, al primer plano de la app, o cuando la sesión HID está armada (device_connected), con ventana de tiempo diaria opcional.
- Ejecución y Registros:
- Vista de ejecución con pestañas, indicaciones de parámetros, ejecutar/cancelar, historial de ejecución y registros estructurados con exportar/limpiar y filtro de nivel.
- Diagnósticos del dispositivo:
- Instantánea del dispositivo, estado del kernel/gadget, información UDC, diseños de teclado; copiar al portapapeles; nota de detección de emulador.
Nota: Se requiere un dispositivo rooteado con soporte de gadget USB de Linux (ConfigFS). Use un dispositivo físico, ya que los emuladores no pueden validar el comportamiento HID.
Características
-
Editor de Payloads y Parámetros
- Crear payloads con nombre/descripción/etiquetas.
- Agregar parámetros tipados con valores predeterminados, banderas obligatorias y anulaciones por ejecución.
- Validador de DuckyScript integrado con mapeo de línea/problema y conteo de comandos.
- Compartir un solo payload o exportar un paquete.
-
Tienda de Payloads de GitHub
- Gestionar múltiples fuentes de GitHub (usuario/repo/rama/ruta).
- Navegar directorios y previsualizar archivos con detección de formato (DuckyScript, TapDucky JSON, script de Digispark (.ino) convertido).
- Importar scripts validados directamente a tu biblioteca; las validaciones fallidas muestran vistas previas razonadas.
-
Ejecutar y Probar
- Validar antes de ejecutar; solicitar valores de parámetros; ejecutar o cancelar con IDs de ejecución.
- Pruebas HID rápidas: pulsación de tecla de teclado, movimiento del ratón y Ctrl+Alt+Del.
- Estimación de tiempo de ejecución basada en el motor (coincide con el modelo de temporización real).
- Control de wakelock para mantener las sesiones activas durante la ejecución.
-
Programador y Disparadores
- Disparadores: one_time, app_cold_start, app_foreground, device_connected (sesión armada).
- Ventana de tiempo diaria opcional (HH:MM → HH:MM), incluyendo envolvente a medianoche.
- Habilitar/deshabilitar, editar y eliminar horarios; último seguimiento de ejecución.
- Enlaces directos de marcación a través de códigos secretos (armado automático + ejecución en segundo plano).
- Códigos soportados:
*#*#38250#*#*, *#*#38251#*#*, *#*#38252#*#*, *#*#38253#*#*
- Claves de enlace por código: habilitado, modo (último ejecutado | payload seleccionado), payload (cuando modo = payload seleccionado)
-
Dispositivo y Perfiles HID
- Activar perfiles de Teclado, Ratón o Compuesto con IDs/cadenas/consumo de energía configurables.
- Selección de diseño de teclado y resolución de código/ID.
- Flujo de estado muestra ACTIVO/INACTIVO, preparación del escritor y solicitudes de configuración del host.
-
Registros e Historial
- Pestaña de registros con filtro de nivel (todos/info/debug/warn/error), exportar para compartir, limpiar todo.
- Detalles del historial de ejecución con metadatos y opción de compartir.
Orientado al usuario
- Panel con tarjetas de estado rápido, estadísticas de payload/biblioteca y resumen del programador.
- Estados vacíos claros y asistentes paso a paso para configuración/importaciones por primera vez.
- Tema Material 3, esquemas de color dinámicos claro/oscuro.