So I finally got this working and wanted to share it here. I built an open source stream deck around one of those £17/$25 S3 screens, running EspDesktop. The buttons on the display change automatically depending on which app I've got open on the Mac, so it always shows what's relevant to whatever I'm doing at the time. Each app gets its own set of shortcuts, and there's a preset list you can tweak for all the common Mac apps, so you don't have to build every button from scratch. I took the core UI from EspControl and wrote a free Mac app on top of it that handles the connection side of things. Everything is open source and costs nothing to use, and the docs walk you thru getting set up with a simple web installer, which makes the first run painless. If anyone has ideas or feedback I'd like to hear them. I've allready got a few new features sitting in pull requests on the GitHub repo, so there's more coming. Thanks!
Finished my open source stream deck for $25
Nov 19, 2026
Last reply: 13 hours ago
5 Replies
This is exactly the kind of thing I've been wanting to put together for my own desk, so reading how you wired up the app detection side was really useful. I run most of my house through Home Assistant, so the first thing on my wishlist would be support for it. My dream setup would be one screen where a button jumps to Slack shortcuts while the Mac is active, but flipping over to another context lets the same buttons toggle lights, run automations or pull up a camera feed. Being able to blend Mac control and smart home entities on one page would mean I could retire the separate dashboard I currently keep open on a tablet. Do you think the Mac companion app you wrote could handle that, or would the entity side need to talk straight to Home Assistant? Either way I'm following the repo, and it's encouraging that there are already pull requests lined up. The web installer detail especially appeals to me, since flashing gadgets is usually the point where my enthusiasm runs out.
I run a PC rather than a Mac, so the companion app side is what gives me pause. My own desk project is a cheap ESP32 board I flashed through ESPHome, and it talks to Home Assistant on the network, which means nothing has to stay running on the desktop itself. I'm curious why you chose to write a separate Mac app to handle the connection rather than keeping more of it on the device. Was the app detection simply easier to do from the Mac side?
Not a criticism by the way, the way you describe the buttons following whatever is open sounds genuinely handy. My own layout never changes, so depending on the day half my buttons just sit there doing nothing.
The other thing that stood out to me is the web installer in the docs. I have abandoned more than one microcontroller project at the flashing stage because I could not remember which board revision I had bought, so making the first run painless matters more than people admit.
Would you ever consider a Windows build of the companion side? I would happily be a tester if it ever lands in the repo.
That point about keeping everything on the device matches how my own setup behaves. My little ESPHome board just talks to Home Assistant over the network, and I like that nothing has to stay running on the computer for it to work. So the way you describe it, with the Mac side handling the connection, does feel like a different arrangement to what I'm used to. Does the whole thing stop responding if the app isn't running? Not a criticism, just genuinely curious how much depends on it.
Curious what's sitting in those pull requests you mentioned. The button switching per app is the bit that sells me on it, but I'm wondering if any of the incoming stuff touches the preset side, like letting people share their own button layouts for apps that aren't covered yet. I'd happily chip in with mine once I've got one running. Feels like that list could grow fast if it's crowd-sourced.
The way you put it, the buttons are just drawn on the screen instead of being little keys you can actually feel under your fingers. That part confuses me a bit, since all the gadget stuff I've poked at has real switches you can find without looking. Do you find yourself glancing down at the screen every time to hit the right spot, or does it become easy to tap them blind after a while?
Join the Discussion
Have something to add? Share your thoughts — no account required.
Didn't find your answer?
Ask the community — no account required