tessera-deck
Health Pass
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Community trust — 14 GitHub stars
Code Pass
- Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Pass
- Permissions — No dangerous permissions requested
No AI report is available for this listing yet.
Tessera: a DIY Stream Deck alternative on the GUITION 7-inch ESP32-P4 touchscreen. Open-source macro deck with widgets, live PC gauges, an AI agents screen and a Windows host. Home Assistant via ESPHome in beta
A DIY Stream Deck: turn a 7-inch ESP32-P4 touchscreen into an open-source macro deck for Windows.
Tessera is a macro deck for Windows that you build from one 7-inch touchscreen board. It has 18 touch keys for apps, hotkeys and macros, plus widgets, live PC gauges, an AI agents screen and a sound mixer. You set it up in a drag-and-drop editor. It needs no soldering, and a printed console holds it on the desk.
[!IMPORTANT]
What you need: the GUITION 7-inch ESP32-P4 display dev board (model JC1060P470C, 1024 × 600, about $35 to $42), a USB cable and a Windows 10/11 PC. Other boards need porting, and the host runs on Windows only.
Why Tessera
- When Claude Code asks for permission, the question shows on the panel and you touch Allow or Deny to answer. The agents screen also shows what Claude Code, Codex and ZCode are doing, since when, and in which project.
- Everything stays on your PC, with no account, cloud service or subscription. The panel talks to a small Windows host over USB.
- Firmware, host and editor are open source (MIT), with over 600 automated tests, a documented serial protocol and a plugin API.
- It needs one cheap board, which you flash from the editor without a toolchain. See Build it or buy one?
| Widgets on wide keys | Answer Claude Code from the panel |
|---|---|
![]() |
![]() |
| Sound mixer | Live status page |
|---|---|
![]() |
![]() |
The animation and the panel images are drawn by the firmware UI itself in a native build (tools/make_demo_gif.py). The agents and mixer screens show sample data. The editor scenes are screenshots of the real editor.
Quick start
The release zip has the host and the panel firmware, so you need no build tools.
- Unpack
tessera-host-<version>.zipfrom the latest release and double-clickTessera.cmd. The first start sets everything up, installs Python if it is missing and puts a shortcut on the Desktop. The editor opens. - Connect the panel with USB. The Getting started checklist in the editor ticks off Host running and Panel connected by itself.
- Open Panel → Panel firmware and updates … and choose the included firmware. A new board needs Full install (new or blank panel), then Install anyway. Press Install. More in Install.
- Click an action in the list on the right. It becomes a new key. Fill it in on the Look and Actions tabs. Changes are saved automatically.
- Press the key on the panel. The editor says "It works" and lights up the key.
Nothing runs in the editor. Keys run only when you press them on the panel.
Build it or buy one?
| Tessera | Stream Deck MK.2 | Stream Deck XL | |
|---|---|---|---|
| Price | the board, about $35–42 | $149.99 | $249.99 |
| Keys | 18 per page on a 7-inch touchscreen, keys up to three slots wide | 15 physical keys | 32 physical keys |
| Live widgets, mixer, PC status, AI agents | built in | through plugins | through plugins |
| Source code | MIT | closed | closed |
You also need a USB-C cable, and a stand helps: print the desk console or use a small tablet stand. Tessera is glass, so you give up the feel of a real key. Board prices are AliExpress street prices and the Stream Deck prices are US list prices, both from November 2026, so they may have changed.
What it does
- Four screens on the panel: your keys, the AI agents, a sound mixer and the PC's status. A side bar you arrange yourself switches between them.
- Wide keys and widgets: a key can cover two or three slots and show the clock, the date, CPU, GPU, memory, network, volume, the AI agents, your next meeting, the music that plays or a timer.
- Icons: real app icons from Windows, 1,895 Lucide icons or your own images.
- Live gauges: CPU, GPU, VRAM, RAM, disk, network, temperatures, power, fan and FPS.
- Profiles that follow the program in front, with a lock key to stay put.
- Over 120 ready-made actions and 10 profile templates for Windows, VS Code, browsers, meetings, media, Codex, Claude Code and ZCode.
- Macros: multi-step actions, long press, double press, hold to confirm, toggle keys, counters and timers.
- Scripts and AI tools: drive keys from your own scripts with the local API or
deckctl, or add plugins (one for Home Assistant through the PC and one for OBS Studio are included) and Claude Code hooks. - Clock screen, offline layout, auto-dim and a firmware installer.
- Home Assistant over Wi-Fi (beta, not in the release yet): the panel joins your Wi-Fi and shows up in Home Assistant through the ESPHome integration. See below.
See all features.
Home Assistant (beta)
This is not in the release yet. On the esphome-beta branch, the panel can also join your Wi-Fi and show up in Home Assistant through the ESPHome integration. USB to Windows keeps working as before, so one panel does both.
- Keys run Home Assistant actions straight from the panel, also when the PC is off: toggle a light, start a scene or call any other action.
- Keys can follow an entity: a key can change color while a light is on, or show a value such as 21.5 °C as its label.
- Every key is also an event (press, hold, double press) for your automations, and there are entities for the backlight, the page, the Wi-Fi signal and whether the PC is connected.
- The connection is encrypted. Home Assistant discovers the panel over mDNS and asks for its key. Wi-Fi and Home Assistant stay off until you turn them on in Panel → Wi-Fi and Home Assistant.
The beta runs on one panel and works with aioesphomeapi, the library Home Assistant uses to talk to ESPHome devices, but it has not been tried in a full Home Assistant install yet. To try it:
- Check out the branch and start Tessera.
- Install the panel firmware from the branch with Full install. It needs the host from the same branch.
- Open Panel → Wi-Fi and Home Assistant.
Reports in issues are welcome. The design explains how it works.
A desk console to print
| From your chair | The back | The tile mark |
|---|---|---|
![]() |
![]() |
![]() |
The panel drops into a printed console that reclines it 45° and hides the cables, or into a lighter open dock. Both print without supports. hardware/ has the STL and STEP files, the CAD models, the print settings and how the panel is fastened.
The pictures are rendered in Blender from the CAD model, with the panel's real screen. make_render.py builds the scene, saves it as tessera-console.blend and renders it in 4K. See Render the console.
How it works
flowchart LR
subgraph PC["Windows PC"]
Editor["Editor (WebView2)"] -->|profiles.json| Host
Tray["Tray app"] --> Host
CLI["deckctl / hooks"] -->|loopback API| Host
Sensors["Windows counters<br/>Libre Hardware Monitor"] --> Host
Host["tesserad — USB host<br/>actions, profiles, sensors"]
end
Host <-->|"USB Serial/JTAG<br/>JSON + line protocol"| Panel["ESP32-P4 panel<br/>LVGL UI, touch"]
The host is the only owner of the USB port. It sends the page to the panel, receives key presses and runs the actions on the PC. The editor and the control API listen on 127.0.0.1 only.
Documentation
| Features | Everything Tessera does, by panel screen and editor area |
| Install | Hardware, start options, flashing from source |
| Desk console | A printable stand for the panel: STL, STEP, the CAD models and a Blender scene for renders |
| Using Tessera | Actions, labels, gauges, sensors, brightness, scripts, troubleshooting |
| Plugins | Write your own integration |
| Serial protocol | What the host and the panel say to each other |
| Development | Project layout, tests and tools |
| Contributing | Reporting bugs, sending changes, porting to another board |
| Security | Imported profiles, tokens and network use |
| Roadmap | What is not done yet |
Credits and license
Built with ESP-IDF, LVGL, the Espressif board support
package, cJSON (MIT), Lucide icons (ISC) and DejaVu fonts.
Optional sensors come from Libre Hardware Monitor
(MPL-2.0). Tessera is inspired by Stream Deck and OpenDeck and is not
affiliated with Elgato or Corsair; Stream Deck is a trademark of its owner.
Tessera is released under the MIT License. Third-party components keep their own licenses (seevendor/lucide/LICENSE and the component directories).
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found






