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
A 10.1-inch touch display in a blue printed stand, showing a Stream32 deck of 40 colour-coded keys.

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.

J1 Connector

Open a channel

I'm always open to discussing new opportunities, interesting projects, or just talking tech.

3-pin header · message