Work P1 Shipping
Stream32
An open-source stream deck you flash onto an off-the-shelf ESP32 touch display.
- GitHub stars
- 100
- release downloads
- 3,700+
- releases
- 42
- desktop platforms
- 3
Why it exists
Commercial stream decks are closed: fixed hardware, vendor software, and no real way to repair or adapt them. Stream32 goes the other way. You buy an off-the-shelf ESP32 touch display, flash it from the desktop app, and lay out pages of keys that launch apps, press hotkeys and run multi-step actions. Everything needed to reproduce and modify it lives in the repo.
How it works
The project has two halves, and they are versioned independently.
The desktop app is built on Electron, with installers for Windows, macOS and Linux. It is where you design decks. Each device can hold up to 16 named profiles, and the app can switch between them as the focused application changes.
The firmware is built per board with a pinned ESP-IDF version. The app downloads a small catalog, then only the image for the board you picked. The catalog publishes each image’s size and SHA-256 hash, and verified images are cached so a board can be reflashed offline.
Because board profiles ship separately from the app, supporting a new display does not need a desktop release.
Things I’m glad I built in
- A plugin system for actions, so new key behaviours can be installed and published without changing the app.
- Deck import and export with schema migration. Decks saved under any earlier schema version still import.
- Bitfocus Companion support. A board can register as a Companion Satellite surface, which puts it in front of broadcast and AV gear such as video switchers and OBS.
- CI that packages every desktop pull request on all three operating systems, with a separate workflow that builds and publishes firmware.
Where it stands
Stream32 is usable today on three off-the-shelf displays, from a 2.8-inch “Cheap Yellow Display” to a 10.1-inch ESP32-P4 panel. Custom open-hardware designs (schematics, a BOM and enclosures) are still on the roadmap. The project is sponsored by PCBWay and has picked up outside contributors.