Complete User Guide

About FoxFW

FoxFW is a fully custom Flipper Zero firmware that extends the official firmware with a large set of exclusive features. It is designed around three goals: security, usability, and deeper RF tooling.

Key things that make FoxFW different from stock firmware:

• A multi-screen first-boot setup wizard that guides you through naming and securing your device.
• A full PIN lock system with configurable attempt limits, automatic lock timers, and an On Exceed security action.
• Granular Disconnect on Lock — choose whether BLE, GPIO, and USB are disabled when the screen locks.
• A custom Fox File Browser (FFB) that replaces the stock Archive, with a Favorites system and firmware-install support.
• System-wide bounce-scroll text — any label too long to fit bounces left and right automatically rather than wrapping or truncating.
• A Modulation Analyzer exclusive to FoxFW — find what modulation an unknown device uses, then open the Receiver pre-configured for it.
• FoxLAB — a full browser control page served straight from a wired ESP32, reachable from any phone, tablet, or laptop on its WiFi hotspot. No companion app, no USB, no drivers.
• An in-app RAW Waveform Editor for trimming Sub-GHz captures without leaving the device.
• A live Bar / Line Signal Display for spotting intermittent transmissions.
• Per-protocol enable / disable toggles in the Protocol List.
• An extended Custom Wallpaper system with a factory-seeded template that generates automatically if missing.
• A Sub-Ghz Mode picker on launch — choose Automotive or Garage/Gate/Other, each opening the same familiar Sub-GHz screen scoped to that protocol set, plus dedicated rows for RF Jammer, TPMS Read/Edit, and Radio Settings.
• A Sub-GHz Bruteforcer app in the App Menu for brute-forcing fixed-code remotes across common protocols — every key it tries is now logged live to SD card as it runs, so you can leave it pointed at a device and check the log later, and stopping an attack offers to save the keys it tried for later replay via a new Open Saved Keys menu entry.
• A Sub-GHz Randomized Attack (SubRATT) app — a novelty sibling to the Bruteforcer for keyspaces too large to ever finish sequentially, transmitting random candidate keys forever and logging every key tried to SD card as it runs, so a key that works while you're away is never lost.
• A built-in Screenshot Tool — hold Back+Up on any screen to save what's currently displayed as a standard .xbm file, no computer or qFlipper connection required.
• A full Fox ESP32 companion suite — FoxHub, Chat, Portal, Detector, Flasher, and Chameleon — turning a wired ESP32 into a WiFi/BLE/HTTP extension of your Flipper. Powered by the separate Fox ESP32 Firmware.

Web Installer New

FoxFW can be installed directly from your browser — no software required. Connect your Flipper via USB and the web installer handles everything, including downloading the firmware and triggering the update.

How it works

1. Open the link above in Chrome or Edge on desktop.
2. Choose Standard Update (Flipper on) or DFU Recovery (Flipper unresponsive).
3. Click Connect Flipper and select your device from the browser dialog.
4. Click Install Now — the installer downloads the firmware and transfers it automatically.
5. Your Flipper reboots and applies the update. The Fox Setup Wizard runs on first boot.

FoxFW Lab New

An all-in-one browser dashboard for a connected Flipper: live device info, a file explorer, a live screen mirror, a terminal/CLI, and an NFC file viewer — plus the Wallpaper Painter, Wallpaper Showcase, and FAP Compiler embedded right inside it, all sharing a single serial connection. Fox_ESP32_FW tools are built in too, so you can work on both devices without swapping tabs.

What's inside

• Dashboard — battery, storage, and firmware info at a glance.
• File Explorer — browse the SD card and download files straight from the browser.
• Screen mirror — see the Flipper's display live.
• Terminal — a CLI session over the same connection.
• NFC — view saved NFC files.
• Wallpaper Painter, Wallpaper Showcase & FAP Compiler — embedded directly, no separate reconnect.
• ESP32 tools — Fox_ESP32_FW device info and command console alongside your Flipper.

