Skip to content

About

✨ MagicPilot Remote β€” Open-source Bluetooth touchscreen remote for the Blackmagic Pocket Cinema Camera 6K (BMPCC6K). ESP32 firmware for M5Stack Core2 / CoreS3: focus, ISO, shutter, white balance, iris, record & presets.🎬

Topics

Resources

Stars

3 stars

Watchers

0 watching

Forks

Latest commit

Β 

History

12 Commits

Folders and files

Repository files navigation

✨ MagicPilot Remote: Bluetooth Remote for the Blackmagic Pocket Cinema Camera 6K

🎬 A tiny open-source touchscreen remote for the BMPCC6K, built on ESP32 / M5Stack.

Install MagicPilot Remote from your browser, in Chrome, Edge or Firefox, onto a Core2, CoreS3 or CoreS3-SE

Easy install: connect your M5Stack Core2, CoreS3 or CoreS3-SE by USB and flash v1.0.0 in one click from Chrome, Edge or Firefox in the web installer. You don't need an IDE or a toolchain. Β· Release notes

🌐 Website: kenfilms.github.io/MagicPilot_Remote

BlackmagicCameraControl arduino-esp32 Platform MCU Framework Camera

MagicPilot Remote on an M5Stack Core2 showing live ISO, shutter angle, FPS, white balance, tint, iris and timecode from a Blackmagic Pocket Cinema Camera 6K

MagicPilot Remote presets screen with save, load and clear buttons for two Blackmagic camera presets

Github_MagicPilot_Remote.mp4

Watch the MagicPilot Remote demo video

MagicPilot Remote is a free, open-source wireless remote control for Blackmagic cameras, tested with the Blackmagic Pocket Cinema Camera 6K (BMPCC6K). The firmware runs on an ESP32-based M5Stack Core2, CoreS3, or CoreS3-SE touchscreen and talks to the camera directly over Bluetooth Low Energy (BLE) using the official Blackmagic Camera Control protocol. You can pull focus, trigger autofocus, change ISO, shutter angle, frame rate, white balance, tint and iris, start and stop recording, and save camera presets without a phone, a Wi-Fi network, or the Blackmagic Camera app.

Table of contents

Overview

Why MagicPilot?

MagicPilot puts the controls you need on a tiny touchscreen that you can keep beside the camera.

  • Next to your external monitor. An external monitor is brighter than the camera's built-in screen, so that is where you look. MagicPilot mounts right beside it, so the settings are in your line of sight.
  • When the camera is out of reach. With the camera against a wall or mounted very high, such as on a crane, the remote changes settings and starts or stops recording from wherever you stand.

✨ Everything You need at a Glance

Diagram of the MagicPilot Remote on an M5Stack Core2: status header with remote battery, camera mode, camera battery and Bluetooth link; timecode; ISO, shutter, FPS, white balance, tint and iris values; focus and presets buttons; record, minus/plus and connect buttons; card slot status; Bluetooth LE link to the BMPCC6K

Feature What it does
πŸ”­ Focus Control NEAR β†’ FAR slider, 1% steps and one-shot autofocus.
πŸ“Š Live Camera Readout ISO, shutter angle, FPS, white balance, tint, iris, timecode, battery and card status.
πŸŽ›οΈ Parameter Control Tap a value, then use βˆ’ / + to change it on the camera.
πŸŽ₯ Record Control Start and stop recording with one button.
πŸ’Ύ Camera Presets Save and recall two complete camera configurations.
β˜€οΈ Automatic Brightness The CoreS3 adjusts its display backlight to ambient light; Core2 retains its default brightness.

Getting started

🧰 Hardware

MagicPilot is designed around a small amount of readily available hardware:

  • M5Stack Core2, CoreS3, or CoreS3-SE β€” touchscreen remote and ESP32 platform
  • BMPCC6K β€” with Bluetooth enabled
  • microSD card β€” optional; required for preset storage.

That's it.

No phone. No Wi-Fi network. No external computer.

⚑ Install in your browser

