Скрипты для Flipper Zero: полное руководство по установке и запуску

Flipper Zero не выполнит ни один пользовательский сценарий, пока файл не окажется в правильной папке на microSD-карте — попытка запустить BadUSB-скрипт, скопированный в корень карты, закончится сообщением о том, что файл не найден. Это первая и самая частая причина, по которой «скрипты не работают»: устройство ищет их строго в определённых каталогах, и структура папок имеет значение.

В этой статье разберём, какие типы скриптов поддерживает Flipper Zero, куда их копировать, как запускать и какие ограничения стоит учитывать. Материал ориентирован на легальное использование: тестирование собственных устройств, автоматизацию рутинных действий и обучение.

Какие типы скриптов поддерживает Flipper Zero

Под «скриптами для Flipper Zero» обычно понимают несколько разных вещей, и их важно различать. Первый тип — BadUSB-скрипты: текстовые файлы с командами эмуляции клавиатуры, которые устройство «набирает» на компьютере при подключении по USB. Второй тип — сценарии на JavaScript, поддержка которых появилась в официальной прошивке и позволяет писать интерактивные программы с выводом на экран.

Отдельно стоят файлы данных, которые тоже часто называют скриптами: сохранённые сигналы Sub-GHz, инфракрасные коды, дампы NFC-карт и ключи iButton. Формально это не скрипты, а записанные данные, но логика работы с ними похожая — файл кладётся в нужную папку и воспроизводится через соответствующее приложение.

• 📄 BadUSB (.txt) — эмуляция клавиатуры и мыши при подключении к ПК;
• ⚙️ JavaScript (.js) — полноценные скрипты с логикой, меню и работой с GPIO;
• 📡 Sub-GHz (.sub) — записанные радиосигналы для воспроизведения;
• 🔦 Infrared (.ir) — библиотеки ИК-кодов для управления техникой;
• 💳 NFC (.nfc) — дампы и эмуляция поддерживаемых типов карт.

Структура папок на SD-карте

Каждое приложение прошивки читает файлы из собственного каталога. BadUSB-скрипты размещаются в папке badusb, JavaScript-файлы — в apps/Scripts, записи Sub-GHz — в subghz, инфракрасные базы — в infrared. Если положить файл не туда, приложение его просто не увидит, хотя через файловый менеджер он будет доступен.

Имена файлов лучше давать латиницей без пробелов — это снижает риск проблем с отображением и запуском. Вложенные подпапки внутри основных каталогов поддерживаются, поэтому большую коллекцию удобно раскладывать по темам: например, отдельно скрипты для Windows, отдельно — для macOS.

Установка скриптов: пошаговый порядок

Самый простой способ перенести файлы — приложение qFlipper для компьютера. Оно соединяется с устройством по USB и открывает доступ к файловой системе SD-карты без извлечения карты из слота. Альтернатива — вынуть карту и скопировать файлы через кардридер, что быстрее при больших объёмах.

Порядок действий через qFlipper выглядит так: подключите устройство кабелем, дождитесь определения в программе, откройте файловый менеджер и перетащите файлы в нужные каталоги. После копирования безопасно отключите устройство — прерывание передачи может повредить файловую систему карты.

Если после копирования файл не виден, проверьте три вещи: правильность папки, расширение файла и целостность карты. Возможная причина «невидимости» — скрытое двойное расширение вида script.txt.txt, которое создаётся при переименовании в некоторых файловых менеджерах.

BadUSB: синтаксис и запуск

BadUSB-скрипты пишутся на языке, совместимом с Ducky Script. Базовые команды интуитивны: STRING печатает текст, ENTER нажимает клавишу ввода, DELAY задаёт паузу в миллисекундах, GUI r открывает окно «Выполнить» в Windows. Задержки критичны — без них команды отправляются быстрее, чем система успевает реагировать, и скрипт «сыпется».

REM Пример: открыть блокнот и напечатать текст
DELAY 1000
GUI r
DELAY 500
STRING notepad
ENTER
DELAY 1000
STRING Hello from Flipper!

Запуск выполняется через приложение Bad USB на устройстве: выберите файл, подключите Flipper к целевому компьютеру и нажмите Run. Раскладка клавиатуры имеет значение — скрипт, написанный под английскую раскладку, на системе с другой раскладкой по умолчанию может вывести не те символы.