FAP Compiler New

Want to run a third-party app that isn't bundled with FoxFW? Paste its GitHub URL into the FAP Compiler and it builds a .fap against FoxFW v2.0 for you — no local toolchain install required.

How it works

1. Paste the GitHub URL of the app you want, then click Compile .FAP.
2. Watch the live console as GitHub Actions checks out FoxFW v2.0 and builds the app.
3. Download the finished .fap and copy it to apps/ on your SD card.

Statistics

The Web Installer, the ESP32 Web Flasher and the FAP Compiler each have a Statistics bar at the bottom of the page. Click it to see public, anonymous counts by month, day and country, and on the FAP Compiler the most compiled and most recently compiled apps. No IP addresses, cookies, device IDs or personal details are stored.

Wallpaper Painter New

Draw a custom wallpaper straight in your browser — no MS Paint round-trip, no separate converter tool. Pencil, eraser, line, and fill-bucket tools on a pixel-accurate 128×64 canvas, with the status bar and border pre-locked so you can't accidentally draw somewhere that won't show up on the device.

How it works

1. Draw in the open area of the canvas — the gray border and status bar strip are locked.
2. Give it a name, then click Download and copy the .xbm file into the wallpapers folder on the root of your SD card.
3. Optional: click Connect Flipper (Chrome/Edge only) to preview live on the device's screen, or save straight to the SD card with Save to Flipper SD Card — this also sets it as the active Custom Wallpaper and turns Custom Wallpaper on.

Wallpaper Showcase New

Browse community-made wallpapers, download the ones you like, or — with a Flipper connected over USB — install one straight to the SD card in one click, no file transfer needed.

How it works

1. Browse the gallery — sort by name, newest, or oldest, and search or filter by name.
2. Click Download on any wallpaper to save its .zip (contains the .xbm file), or
3. Click Connect Flipper (Chrome/Edge only), then click Install on a wallpaper to write it straight to the SD card.

Fox ESP32 Firmware

A companion firmware that runs on a separate ESP32 board wired to your Flipper over UART, giving it WiFi and Bluetooth for the whole Fox ESP32 Apps suite — FoxHub, Fox Chat, Fox AI Chat, Fox Portal, and more. ESP32 Classic, S3, S2 (including the official Flipper Wi-Fi Dev Board), C3, C5, and C6 boards are all supported, and the flasher detects which one you have when you connect.

First Boot — Fox Setup Wizard

After installing FoxFW (or after a firmware update that includes a wizard reset), the device automatically launches the Fox Setup Wizard on the first boot. You cannot skip the wizard entirely — you must at least reach the final page and press Finish.

The wizard walks through four pages:

1. Welcome — Introduces FoxFW. Press Right or OK to continue.
2. Rename your Flipper — Optionally set a custom device name.
3. Set a PIN — Optionally secure the device with a lock-screen PIN.
4. Done — Summary. If you made changes the device restarts automatically to apply them.

Renaming your Flipper

Enter a name using the on-screen keyboard. Allowed characters are letters (A–Z, a–z) and numbers (0–9). Maximum length is 7 characters. Leave the field empty and confirm to use the hardware default name.

The device name appears on the lock screen greeting and is used as the Bluetooth advertised device name.

Setting a PIN in the wizard

The PIN grid shows digits 0–9 arranged in a 3-column layout. Navigate with the directional buttons, press OK to select a digit, and press Back to delete the last digit. Once you have entered at least one digit you will be asked to confirm by entering the same PIN again.

The PIN is applied immediately — you do not need to reboot for the lock-screen PIN to become active. The PIN is also stored persistently so it survives power cycles.

Desktop Overview

The FoxFW desktop is the idle screen you see after booting. FoxFW uses a fully custom Fox Theme with an all-orange UI — the stock Dolphin idle animation is intentionally absent and is replaced by a clean static screen. The status bar at the top shows the battery, clock (if enabled), and connection indicators.