The quickest way to get MagicPilot onto your M5Stack is the web installer:

  1. Open the installer in Chrome, Edge or Opera on a desktop computer.
  2. Connect the Core2, CoreS3 or CoreS3-SE with a USB-C data cable.
  3. Click Install MagicPilot Remote and select the device's serial port.

The installer detects the board (ESP32 for Core2, ESP32-S3 for CoreS3/CoreS3-SE) and writes the matching firmware. To flash manually instead, download the image for your board from docs/firmware and write it at offset 0x0:

Board Image
M5Stack Core2 MagicPilot_Remote_m5stack-core2.bin
M5Stack CoreS3 / CoreS3-SE MagicPilot_Remote_m5stack-cores3.bin
esptool.py --chip esp32   write_flash 0x0 MagicPilot_Remote_m5stack-core2.bin
esptool.py --chip esp32s3 write_flash 0x0 MagicPilot_Remote_m5stack-cores3.bin

Build and flash

Arduino IDE

Note

The Arduino IDE does not autodetect the board. You must select the matching board yourself before uploading. Automatic detection is only available with PlatformIO via scripts/upload_auto.py.

  1. Install the ESP32/M5Stack board support package and the M5Unified and M5GFX libraries. For CoreS3/CoreS3-SE, also install the LTR5XX ambient light sensor library: download LTR5XX.zip and add it via Sketch β†’ Include Library β†’ Add .ZIP Library….
  2. Open MagicPilot_Remote.ino. Keep the folder name MagicPilot_Remote and the src folder next to it, because the firmware is in src/main.cpp.
  3. Select the M5Stack Core2 board for Core2, or M5Stack CoreS3 for CoreS3 and CoreS3-SE.
  4. Select the serial port and click Upload.

PlatformIO

Note

With PlatformIO, run python3 scripts/upload_auto.py to automatically detect the connected Core2 or CoreS3/CoreS3-SE and upload the matching firmware. Connect exactly one supported device. Regular pio run commands do not auto-detect the board; they use the selected environment.

Requires PlatformIO. Build or upload a specific board with its environment:

pio run -e m5stack-core2                         # build Core2
pio run -e m5stack-core2 -t upload               # upload to Core2
pio run -e m5stack-cores3                        # build CoreS3/CoreS3-SE
pio run -e m5stack-cores3 -t upload              # upload to CoreS3/CoreS3-SE
python3 scripts/upload_auto.py                   # detect board and upload
pio device monitor                               # serial log at 115200 baud

CoreS3-SE uses the same CoreS3 PlatformIO environment and is detected as a CoreS3-family device by the automatic uploader.

The platform is pinned to espressif32@6.12.0 (arduino-esp32 2.0.17). The firmware uses the Bluedroid BLE stack, and arduino-esp32 3.3.x ships NimBLE instead for the ESP32-S3, so the CoreS3 build fails there.

To rebuild the web installer images in docs/firmware, run the merged target. It combines the bootloader, partition table and app into one image that is flashed at 0x0:

pio run -e m5stack-core2 -t merged
pio run -e m5stack-cores3 -t merged

πŸ“· Camera compatibility

Camera Status
Blackmagic Pocket Cinema Camera 6K 🟒 Supported
Pocket Cinema Camera 6K G2 🟑 Not Tested
Pocket Cinema Camera 6K Pro 🟑 Not Tested
Pocket Cinema Camera 4K 🟑 Not Tested

Using the remote

Pairing

  1. On the camera, open the Bluetooth setup menu and switch on Bluetooth.

The button then reads ONLINE. The status bar at the bottom shows the connection state, and the Bluetooth icon in the header turns blue when connected.

Live readout and control

The main screen shows the camera's settings as they change. To adjust one, tap its box (it gets an orange border), then use the - / + buttons.

Parameter Readout Control with - / +
ISO Current value ISO 100 – ISO 25,600
Shutter Angle 11.2–360Β°
FPS Frame rate 5–120 fps
White balance Kelvin 2,500–10,000 K (50 K steps)
Tint Signed value βˆ’50 to +50 (1-step)
Iris f-number One lens stop per tap
Timecode Timecode or clip counter Tap to switch
Record STBY / REC / PLAY Record button
Camera battery Voltage (tap header to show) Read only
Remote battery Charge (tap header to show) Read only
Storage cards Type, remaining time (tap footer to show) Read only

