ShutterBridge

Your camera, on the OSD. Your switches, on the shutter.

ESP32 firmware that links your flight controller and action camera - camera status drawn straight on your goggles, and RC switches mapped to record, photo and mode.

⚡ Flash it now  ·  📖 Documentation  ·  🌐 Website

---

What it does

ShutterBridge runs on a small ESP32-S3 or ESP32-C3 board wired to your flight controller. It talks to your action camera over Bluetooth LE and to Betaflight over MSP, so you get two things in flight:

• Camera status on your OSD - record state, battery, SD space, mode, resolution/FPS and recording timers, drawn right where you're looking.
• RC switches on the shutter - start recording when you arm, stop when you disarm, trigger photos, or switch modes from a channel. No touching the camera.

Everything is configured from a clean on-device Web UI - connect to the board's Wi-Fi access point and open it in a browser. No app, no drivers.

See it in action

Arm to record

OSD in the goggles

Web UI

Compatible cameras

The Osmo Action series and the Osmo 360 share the same DJI R-SDK backend.

Feature	DJI Osmo (Nano)	DJI Action / 360	GoPro (HERO9+)
Connect + auto-reconnect	✅	✅	✅
Pairing (accept PIN / bond on the camera)	not required	✅ (PIN)	✅ (bond)
OSD telemetry (record state, battery, SD, timers)	✅	✅	✅
Mode readout (video / photo)	✅	✅	❌
Photo / video mode switch	❌	✅	❓
Resolution / FPS readout	❌	✅	❓
Start / stop recording (with optional delay)	✅	✅	✅
Take photo	✅*	✅	❓
Preset switching (Video / Photo / Timelapse)	❌	❌	❓
Load preset by ID	❌	❌	❓
Clock sync from FC GPS time	❌	❌	❓
Tested on real hardware	✅	✅ (Action 4)	✅ (HERO 12)

* The Osmo Nano can't switch photo/video over BLE, so the shutter captures a photo only when the camera is already set to Photo mode. The Action / 360 / GoPro switch modes automatically or via the Camera Mode switch.

❓ = supported by the backend but not yet verified on hardware.

Warning

Wake the Osmo Nano before recording. Starting a recording while the camera is asleep (standby / screen off) produces a corrupted, very-low-FPS clip. Wake it and wait until it reads online before you arm - a current limitation with no known fix.

What you need

• One of two boards - Waveshare ESP32-S3-Zero (ESP32-S3FH4R2: 4 MB flash, 2 MB PSRAM, native USB) or ESP32-C3 Super Mini (ESP32-C3FH4: 4 MB flash, no PSRAM, USB-Serial/JTAG).
• Betaflight 2025.12 or newer on your flight controller - talks to the bridge over MSP and draws the OSD elements.
• A supported action camera - a DJI Osmo / Action or a GoPro HERO9 or newer.

Getting started

The easiest path is the browser-based flasher - no toolchain required:

1. Plug the board into a data-capable USB-C port.
2. Open the web flasher in Chrome or Edge, click Connect and pick the board's serial port when prompted.
3. It detects the board automatically; click Install and wait for it to finish.
4. Re-plug the board, connect to the ShutterBridge Wi-Fi access point (password shutterbridge), and open http://10.0.0.1 to finish setup.

See the full documentation for wiring, Betaflight OSD setup and per-camera notes.

Building from source

The firmware is a PlatformIO project targeting two boards: the Waveshare ESP32-S3-Zero (env esp32s3-zero, the default) and the ESP32-C3 Super Mini (env esp32c3-supermini). From the firmware/ folder:

# Build and flash the firmware over USB (defaults to esp32s3-zero)
pio run -t upload

# Build and upload the Web UI (LittleFS) image
pio run -t uploadfs

# For the ESP32-C3 Super Mini instead, add -e esp32c3-supermini to either command
pio run -e esp32c3-supermini -t upload

pack-localhost-dev-firmware.sh [env] bundles the build output into the site's local web flasher for development (defaults to esp32s3-zero).

Planning to contribute? See CONTRIBUTING.md for the dev setup, and how to submit changes.

Repository layout

Path	What's inside
firmware/	ESP32-S3 / ESP32-C3 firmware (PlatformIO) and the on-device Web UI.
site/	The website, documentation and browser-based web flasher (Astro).

License

ShutterBridge is free software, licensed under the GNU General Public License v3.0 or later. See LICENSE for the full text.

Copyright © 2026 YarosFPV