Что такое формат файла FAP?
Файл .fap - это Flipper Application Package, приложение, разработанное для мультитула Flipper Zero компанией Flipper Devices. Технически это объектный файл .elf, скомпилированный для ядра ARM Cortex-M4 чипа STM32WB55, с метаданными Flipper, иконкой и ресурсами, упакованными в дополнительные секции.
Поскольку микроконтроллер Flipper не может запускать код напрямую с SD-карты, загрузчик приложений (App Loader) прошивки копирует .fap в RAM, проверяет совместимость версии API, применяет релокации и разрешает функции прошивки, которые он вызывает, перед запуском. Каждый пакет записывает версию API прошивки, для которой он был собран, поэтому приложение продолжает работать в разных сборках прошивки, пока совпадает мажорная версия. Разработчики создают FAPs с помощью Flipper Build Tool (FBT или облегченной версии ufbt), управляемой манифестом application.fam, который помечает приложение как внешнее.
Безопасность и защита
РИСК: MEDIUMA .fap is native ARM code that runs on the Flipper Zero, so a malicious or buggy app could misbehave on the device, though it runs in the Flipper's constrained environment and cannot infect a desktop PC by sitting on it. The main caution is that FAPs can drive the Flipper's radios and GPIO in ways that may be illegal or harmful if misused. Install FAPs from the official catalog or trusted repositories, and be aware community apps are not reviewed as strictly as official ones.
Детали формата
в двух словахПОЛНОЕ НАЗВАНИЕFlipper Application Packageтакже известен как Flipper App Package, FAP
РАЗРАБОТЧИКFlipper Devicesс 2022
КАТЕГОРИЯИсполняемые файлы
MIME-ТИПapplication/octet-stream
ТИПBinary (ELF-based relocatable executable with embedded metadata and resources)
Это расширение также используется в…
- FileMaker (older ACT! / generic) - The .fap extension has occasionally appeared as an application or project file in older niche software, unrelated to Flipper Zero.
- Generic 'application package' data - Some legacy tools used .fap as an ad hoc application data file; these predate and are unrelated to the Flipper Application Package.
MAGIC BYTES · СИГНАТУРА ФАЙЛА
СМЕЩЕНИЕ
00010203
HEX
7F454C46
ASCII
·ELF
A FAP begins with the standard ELF magic (0x7F 'E' 'L' 'F') because it is an ELF object file. It has no unique .fap signature; the Flipper-specific metadata (fap_version, api version, icon, name) is embedded in ELF sections, so the file is identified by its .fap extension and ELF contents rather than a distinct header.
Программы, открывающие файлы FAP
Windows3 apps
qFlipper
Бесплатно Connect the Flipper Zero over USB, open Applications, choose Install Application, and select the .fap to write it to the device.
Flipper Lab (lab.flipper.net)
Бесплатно Open the site in a browser with the Flipper connected over USB and install a .fap straight from the catalog or a local file.
Flipper Build Tool (FBT / ufbt)
Открытый код Build, launch, or debug a .fap from source using ufbt or fbt fap_{APPID} targets. 
macOS3 apps
qFlipper
Бесплатно Connect the Flipper over USB, open Applications, choose Install Application, and pick the .fap to install it.
Flipper Lab (lab.flipper.net)
Бесплатно Install a .fap from the web catalog while the Flipper is plugged in over USB.
Flipper Build Tool (FBT / ufbt)
Открытый код Compile and deploy a .fap from app source using the ufbt toolchain. 
Linux3 apps
qFlipper
Бесплатно Attach the Flipper over USB, open Applications, choose Install Application, and select the .fap to flash it to the device.
Flipper Lab (lab.flipper.net)
Бесплатно Use the browser catalog to install a .fap onto a connected Flipper Zero.
Flipper Build Tool (FBT / ufbt)
Открытый код Run ufbt launch or fbt fap_{APPID} to build a .fap and load it onto the device. 
Android1 app
Flipper Mobile App
Бесплатно Pair with the Flipper over Bluetooth, open the Apps section in the Hub tab, and install a .fap from the catalog.
iOS1 app
Flipper Mobile App
Бесплатно Connect to the Flipper over Bluetooth, open Apps in the Hub tab, and tap Install on the .fap you want. Технические подробности
глубокая спецификация| Encoding | Binary ELF object file |
| Byte order | Little-endian |
| Container | ELF (Executable and Linkable Format) |
| Elf Machine | ARM (Cortex-M4F / Thumb), targeting the STM32WB55 MCU on Flipper Zero |
| Code Model | Relocatable / position-independent; the App Loader processes relocations and resolves imported firmware symbols at load time |
| Symbol Resolution | Imported functions are resolved against the firmware symbol table generated from api_symbols.csv |
| Embedded Metadata | App name, icon, category, stack size, fap_version and required firmware API version stored in dedicated ELF sections |
| Resources | Static and animated images can be bundled as private assets via the fap_icon_assets manifest field |
| Build Tool | Flipper Build Tool (FBT / ufbt), configured through an application.fam manifest with apptype FlipperAppType.EXTERNAL |
| Loading | Cannot execute in place from SD card; the App Loader copies the FAP into RAM, verifies compatibility, applies relocations, then runs it |
| Typical size | A few kilobytes to a few hundred kilobytes |
| Integrity | App Loader verifies API-version compatibility before running; no separate CRC/hash in the file itself |
| Platforms | Flipper Zero firmware (FreeRTOS-based) |
| Structure | Standard ELF layout (ELF header, program/section headers, .text/.data/.rodata, relocation and symbol tables) plus custom sections carrying Flipper app manifest data and icon assets. |
| Notes | FAPs are not tied to one firmware build; compatibility is decided by the required API version embedded in the file. Distributed through the official Flipper Apps catalog (lab.flipper.net), the Flipper mobile app, and community repositories. |
| Выпущен | 2022 |
| Последняя версия | Tied to firmware API version (major.minor) |
| Спецификация | developer.flipper.net |
Конвертации FAP
Вопросы и ответы сообщества
спрошено пользователямиВопросов пока нет - станьте первым, кто спросит о файлах FAP.
Часто задаваемые вопросы
Как открыть файл .fap?
Вы устанавливаете его на Flipper Zero, а не открываете на компьютере. Используйте qFlipper или Flipper Lab через USB, мобильное приложение Flipper через Bluetooth или скопируйте
.fap в папку apps на SD-карте и запустите через Apps > External на устройстве.Можно ли открыть файл .fap на моем ПК?
Не для запуска. ПК не может исполнять код ARM для Flipper. Вы можете изучить
.fap как бинарный файл ELF с помощью таких инструментов, как readelf или Ghidra, но работает он только на Flipper Zero.Куда попадают файлы FAP на SD-карте?
Они находятся в подпапках категорий внутри директории
apps на карте microSD устройства Flipper. Категория берется из манифеста приложения, после чего приложение отображается в меню Apps на устройстве.Почему мой файл FAP не загружается на Flipper?
Большинство ошибок загрузки связано с несоответствием версии API. FAP был собран для другой версии API прошивки, отличной от той, что установлена на вашем Flipper. Обновите приложение или прошивку, чтобы мажорные версии API совпадали.
Как создать файл .fap?
Напишите приложение на C, добавьте манифест
application.fam с типом apptype FlipperAppType.EXTERNAL и соберите его с помощью Flipper Build Tool (FBT) или автономной утилиты ufbt.Безопасно ли устанавливать файлы FAP?
FAPs из официального каталога наиболее безопасны. Сторонние FAPs - это нативный код с доступом к аппаратному обеспечению Flipper, поэтому устанавливайте их только из доверенных источников и соблюдайте местные законы при использовании радиочастотных функций или функций контроля доступа.
Ссылки
1Flipper Developer Docs - FAP (Flipper App Package)developer.flipper.net
2Flipper firmware documentation - AppsOnSDCard.mdgithub.com