Iris changes can only reach lenses the camera can drive.

Focus

Tap FOCUS on the main screen to open the focus page.

  • Slider: drag from NEAR to FAR to set focus directly. The current position shows as a percentage.
  • - / +: steps of exactly 1%, repeating while held. They work once the camera has reported its focus position; until then, move the slider once.
  • AF: triggers the camera's one-shot autofocus.

Focus changes only reach lenses the camera can drive.

Presets

Tap PRESETS on the main screen. The page has two slots, each with its own SAVE, LOAD and CLEAR button and a short summary of what it holds.

  • SAVE: stores ISO, shutter, FPS, white balance, tint and iris as they are on the camera.
  • LOAD: sends the stored values to the camera. The iris is stepped to the stored f-number.
  • CLEAR: needs two taps to clear.
  • BACK: returns to the main screen.

Presets live on the SD card, so they survive power-off.

SD card

Path Content
/presets/<date>_MagicPilot_Remote_Preset1.json, ..._Preset2.json One JSON file per saved preset, for example 2026-10-05_MagicPilot_Remote_Preset1.json

Without a card the remote still works, but saving and loading presets shows "No SD card".

FAQ

How do I control a Blackmagic Pocket Cinema Camera 6K remotely without a phone? Flash MagicPilot onto an M5Stack Core2, CoreS3, or CoreS3-SE and switch on Bluetooth on the camera. The remote connects directly over Bluetooth LE, so you don't need a phone, tablet, Wi-Fi network, or the Blackmagic Camera app.

Can MagicPilot pull focus on a BMPCC6K? Yes. The focus page has a NEAR β†’ FAR slider, βˆ’ / + buttons in 1% steps, and a one-shot autofocus (AF) button. It works with lenses the camera can drive electronically.

Which Blackmagic cameras are supported? The Blackmagic Pocket Cinema Camera 6K is tested. Other cameras that implement the Blackmagic Camera Control Bluetooth protocol, such as the BMPCC 6K G2, 6K Pro and 4K, may work but haven't been tested yet. See Camera compatibility.

What hardware do I need? An M5Stack Core2, CoreS3, or CoreS3-SE (ESP32 touchscreen modules) and optionally a microSD card for presets. See Hardware.

Is MagicPilot free? Yes. It is open-source firmware licensed under the LGPL-3.0.

Project layout

  • src/main.cpp: the firmware entry point; the BLE client, camera protocol and UI live in the headers next to it.
  • platformio.ini: board, framework and library settings.
  • scripts/upload_auto.py: detects the connected board and uploads the matching build.
  • scripts/merge_firmware.py: the merged PlatformIO target that writes the web installer images.
  • docs/firmware/: prebuilt firmware images and the ESP Web Tools manifest.
  • docs/install/: the browser installer page.

Disclaimer

⚠️ Use at your own risk. MagicPilot is provided "as is" without warranty. The developer is not responsible or liable for damage, malfunction, loss of footage, data loss, or any other loss or damage to cameras, lenses, recording media, accessories, equipment, or property resulting from the use of this software or firmware. Always verify settings, compatibility, and operation before using MagicPilot with valuable or professional equipment.

MagicPilot is an independent open-source project and is not affiliated with, endorsed by, or sponsored by Blackmagic Design Pty. Ltd. Blackmagic Design, Blackmagic Pocket Cinema Camera, BMPCC, and related names and trademarks are the property of Blackmagic Design Pty. Ltd.

About

✨ MagicPilot Remote β€” Open-source Bluetooth touchscreen remote for the Blackmagic Pocket Cinema Camera 6K (BMPCC6K). ESP32 firmware for M5Stack Core2 / CoreS3: focus, ISO, shutter, white balance, iris, record & presets.🎬

Topics

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages