TapDucky — Инжектор нажатий клавиш USB HID для Android

Средство выполнения DuckyScript с открытым исходным кодом для рутованных устройств Android с поддержкой USB Gadget (ConfigFS)
TapDucky позволяет создавать, настраивать, планировать и выполнять DuckyScript на Android путём эмуляции USB-клавиатуры, мыши или составного HID-устройства для разрешённого тестирования и автоматизации. Включает параметризацию полезных нагрузок, несколько триггеров планировщика, журналы выполнения и библиотеку полезных нагрузок на базе GitHub с автоматической проверкой DuckyScript и опциональным преобразованием Digispark .ino.

Обзор

• Профили USB HID-гаджетов (не требуется внешний USB-донгл на поддерживаемых/рутованных устройствах):
  • Профили клавиатуры, мыши и составные профили с настраиваемыми VID/PID, строками производителя/продукта и потребляемой мощностью.
• Конвейер DuckyScript:
  • Живая проверка с читаемыми проблемами/предупреждениями, параметрами-заполнителями, множителем задержки и опциональным джиттером для имитации человеческой скорости ввода.
• Управление полезными нагрузками:
  • Создание/редактирование полезных нагрузок с именем/описанием/тегами/параметрами, быстрый обмен/экспорт и встроенные шаблоны/мастер.
• Магазин полезных нагрузок GitHub:
  • Добавление источников, просмотр репозиториев, предпросмотр файлов с проверкой, импорт поддерживаемых скриптов; автоматическое обнаружение DuckyScript и преобразование скетчей Digispark .ino по возможности.
• Планировщик:
  • Одноразовый по дате/времени, при холодном старте приложения, при переходе в передний план или при вооружении HID-сессии (device_connected), с опциональным ежедневным временным окном.
• Выполнение и журналы:
  • Вкладка выполнения, запрос параметров, запуск/отмена, история выполнения и структурированные журналы с экспортом/очисткой и фильтром по уровню.
• Диагностика устройства:
  • Снимок состояния устройства, ядра/гаджета, информация UDC, раскладки клавиатуры; копирование в буфер обмена; примечание об обнаружении эмулятора.

Примечание: Требуется рутованное устройство с поддержкой Linux USB gadget (ConfigFS). Используйте физическое устройство, так как эмуляторы не могут проверить поведение HID.

Возможности

• Редактор полезных нагрузок и параметры

  • Создание полезных нагрузок с именем/описанием/тегами.
  • Добавление типизированных параметров со значениями по умолчанию, обязательными флагами и переопределениями для каждого выполнения.
  • Встроенный валидатор DuckyScript с сопоставлением строк/проблем и подсчётом команд.
  • Поделиться одной полезной нагрузкой или экспортировать набор.

• Магазин полезных нагрузок GitHub

  • Управление несколькими источниками GitHub (пользователь/репозиторий/ветка/путь).
  • Просмотр каталогов и предпросмотр файлов с определением формата (DuckyScript, TapDucky JSON, преобразованный скрипт Digispark (.ino)).
  • Импорт проверенных скриптов напрямую в вашу библиотеку; неудачные проверки показывают аргументированные предпросмотры.

• Выполнение и тестирование

  • Проверка перед запуском; запрос значений параметров; запуск или отмена с идентификаторами выполнения.
  • Быстрые HID-тесты: нажатие клавиш клавиатуры, движение мыши и Ctrl+Alt+Del.
  • Оценка времени выполнения на основе движка (соответствует реальной модели синхронизации).
  • Управление wakelock для поддержания активности сеансов во время выполнения.

• Планировщик и триггеры

  • Триггеры: one_time, app_cold_start, app_foreground, device_connected (сессия вооружена).
  • Опциональное ежедневное временное окно (ЧЧ:ММ → ЧЧ:ММ), включая переход через полночь.
  • Включение/отключение, редактирование и удаление расписаний; отслеживается последний запуск.
  • Привязки быстрого набора через секретные коды (авто-вооружение + фоновое выполнение).
    • Поддерживаемые коды: ##38250##, ##38251##, ##38252##, ##38253##
    • Ключи привязки для каждого кода: enabled, mode (last executed | selected payload), payload (when mode = selected payload)

• Устройство и HID-профили

  • Активация профилей клавиатуры, мыши или составного профиля с настраиваемыми ID/строками/питанием.
  • Выбор раскладки клавиатуры и разрешение кода/ID.
  • Поток состояния показывает ACTIVE/IDLE, готовность писателя и запросы конфигурации хоста.

• Журналы и история

  • Вкладка журналов с фильтром по уровню (all/info/debug/warn/error), экспорт для отправки, очистка всех.
  • Детали истории выполнения с метаданными и отправка.

Для пользователя

• Панель управления с карточками быстрого статуса, статистикой полезных нагрузок/библиотеки и сводкой планировщика.
• Чёткие пустые состояния и пошаговые мастера для первоначальной настройки/импорта.
• Тема Material 3, динамические светлые/тёмные цветовые схемы.