Internet Connectivity Icon New

A small three-bar icon sits in the status bar immediately to the left of the battery indicator, showing whether an attached ESP32 companion board currently has a WiFi/internet connection.

Connected

Bold, solid ascending bars

Disconnected / Idle

Same bars, thin outline — not an error

The icon reflects whatever an ESP32 board wired to your Flipper's GPIO header last reported through FoxHub's WiFi menu, and FoxFW also runs a quiet background check roughly once a minute so the icon can't get stuck showing "connected" forever if the board is reflashed, unplugged, or powered off while no companion app is open to notice.

Button Shortcuts

Pressing directional buttons on the idle desktop triggers shortcuts. Some shortcuts are fixed by the firmware; others are configurable in Fox Settings → Favorite Apps.

Lock Menu (Up short)

The Lock Menu appears when you short-press Up on the desktop. It offers:

• Lock — Lock the screen immediately.
• Power Off — Shut down the device.
• Reboot — Restart the device.
• Reboot to DFU — Restart into USB firmware-flash mode (for qFlipper updates).

Lock Screen

When locked, the screen shows a padlock and the PIN entry grid will display when you press any key (if a PIN is set). Enter your PIN to unlock. If no PIN is set, any button press unlocks the device.

Fox File Browser FoxFW Exclusive

The Fox File Browser (FFB) replaces the stock Archive app as FoxFW's primary file management and launch tool. It is accessible from the desktop (Down short press, or any configured Favorite shortcut) and from within the firmware updater flow.

The home screen offers two options:

• Browse SD Card — Navigate the full SD card file system.
• Favorites — Jump directly to pinned files. (Only shown if you have at least one Favorite saved.)

Browse SD Card

The file browser lists all files and folders on your SD card. Navigate with Up / Down, open a folder with OK or Right, and go back with Left or Back.

The Left button on the home screen also directly opens the Favorites list if one exists.

Favorites

The Favorites list shows pinned files as two-line rows:

• Line 1 (bold): The filename (e.g. update.fuf)
• Line 2: The directory path, formatted as / folder / subfolder /

If the path hint is too long to fit, it scrolls when selected — bouncing left and right so you can read the full path. Unselected rows show a …suffix — the most specific (rightmost) part of the path that fits, preceded by ....

Favorites are stored in /ext/apps_data/ffb/favorites.txt. The file is created automatically if it does not exist.

File Actions

Press OK on any file in Browse or Favorites to open the action menu:

Fox Settings

Fox Settings is found in the main App Menu under Settings. It contains all FoxFW-specific configuration. The menu remembers your scroll position while you navigate into sub-menus and back — it only resets to the top when you exit the app entirely.

Security & Privacy

The Security & Privacy screen is the heart of FoxFW's protection system. It covers PIN management, attempt limiting, the On Exceed action, automatic communication disconnect on lock, and auto-lock timers.

PIN Setup

The label changes based on current state: Set PIN (no PIN exists), Change PIN, and Remove PIN (once one is set).

PIN entry uses the digit grid — Up/Down moves between rows, Left/Right moves between columns, OK selects a digit, Back deletes the last digit. Confirm by pressing OK in the bottom-right cell once your minimum digit count is reached.

The PIN is applied immediately without requiring a reboot.

Disconnect Services

Controls which interfaces are disconnected when the device locks. All sub-options are disabled and shown as N/A while On Lock is OFF.

USB Mode New

Fox Settings → USB Mode chooses what the Flipper's USB port is for. qFlipper Mode (the default, and what every boot starts in) is the normal serial/RPC connection used by qFlipper and the CLI. Mass Storage Mode shares the SD card itself with your computer as a removable drive, so you can copy files on and off without pulling the card. The mode that is currently active shows the 7×7 OK marker to its left. The list also includes Music USB Mode and Media USB Mode, which launch the Fox MP3 USB and Fox Media USB apps — these serve the SD card's /MP3/ and /MEDIA/ folders to a computer as read-only drives (for speakers, TVs and media players).

