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.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. Pick them if your TX module or receiver accepts a non-inverted signal (ELRS gear like the RadioMaster Bandit does).
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.

Older versions

When older v2.x versions roll out, they’ll land below this line. Need a link that isn’t here? Reach out.

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