OS Images

Pick a Magic Box firmware version below, download the SD card image, then follow How to Update to flash and restore your config.

Latest

v2.7.0 — 2026-06-23

Hear your trims hit centre, and watch a head tracker move while you bind it.

Download v2.7.0 SD card image ↗

Trims get an audible centre — walk a trim back through neutral and you get a double-beep, so you can find centre mid-flight with your eyes on the model. The Modules page gets a live preview: plug in a head tracker or any wired module and watch its values move on screen as you set the bindings.

One image covers both Magic Box v1.4 and v2.0 hardware.

Update procedure: back up your config, flash sf-1-v2.7.0.img.xz with Raspberry Pi Imager, restore. Walk-through: How to Update. About 15 minutes.

What’s new

Trim centre double-beep — a trim passing through neutral lands on exactly zero and plays two spaced beeps. Centre becomes something you hear rather than something you look for.
Live module preview — the Modules page streams live values from a wired module (head tracker being the common case), so you watch the numbers move while you bind them instead of guessing.
Two-position switch modes — 2-position switches carry a switch-mode setting.
One image, both hardware versions — the same card boots on v1.4 and v2.0. Flash the same file whichever box you own.

Older versions

Need a link that isn’t here? Reach out.

v2.6.1 — 2026-05-25

Run two identical controllers side by side.

Download v2.6.1 SD card image ↗

Two controllers of the same model — a matched pair of grips, twin throttle quadrants, two identical button boxes — are addressable separately, each with its own bindings. Identical hardware reports identical USB identity, so Magic Box tells them apart by the order they come up: the first keeps the plain device id, the second gets a #2.

Label the two cables 1 and 2 and plug them in the same order every time — that’s what keeps each stick on its own bindings.

What’s new

Two identical controllers, separately bindable — devices sharing a USB identity each get their own entry instead of collapsing into one. Bindings for single-controller setups are untouched.
Buzzer tone on v1.4 — the buzzer drives at the polarity the v1.4 board expects, so trim clicks and alerts come out as clean tones.

v2.6.0 — 2026-05-18

Advanced trims + trim beeper + better CRSF/IBUS support on v1.4 hardware.

Download v2.6.0 SD card image ↗

Big quality-of-life release for pilots who actually fly off the bench. Trim system v2 — hold a trim button to walk a servo, bind trims on a different stick than the main axis (rudder on the pedals, trim on the throttle), buzzer click on every trim step, and a latching mode that turns one button into a multi-position switch. IBUS and CRSF unlocked on v1.4 hardware — the protocol dropdown no longer hides them; v1.4 boxes can now drive ELRS gear like the RadioMaster Bandit. Plus a battery readout overhaul — live voltage and current in the header, cell count shown automatically, and a percent reading calibrated against a real 3S pack.

Update procedure: back up your config, flash sf-1-v2.6.0.img.xz with Raspberry Pi Imager, restore. Walk-through: How to Update. About 15 minutes.

What’s new

Trim auto-repeat on hold — hold a trim button and it walks the servo for you. No more machine-gunning the button to bring a stuck servo back to zero.
Cross-device trim source — bind your trim buttons on a different stick or quadrant than the channel’s main axis. Classic case: rudder axis on the pedals, rudder trim on the throttle or joystick (pedals don’t have buttons).
Trim beeper — optional click on every trim step. Silent at the end of travel so you hear “you’re at the limit” instead of a stuck tone.
Latching mode for multi-state buttons — turn one button into a 2-, 3-, or N-position switch. Wrap-up, wrap-down or ping-pong cycle modes.
IBUS and CRSF unlocked on v1.4 hardware — the v1.4 protocol dropdown no longer hides IBUS and CRSF. v1.4’s UART is inverted, so pick these only if your TX module can be told to accept an inverted input — ELRS gear like the RadioMaster Bandit can, via UART inverted in its WebUI. The Settings page warns you when the pairing needs it.
Battery readout fixes — live voltage and current in the header, cell count auto-detected (12.4V / 3S), and percent reading calibrated against a real LiPo discharge curve.
PPM pin hot-swap — change the PPM output pin or jack polarity in Settings without rebooting the box.
Add Element redesign — plug in a stick, the box guesses whether you just moved an axis, a button, a hat or an arm switch, you confirm. Six element types, row-click on the suggestion, the new row flashes briefly so you see what landed.

v2.5.1 — 2026-05-09

First official v2 release.

Download v2.5.1 SD card image ↗

This is the first official v2 release, replacing the v1 line that was configured by editing YAML files on the SD card. v2 moves the entire configuration into a database with a Web UI you reach from your phone — no more text-file editing, no more “did I get the indentation right?”.

Coming from v1.x? Follow Migrating from v1 to v2. v2 ships with an in-app YAML import wizard that brings your old profiles, bindings and channels across in one tap.

Coming from v1.x? v1 → v2 requires a full SD card image flash and a one-tap import of your old config. Walk-through: Migrating from v1 to v2.

What’s new

Configure from your phone — full Web UI over the MagicBox-XXXX Wi-Fi. No laptop, no cables, no text files.
Bring your v1 profiles across — built-in importer reads your old v1 config and rebuilds your profiles, bindings and channels in one tap.
Vehicle presets — Aircraft, Tank and Car layouts ready to go. Pick one and you’re set up in seconds.
Edit profiles in the app — rename, reorder, add or delete groups and functions per profile. Save your tweaks as a new layout.
Head tracker via PPM input — wire your head tracker into the PPM input and use it as a first-class channel source alongside your USB sticks.
Per-channel override — pick any button to switch a channel to a different source mid-flight (great for head tracker on/off).
Bake Trims — one tap to lock your current trim into the profile and start fresh. EdgeTX-style.
Themes for the cockpit — F-22 Raptor and F-16 Viper dark themes, plus a daylight mode that stays readable in bright sun.
One-click backup & restore — full system backup straight from the Web UI. Restore on a fresh card in a minute.

Looking for v1.x history (v1.4 through v1.7)? See the v1 release notes on GitBook ↗.