⚠️ Внимание: BadUSB-скрипт выполняет действия от имени пользователя компьютера без дополнительных подтверждений. Запускайте на своём ПК только те скрипты, содержимое которых вы полностью прочитали и поняли — внешне безобидный файл может содержать команды загрузки и выполнения вредоносного кода.

JavaScript-сценарии и GPIO

Поддержка JavaScript в официальной прошивке открывает более широкие возможности, чем BadUSB: скрипты могут выводить интерфейс на экран, реагировать на кнопки, работать с пинами GPIO и взаимодействовать с модулями устройства. Файлы размещаются в каталоге скриптов и запускаются через соответствующее приложение в меню.

Типичные сценарии использования — мигание внешним светодиодом, чтение датчиков, подключённых к GPIO, простые игры и утилиты. Для начинающих это удобная площадка: синтаксис знаком многим, а ошибка в скрипте не способна повредить прошивку — в худшем случае сценарий просто завершится с ошибкой.

Источники готовых скриптов и их проверка

Готовые коллекции BadUSB-скриптов и JavaScript-сценариев распространяются через репозитории на GitHub и тематические сообщества. Качество и безопасность таких сборников сильно различаются: рядом с полезными учебными примерами могут лежать файлы с деструктивными командами. Правило простое — никогда не запускайте скрипт, не прочитав его содержимое от первой до последней строки.

На что смотреть при проверке: команды скачивания файлов из сети, обфусцированные строки, вызовы PowerShell или терминала с непонятными аргументами. Если назначение хотя бы одной строки неясно, файл лучше отложить. Учебные скрипты обычно короткие и прозрачные — например, открытие сайта или вывод системной информации.

Тип файла	Папка на SD-карте	Приложение для запуска
BadUSB (.txt)	badusb	Bad USB
JavaScript (.js)	apps/Scripts	Scripts / JS Runner
Sub-GHz (.sub)	subghz	Sub-GHz
Infrared (.ir)	infrared	Infrared
NFC (.nfc)	nfc	NFC

Названия приложений и пути могут отличаться в зависимости от версии прошивки и установленных сторонних сборок — сверяйтесь с документацией именно вашей прошивки.

Чем отличаются сторонние прошивки для скриптов

Некоторые кастомные прошивки добавляют расширенный синтаксис BadUSB, дополнительные модули JavaScript и свои каталоги для файлов. Скрипты, написанные под конкретную прошивку, могут не работать на другой — проверяйте совместимость в описании сборника.

Типичные ошибки при работе со скриптами

Чаще всего пользователи сталкиваются с четырьмя проблемами. Первая — файл в неправильной папке, о чём уже говорилось. Вторая — отсутствие задержек в BadUSB-скриптах, из-за чего команды обгоняют систему. Третья — несовпадение раскладки клавиатуры. Четвёртая — скрипт, написанный под другую прошивку или другую версию синтаксиса.

• 🗂 Проверьте каталог и расширение файла;
• ⏱ Добавьте DELAY после каждого действия, открывающего окна;
• ⌨ Убедитесь, что целевая система использует ожидаемую раскладку;
• 🔄 Обновите прошивку, если скрипт требует новых функций.

⚠️ Внимание: использование Flipper Zero для несанкционированного доступа к чужим компьютерам, картам и радиоустройствам может нарушать законодательство вашей страны. Все описанные сценарии предназначены для тестирования собственного оборудования и обучения.

FAQ: частые вопросы о скриптах для Flipper Zero

Можно ли запускать скрипты без SD-карты?

Нет, файлы скриптов хранятся на microSD-карте. Без карты приложения Bad USB и Scripts не смогут найти пользовательские файлы.

Почему BadUSB-скрипт печатает неправильные символы?

Возможная причина — несовпадение раскладки клавиатуры целевой системы с той, под которую написан скрипт. Проверьте раскладку и при необходимости адаптируйте команды STRING.

Безопасно ли скачивать готовые сборники скриптов?

Скачивать — да, запускать вслепую — нет. Перед запуском откройте каждый файл в текстовом редакторе и убедитесь, что понимаете все команды, особенно связанные с сетевыми запросами и системными утилитами.

Можно ли писать скрипты прямо на устройстве?

Базовое редактирование возможно, но удобнее готовить файлы на компьютере и копировать через qFlipper или кардридер — экранная клавиатура не рассчитана на набор длинного кода.

Работают ли скрипты от USB Rubber Ducky?

Классический синтаксис Ducky Script в основном совместим, однако отдельные расширенные команды могут не поддерживаться или работать иначе. Тестируйте такие скрипты на своём ПК по частям.