Selecting Mass Storage takes effect immediately: Fox Settings closes and the Mass Storage app takes over the screen, any open qFlipper or CLI session is closed, and the card is handed to the computer. While the Mass Storage Mode screen is showing, nothing on the Flipper can use the SD card and qFlipper cannot connect. Eject the drive on your computer, then press Disconnect (OK or Back) to return to qFlipper Mode instantly — the card is remounted, qFlipper can reconnect, and you are back on the desktop. Ejecting from the computer also returns to qFlipper Mode. The choice is not saved: the Flipper always boots in qFlipper Mode.

Custom Wallpaper

Replaces the desktop background with a custom 128 × 64 pixel monochrome image. FoxFW can store any number of these at once in a wallpapers folder on the root of the SD Card (path: /ext/wallpapers/) and lets you switch between them from Fox Settings without reconnecting the device.

If the folder is missing or empty, FoxFW automatically generates a default wallpaper inside it on first boot. This means a valid wallpaper is always available and selected by default.

Creating your own wallpaper:

• Your image must be exactly 128 × 64 px, monochrome (1-bit black and white), in XBM format.
• The status bar occupies roughly the top 13 pixels — keep important artwork below that.
• GIMP: Image → Scale Image → 128×64 → Image → Mode → Indexed (1-bit) → File → Export As → yourname.xbm
• ImageMagick: convert input.png -resize 128x64! -monochrome yourname.xbm
• Copy the file into the wallpapers folder on the root of your SD card, so it lives at /ext/wallpapers/yourname.xbm.
• Select it under Wallpaper Name in Fox Settings and toggle Custom Wallpaper ON.

Change Flipper Name

Changes the device's display name. The name appears on the lock screen greeting and is broadcast as the Bluetooth device name.

• Allowed characters: letters and numbers only (A–Z, a–z, 0–9).
• Maximum length: 7 characters.
• Leave the field empty and confirm to restore the hardware default name.
• A device restart is required to apply the new name. The restart happens automatically.

Menu Style

Battery View

Controls the battery level indicator in the status bar. Changes take effect immediately — no restart is required.

Show Clock

Favorite Apps

Assigns apps to four configurable desktop button shortcuts. Each slot is triggered from the idle desktop screen.

Fox ESP32 Apps FoxFW Exclusive

FoxFW ships a full suite of apps that pair with a wired ESP32 to extend your Flipper Zero with WiFi, BLE, HTTP, scripting, Discord, captive portal, and more. All communicate over a plain UART link at 115200 baud — connect TX (GPIO1) → Flipper pin 14 and RX (GPIO3) → Flipper pin 13.

Fox USB Drive Apps — MP3 & Media New

Two apps turn a folder on your SD card into a small read-only USB drive named FOX that you plug straight into a Bluetooth speaker, car head unit, or TV — no PC in the middle. Unlike Mass Storage Mode (which shares your whole SD card), these expose only one chosen folder, so the device on the other end sees just your media.

• Fox MP3 USB — serves everything in the /MP3/ folder at the root of the FOX drive.
• Fox Media USB — serves the /MEDIA/ folder and its MUSIC, VIDEO and PICTURE sub-folders (created for you automatically the first time you run it).

How to use: copy your files into /MP3/ (or the /MEDIA/ sub-folders) first — over qFlipper, Fox File Browser, or a card reader — then launch the app. It builds the drive from whatever is in the folder and presents it over USB as FOX. Plug the Flipper into the speaker or TV and it reads your files like an ordinary thumb drive.

While the drive is active the screen shows the FOX drive with live read counters and a brief LOADING hint while the other device opens it. Press Disconnect (OK) or Back to end the session and return to normal — qFlipper reconnects on its own.

