Режим Bad KB на Flipper Zero чаще всего «не работает» не из-за поломки устройства, а из-за того, что компьютер не распознал Flipper как клавиатуру — типичный симптом: скрипт запускается, на экране идёт отсчёт, но ни одного символа на целевой машине не появляется. Эта ситуация почти всегда решается проверкой кабеля, режима подключения и самого скрипта, без разборки и перепрошивки.
Bad KB — это приложение, которое заставляет Flipper Zero эмулировать USB- или Bluetooth-клавиатуру и «печатать» заранее подготовленный сценарий на языке DuckyScript. Сбой может происходить на любом из трёх этапов: установка соединения, разбор скрипта, собственно ввод символов. Ниже разберём каждый этап отдельно, с проверками, которые безопасны и не требуют специальных навыков.
Как работает Bad KB и где обычно ломается цепочка
Приложение Bad KB доступно в меню Flipper Zero и поддерживает два канала: USB (устройство определяется как HID-клавиатура) и Bluetooth (сопряжение как беспроводная клавиатура). Файл сценария — обычный текстовый файл с расширением .txt, который нужно заранее положить на SD-карту в соответствующую папку, например через приложение qFlipper или мобильное приложение.
Логика диагностики проста: сначала убедитесь, что компьютер вообще «видит» Flipper как клавиатуру, затем — что скрипт корректно читается, и только потом ищите проблемы в самих командах. Пропуск этого порядка — главная причина, почему пользователи часами правят рабочий скрипт, хотя виноват кабель «только для зарядки» без линий данных.
Сначала проверяйте физическое подключение и распознавание HID-устройства, потом — синтаксис скрипта. 80% проблем Bad KB лежат в первом пункте.
Проверка кабеля и USB-подключения
Самая частая причина «мёртвого» Bad KB — кабель USB-C, в котором есть только жилы питания. Такие кабели часто идут в комплекте с дешёвыми аксессуарами. Flipper при этом заряжается, что создаёт ложное ощущение исправности, но данные не передаются, и компьютер не видит клавиатуру.
Вам нужно сделать простую проверку: подключите Flipper тем же кабелем к компьютеру и откройте qFlipper. Если программа не видит устройство — кабель или порт однозначно под подозрением. Попробуйте другой кабель, заведомо поддерживающий передачу данных, и другой USB-порт, желательно напрямую, без хабов и переходников.
- 🔌 Используйте кабель USB-C с поддержкой данных, а не «зарядочный»
- 🖥️ Подключайтесь напрямую к порту компьютера, минуя USB-хабы и док-станции
- 🔄 Проверьте другой порт: на некоторых машинах передние порты работают нестабильно
- 🧪 Убедитесь через qFlipper, что соединение по данным вообще устанавливается
⚠️ Внимание: на некоторых компьютерах групповые политики или защитное ПО блокируют новые HID-устройства. Если Bad KB работает на одном ПК, но молчит на другом при том же кабеле — проверьте, не режет ли антивирус или корпоративная политика подключение «новых клавиатур».
Проверка Bluetooth-режима
В режиме Bluetooth Flipper должен быть сопряжён с целевым устройством как клавиатура до запуска скрипта. Если сопряжение было выполнено давно или с другим хостом, ввод может уходить «в никуда» либо не начинаться вовсе.
Необходимо удалить старое сопряжение на целевом устройстве и выполнить его заново именно для режима Bad KB. Обратите внимание: сопряжение Flipper для мобильного приложения и сопряжение как HID-клавиатура — это разные подключения, одно не заменяет другое. Точные пункты меню зависят от версии прошивки, поэтому сверяйтесь с документацией к вашей версии.
Ошибки в скрипте DuckyScript
Второй по частоте источник проблем — сам файл сценария. Bad KB ожидает текст в синтаксисе DuckyScript, и даже одна неподдерживаемая команда или неверный символ могут остановить выполнение или дать непредсказуемый ввод.
Типичный минимальный скрипт выглядит так:
REM Тестовый скрипт
DELAY 1000
STRING Hello from Flipper
ENTER
Если даже такой простой сценарий не печатается, проблема точно не в логике скрипта, а в подключении. Если простой работает, а ваш «боевой» — нет, ищите различия: нестандартные команды, отсутствие задержек, символы национальных раскладок.
- ⏱️ Ставьте
DELAYв начале скрипта — системе нужно время, чтобы определить «клавиатуру» - ⌨️ Проверяйте каждую команду по справочнику DuckyScript — не все диалекты поддерживаются одинаково
- 📄 Файл должен быть в кодировке без «экзотики»; сохраняйте его как обычный UTF-8 текст
- 🚫 Уберите для теста всё, кроме пары строк
STRING— так локализуется сбойная команда
☑️ Быстрая проверка Bad KB перед запуском
Раскладка клавиатуры и «кракозябры»
Отдельный класс жалоб: Bad KB печатает, но вместо ожидаемого текста появляются неправильные символы. Причина почти всегда в несовпадении раскладки. Flipper «нажимает» клавиши по скан-кодам, а какой символ получится — решает раскладка, активная на целевом компьютере.
Переключите раскладку на целевой машине на английскую (US) перед запуском скрипта, если сценарий написан под неё. В некоторых прошивках предусмотрен выбор раскладки в настройках Bad KB — если ваша версия это поддерживает, укажите нужную там. Кириллические строки в скрипте при английской раскладке на хосте дадут бессмысленный набор символов — это не сбой, а ожидаемое поведение HID-эмуляции.
Пишите тестовые строки латиницей и цифрами: они одинаково печатаются в большинстве раскладок и позволяют отделить проблему раскладки от проблемы подключения.
Прошивка и версия приложения
Поведение Bad KB заметно различается между официальной прошивкой и популярными кастомными сборками: состав команд, настройки раскладки, стабильность Bluetooth. Инструкция, написанная под одну прошивку, может не работать на другой буквально в деталях меню.
Если ничего из базовых проверок не помогло, посмотрите версию прошивки в настройках устройства и сверьте описание проблемы с документацией именно вашей версии. Обновление прошивки — разумный шаг, но выполняйте его через официальные инструменты (qFlipper или мобильное приложение) и только после сохранения своих файлов.
⚠️ Внимание: использование Bad KB допустимо только на собственных устройствах и в рамках авторизованного тестирования. Автоматизированный ввод команд на чужом компьютере без согласия владельца может нарушать законодательство вашей страны.
Сводная таблица симптомов и причин
| Симптом | Вероятная причина | Что проверить |
|---|---|---|
| Скрипт идёт, но ничего не печатается | Нет HID-подключения | Кабель с данными, прямой порт, qFlipper |
| Печатаются неверные символы | Несовпадение раскладки | Раскладка US на хосте, настройки Bad KB |
| Скрипт обрывается на середине | Ошибка в команде скрипта | Синтаксис DuckyScript, тест по частям |
| Первые символы теряются | Нет стартовой задержки | Добавить DELAY в начало файла |
| По Bluetooth тишина | Нет HID-сопряжения | Удалить и повторить сопряжение как клавиатуру |
Почему скрипт «съедает» первые символы
Операционной системе нужно время, чтобы определить новое HID-устройство и назначить ему драйвер. Если ввод начинается мгновенно, первые нажатия уходят до готовности системы. Стартовый DELAY решает это; при медленных машинах задержку увеличивают.
Когда стоит искать помощь глубже
Если Flipper не определяется как HID-устройство ни на одном компьютере и ни с одним кабелем, при этом qFlipper тоже его не видит, возможна аппаратная проблема с портом USB-C устройства. Осмотрите разъём на предмет загрязнения и механических повреждений, аккуратно почистите его при необходимости.
Дальше — только официальные каналы поддержки и сообщество проекта. Не стоит разбирать устройство или перепаивать разъём самостоятельно без опыта: это почти гарантированно лишит вас гарантии и может усугубить неисправность.
Диагностика Bad KB строится по цепочке: кабель → HID-распознавание → сопряжение → синтаксис скрипта → раскладка → прошивка. Переходите к следующему звену только после проверки предыдущего.
Частые вопросы
Bad KB запускается, но компьютер не реагирует вообще. С чего начать?
С кабеля. Подключите Flipper к ПК и проверьте, видит ли его qFlipper. Если нет — меняйте кабель и порт. Если видит, но ввод не идёт, проверьте, не блокирует ли система или антивирус новые HID-устройства.
Почему вместо русского текста печатаются странные символы?
Flipper эмулирует нажатия клавиш, а итоговый символ зависит от раскладки целевой системы. Переключите раскладку на хосте в соответствии с той, под которую написан скрипт, или используйте настройку раскладки в Bad KB, если она есть в вашей прошивке.
Работает ли Bad KB с телефоном или планшетом?
По Bluetooth — да, если устройство поддерживает подключение внешней клавиатуры. По USB — зависит от поддержки USB-Host (OTG) на конкретном устройстве. Проверяйте на простом тестовом скрипте.
Скрипт выполняется слишком быстро и команды в системе не успевают срабатывать. Что делать?
Добавьте команды DELAY между «тяжёлыми» шагами — запуском программ, открытием окон. Скорость ввода Flipper не регулирует, паузы задаются явно в сценарии.
Нужно ли обновлять прошивку, если Bad KB глючит?
Только после того, как исключены кабель, сопряжение, скрипт и раскладка. Обновляйтесь официальными инструментами и сохраняйте свои файлы заранее — настройки и данные на SD-карте лучше подстраховать копией.