tessera-deck

skill
Security Audit
Pass
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.

SUMMARY

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

README.md

Tessera

A DIY Stream Deck: turn a 7-inch ESP32-P4 touchscreen into an open-source macro deck for Windows.

Windows ESP-IDF 6.1 LVGL 9.6 Python 3.11+ Latest release CI License: MIT

The Tessera panel in its printed desk console, close up on a desk, with the main page of app keys on the screen and a monitor out of focus behind it

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.

Tessera, a DIY Stream Deck on an ESP32-P4 touchscreen: app keys, folders, window and meeting keys, pages that follow the app in front, widgets, answering Claude Code, the sound mixer, live PC gauges, the idle clock and the editor

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
Widgets on wide keys: clock, date, volume, processor, graphics card, memory, network and AI agents The agents screen: Claude Code asks for permission, with Deny and Allow
Sound mixer Live status page
The mixer screen: faders for the speakers, three programs and the microphone Status page with live gauges

The editor: the rail, the keys with their page tabs, the selected key's settings and the action list

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.

  1. Unpack tessera-host-<version>.zip from the latest release and double-click Tessera.cmd. The first start sets everything up, installs Python if it is missing and puts a shortcut on the Desktop. The editor opens.
  2. Connect the panel with USB. The Getting started checklist in the editor ticks off Host running and Panel connected by itself.
  3. 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.
  4. 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.
  5. 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:

  1. Check out the branch and start Tessera.
  2. Install the panel firmware from the branch with Full install. It needs the host from the same branch.
  3. Open Panel → Wi-Fi and Home Assistant.

Reports in issues are welcome. The design explains how it works.

A desk console to print

The printed desk console in dark grey PLA with the panel in place, reclined 45 degrees, the main page on the screen and a USB-C cable out of the back

From your chair The back The tile mark
The console seen from the front at eye height, with the panel's main page The back of the console: air openings, two screwdriver holes and the cable arch Close-up of the tile mark in the chin, with the printed layer lines

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 (see
vendor/lucide/LICENSE and the component directories).

Reviews (0)

No results found