Sub-GHz

The Sub-GHz app lets your Flipper interact with radio-frequency devices between ~300 MHz and 928 MHz — garage doors, gate openers, weather stations, tyre-pressure sensors, key fobs, alarm remotes, and many more. FoxFW adds a Bar/Line signal display, an in-app RAW editor, a Modulation Analyzer, and per-protocol enable/disable toggles.

Read Enhanced

Opens on a Start screen — press OK to begin listening for an incoming signal. Unlike the original Read screen (which decodes every protocol continuously in real time), Garage/Gate/Other's Read now records the incoming signal raw first and only runs it through the protocol decoders once the transmission has actually finished — the listening screen looks and behaves like Read RAW's own recording screen. The decode pass tries every enabled Protocol Group against the capture in turn until one decodes it or none do. While that runs, a Decoding screen shows a progress bar and which Protocol Group is being tried (for example 3/11); Back cancels and returns to the Start screen. A signal has to clear the RSSI Threshold set in Receiver Config before Read starts treating it as an actual transmission, so ambient RF noise alone won't trigger a capture. Read also measures the background level of the radio it is using as listening starts: if that background sits close to or above your threshold (some amplified external modules do this), the bar is raised above it automatically for that Read. A burst of only a few stray pulses is ignored and Read keeps listening, and a single capture ends after 5 seconds at most. If the signal decodes successfully you're taken straight to its info screen to save or discard it; if nothing matches, a "No Match" screen offers Back (return to the Start screen with the Start button ready, not counting down) or Save (keep the raw capture and load it into the RAW editor). Nothing is written to SD card unless you choose to save.

Read RAW Enhanced

Records everything the radio receives as a timed sequence of high/low edges without attempting to decode. Use this when the protocol is unknown, not yet supported, or uses rolling codes.

FoxFW enhancements to Read RAW:

• Recording timer — A timer in the top-right corner of the waveform display shows how long the current recording has been running. The timer stays visible after recording stops so you always know the length of the last capture.
• Animated playback cursor — When you send a raw recording without saving it (Left button), a vertical line in the waveform display resets to the left edge and animates rightward in real time as the signal plays back, giving you a live visual of playback progress.

Saved Files & RAW Editor NEW

The Saved menu lists all .sub files under /ext/subghz/. Tap a file and press OK or More for available actions.

RAW Editor controls:

Signal Display — Bar & Line NEW

Change between display styles in Radio Settings → Visualizer. The setting persists across reboots. Both styles read the same live RSSI window and share the dashed trigger-threshold line — only the rendering differs.

Frequency Analyzer

Sweeps a wide frequency range looking for any signal above the noise floor. When a carrier is detected its frequency is highlighted.

Modulation Analyzer FoxFW Exclusive

The Modulation Analyzer solves the complementary problem to the Frequency Analyzer: you know the frequency but you don't know the modulation. It rapidly cycles through all enabled modulation presets at a fixed frequency, recording any preset whose RSSI rises above a detection threshold as a "hit." After scanning, select a hit and press OK to open the Receiver pre-configured for that exact frequency and modulation.

Controls:

Screen layout:

Config page: Press Left to open. Scanning pauses automatically.

Modulation reference:

Recommended workflow — unknown device:

Protocol List & Filters NEW

Automotive mode lists every protocol grouped by manufacturer/family (Ford, Kia/Hyundai, VAG, PSA, and so on). Each group has its own master ON / OFF toggle that sets every protocol inside it at once, and every individual protocol underneath can still be toggled on its own. Protocols set to OFF are completely ignored during Read and Read RAW — the toggle is live, not just cosmetic.

The top of the list shows the active protocol count, computed live:

