ESP32-DaVinci

Touch control deck for DaVinci Resolve on macOS. Runs on an Elecrow CrowPanel ESP32-S3 7″ (800×480): cut, transport, tools, color nodes, markers, page switching.

The panel talks to a Mac bridge over USB serial. The bridge injects Resolve keyboard shortcuts (Quartz key events).

Firmware	0.5.1
Hardware	CrowPanel ESP32-S3 HMI 7″, 800×480
Host	macOS + DaVinci Resolve (Free or Studio)

How it works

CrowPanel (LVGL UI)
    │  USB–UART serial @ 115200
    ▼
Mac bridge (menu bar app or CLI)
    │  Quartz key events (Accessibility)
    ▼
DaVinci Resolve

The CrowPanel USB port is UART only (not USB HID). GPIO 19/20 are used for touch I2C, so the board cannot enumerate as a keyboard. The Mac bridge is required.

Quick start

1. Firmware (Arduino IDE)

1. Open the esp32-davinci sketch folder.
2. Board: ESP32S3 Dev Module — USB CDC Disabled, Flash 4MB, PSRAM OPI, Partition Huge APP.
3. Libraries: LovyanGFX ≥ 1.2.9, lvgl 8.3.11.
4. Copy lv_conf.h to ~/Documents/Arduino/libraries/lv_conf.h (next to the lvgl folder). Enable LV_USE_TABVIEW and Montserrat 14/16/20/22/28 as in that file.
5. Flash with the bridge and Serial Monitor closed. Prefer Upload Speed 115200; hold BOOT during upload if the link drops.

Details: docs/hardware.md.

2. Mac bridge (recommended: menu bar app)

cd mac-app
pip3 install -r requirements.txt
python3 app.py
# or package: chmod +x build.sh && ./build.sh
# then: open dist/ESP32-DaVinci-Bridge.app

• Start/stop from the window or menu bar (DV / DV●)
• Closing the window hides to the menu bar (Quit only from the menu)
• Grant Accessibility to the app (or to Terminal/Python if running from source)
• Keep Resolve open; keyboard preset: DaVinci Resolve (default)

Optional CLI:

cd bridge
pip3 install -r requirements.txt
python3 resolve_bridge.py -p /dev/cu.usbserial-XXXX

Details: mac-app/README.md, docs/bridge-and-status.md.

3. Use the deck

• Tabs: CUT · PLAY · TOOLS · COL · PAGE
• All buttons send shortcuts immediately (no SAFE/ARMED)

Repository layout

Path	Role
esp32-davinci.ino, ui_deck.*, serial_proto.*, …	Firmware
bridge/	Serial host + Quartz shortcut injection
mac-app/	Desktop / menu bar controller + .app build
docs/	Project documentation (English)

Documentation

Doc	Contents
docs/architecture.md	System design
docs/hardware.md	Board, pins, Arduino tools
docs/protocol.md	Serial CMD / ACK / STAT
docs/ui.md	Touch UI layout
docs/actions.md	Action IDs and Mac shortcuts
docs/bridge-and-status.md	Mac bridge + Accessibility
mac-app/README.md	Menu bar app / DMG
bridge/README.md	CLI bridge

License

See repository license file if present. DaVinci Resolve and Blackmagic Design are trademarks of their respective owners.