Garage/Gate/Other mode shows a different screen here instead, opened from the app's own full-width Protocol Group button — one double-row button per Protocol Group. Each button shows the group's name in bold with its member protocols scrolling underneath. Up/Down move the highlight to browse groups; pressing OK on a group toggles it ON or OFF independently of every other group, shown with a small icon on the left (filled = enabled, hollow = disabled) — at least one group must stay enabled. Only one group's protocols are ever resident in RAM at a time, but Read's decode pass tries every enabled group in turn against a captured signal, so you don't have to pre-pick a single group before capturing — only rule out the ones you're not interested in.

Sub-Ghz Mode Picker New

Opening Sub-GHz first shows a Sub-Ghz Mode screen — five stacked buttons, two visible at a time with a scrollbar on the right showing there's more to scroll to:

Automotive opens straight into the same Sub-GHz screen you already know — Read, Saved, Protocol List, and so on. Garages/ Gates/Other launches a separate external app that looks and behaves exactly the same way, just scoped to non-automotive protocols; a loading wheel is shown briefly while it starts, since it's a large app. RF Jammer and TPMS Read/Edit each launch their own standalone app the same way, and Back returns you to this picker with that row still highlighted. Whichever mode you pick, pressing Back from its main menu exits Sub-GHz entirely (same as before) — relaunch the app to pick a mode again.

Garage/Gate/Other also automatically uses an external CC1101 module (connected via GPIO/external antenna) instead of the internal radio whenever one is present — no setting to turn on. A small background app checks for one automatically, and remembers the answer, rather than checking on every single launch, which would cost RAM even for the common case of nothing being plugged in. This check only runs while the Flipper is idle (home screen, not locked, nothing else running), on the same schedule as the status bar WiFi/CC1101 icon's ESP32 check — every 15 seconds once an ESP32 companion board has ever answered on this device, every minute until then. If you've just connected a module and don't want to wait, run CC1101 External Probe for SubGhz Garage from the Apps menu to force an immediate recheck — that also opens Garage/Gate/Other automatically once it's done.

Supported Systems Reference

FoxFW includes protocol decoders and encoders across two groups, matching the Sub-Ghz Mode picker: the Automotive Key Fob Protocols table below is what the Automotive mode loads; Gate & Access Control and General RF Protocols together are what the Garage/Gate/Other mode loads. All operate within the 315 MHz, 433 MHz, and 868 MHz Sub-GHz bands.

Automotive Key Fob Protocols Automotive

Tire Pressure Monitoring (TPMS) Standalone App

Gate & Access Control Protocols Garage/Gate/Other

The Group column shows which Protocol Group each protocol belongs to — make sure that group is enabled on the app's own Protocols screen for Read to try it (every group is enabled by default).

General RF Protocols Garage/Gate/Other

Disabled / Experimental Protocols

These protocols are fully implemented in the FoxFW source tree but are commented out of the active registry, so they do not count toward the 63 active protocols above and won't appear in the Protocol List on the device. Reason: Further testing/fixes required.

Radio Settings

System UX — Bounce Scroll & Text Rendering FoxFW Exclusive

FoxFW replaces the stock single-direction text scroll with a bounce-scroll system applied throughout the entire firmware. Any label that is too long to fit in its display area will:

1. Pause briefly showing the start of the text.
2. Smoothly slide left to reveal the end of the text.
3. Pause at the right end.
4. Slide back to the left — and repeat.

This affects the App Menu, all Settings menus, the Sub-GHz Protocol List, the Fox File Browser Favorites list path hints, and every other scrollable text element in the firmware.

In the Fox File Browser Favorites list specifically:

• Selected row: The path hint (line 2) bounce-scrolls so you can read the full path of both files even if they share the same filename.
• Unselected rows: Show …suffix — the most specific end of the path that fits, preceded by ..., so you can always see which folder the file is in.

Screenshot Tool FoxFW Exclusive

Capture exactly what's on screen, from anywhere in the firmware — no computer, no qFlipper, no cables. Hold Back + Up together for about one second on any screen (the lock screen, the Desktop, any app, any menu) and FoxFW saves the current display to your SD card.

• Where it saves: /Screenshots/ on the SD card, created automatically the first time you use it.
• Filename: Screenshot_<app>_YYYYMMDD_HHMMSS.xbm — the date, time, and the currently running app's name (e.g. Screenshot_subghz_garage_20260905_073225.xbm), or desktop in place of the app name when captured from the idle home/lock screen. The timestamp means repeated captures never overwrite each other.
• Format: a standard .xbm bitmap — a plain-text file readable by GIMP, ImageMagick, and most image tools, and the exact same format FoxFW's own Custom Wallpaper feature uses. A screenshot can be dropped straight into /wallpapers and used as a wallpaper if you like what you captured, or viewed full-screen from Fox File Browser's own built-in viewer (press OK on it, then View).
• Converting screenshots New — the Fox XBM Converter app (Apps → Fox) turns a saved .xbm screenshot into a monochrome .bmp you can edit on a PC (MS Paint or similar), then convert back to .xbm when you're done. It only browses /Screenshots/. From FFB, pressing OK on any .xbm or .bmp file in that folder offers it directly in the Open With menu alongside View, once it's installed.

Installing Firmware Updates

There are four ways to install a FoxFW update:

Method 1 — via Web Installer New (recommended)

1. Connect your Flipper to your computer via USB.
2. Open the FoxFW Web Installer in Chrome or Edge on desktop.
3. Choose Standard Update and click Connect Flipper, selecting your device from the browser dialog.
4. Click Install Now — the installer downloads the firmware and transfers it automatically, no software install required.
5. The Flipper will reboot. On first boot after the update the Fox Setup Wizard runs.

Method 2 — via qFlipper

1. Connect your Flipper to your computer via USB.
2. Open qFlipper (v1.3.3 or later).
3. Click Install from file and select the FoxFW .tgz update package.
4. qFlipper will flash the firmware and copy resources automatically.
5. The Flipper will reboot. On first boot after the update the Fox Setup Wizard runs.

Method 3 — via Fox File Browser (wireless / SD-card update)

1. Copy the .fuf firmware update file to your SD card (any folder — Favorites or a dedicated folder is recommended).
2. Open Fox File Browser from the desktop.
3. Navigate to the .fuf file and press OK.
4. Select Install from the action menu.
5. The firmware updater launches and the device restarts to apply the update.

Method 4 — via Fox Update Downloader (fully wireless, no PC or USB)

If you already have a wired ESP32 running Fox ESP32 Firmware, Fox Update Downloader can check GitHub, download, and install a FoxFW update entirely on-device — the ESP32 acts as the internet connection your Flipper doesn't otherwise have.

1. Make sure your ESP32 is wired up and joined to a WiFi network (see the Fox ESP32 Apps chapter if you haven't set this up yet).
2. Open Fox Update Downloader and select Fox Custom Firmware.
3. Wait for the check to finish. If an update is available, press Download.
4. Once it finishes downloading, press Install — the device restarts automatically to apply it, same as any other method.

Lockout & Recovery

I forgot my PIN

If you remember your PIN but keep entering it wrong, stop — every failed attempt counts toward the MAX Attempts limit. Once the limit is reached, the On Exceed action fires and the device reboots to a "Locked!" screen. At that point normal access via the device or qFlipper is blocked. See below for recovery options.

I am completely locked out

If you cannot get back into the device on your own, you have two options:

1. Reinstall the firmware via qFlipper DFU Mode. Boot your Flipper into DFU mode (there are several methods for this that should be common knowledge to you by now). In DFU Mode, connect your Flipper via USB, open qFlipper, and use Install from file to flash flipper-z-f7-full-local.dfu. This will restore normal access. Your SD card files (saved signals, NFC cards, etc.) are not affected by a firmware reinstall.
2. Contact support. Email us and we will provide recovery instructions specific to your situation.