What Tessera is
Cato Rendal built Tessera, an open-source macro deck on a 7-inch touchscreen, and wrote it up on Hackster.io. It is MIT licensed and runs with Windows 10 and 11. The repository describes it as turning the 1024 × 600 touchscreen of the GUITION 7-inch ESP32-P4 display board into an 18-key control surface. You can use it to launch apps, fire hotkeys, drive Codex and Claude Code, watch live system gauges and run multi-step macros.
Think of it as a Stream Deck alternative with a glass face. The project's own pitch is to trade physical keys for flexibility.
Hardware and firmware
- Board: a GUITION JC1060P470C with an ESP32-P4, a JD9165 display on MIPI-DSI and a GT911 touch controller.
- Display: a 7-inch, 1024 x 600 capacitive touchscreen.
- Firmware: ESP-IDF 6.1 and LVGL 9.6. Hackaday.io's page for the project gives only "LVGL 9".
- Single-board design: the repository says it is made for one board. Porting Tessera to another ESP32-P4 display is listed as open work.
If you want the printable console, Hackster.io says to buy the version in the factory housing, because the console is drawn for that housing.
The architecture matters more than the screen
The panel is deliberately simple. The panel only draws the screen and reports touches. A small Python program on the PC, the host, owns the USB port and runs the actions, and the two talk over a documented line protocol. The project documentation describes the link as USB Serial/JTAG carrying JSON and a line protocol.
This has some practical consequences:
- Profiles and actions live on your PC, not on the panel.
- The project's documentation says keys run only when you press them on the panel. Nothing runs in the editor.
- The Hackaday.io page says the panel keeps images in a PSRAM cache after they are sent as RGBA data with a CRC check.
- The same UI code also builds on the PC, so screens can be tested without flashing.
The developer's DEV Community write-up adds a caveat. The native build does not exercise the display driver, the touch controller or PSRAM limits. Those parts still need the real board. Some of the project's images come from that native build, and the repository says the agents and mixer screens show sample data.
Features
The project reports these features:
- Over 120 ready-made actions, 10 profile templates and 1,895 icons.
- Four screens: keys, AI agents, a sound mixer and PC status.
- Wide widget keys, including clock, CPU, GPU, memory, network and now playing.
- Profiles that follow the foreground app.
- Long-press and double-press actions, toggle keys, counters and timers.
- Live gauges for CPU, GPU, VRAM, RAM, disk, network, temperatures, power, fan and FPS.
The AI-agent angle is narrow. Hackaday.io says Claude Code's permission questions can be answered with Allow or Deny on the panel. The repository adds that the agents screen also shows what Claude Code, Codex and ZCode are doing. Don't read that as support for every AI assistant.
Setup on Windows
You need the board, a USB-C data cable and a Windows 10 or 11 PC. The documented steps are:
- Download the host ZIP and SHA256SUMS from the latest GitHub release. The Hackaday.io page names tessera-host-v0.9.0.zip as the current one.
- Unpack it and double-click
Tessera.cmd. The first start looks for Python 3.11 or newer, or installs Python 3.12 with winget. It also installs packages, puts a shortcut on the Desktop and starts the tray icon and editor. - Connect the board over USB-C.
- In the editor, open Panel → Panel firmware and updates …, choose the included package and press Install.
- A new or blank board does not answer. The dialog picks Full install (new or blank panel) by itself, and you tick Install anyway first.
- Add actions in the editor. Changes save automatically.
One warning is worth repeating. Tessera is not code-signed, so Windows SmartScreen may warn you. The repository suggests comparing the ZIP's SHA-256 against the published checksums first. Also note that the first-run script can install Python for your user account via winget, so it makes changes to your PC.
Network and security posture
In the release, the panel has no network of its own, and the editor and control API listen on 127.0.0.1 only. The repository adds that the host goes online only for features you turn on, such as the update check or the weather.
That is a sensible design. Loopback-only binding doesn't make the host risk-free, though. Anything running locally on your PC can still reach a loopback service. The project has a security document covering imported profiles, tokens and network use. If you import someone else's profiles, treat them like scripts.
A Home Assistant mode over Wi-Fi is on a beta branch. The repository says it is not in the release yet and has not been tried in a full Home Assistant install.
Cost and trade-offs
The project's comparison table puts the board at about $35 to $42. It lists Stream Deck MK.2 at $149.99 and the XL at $249.99. The repository says the board prices are AliExpress street prices and the Stream Deck prices are US list prices, both from November 2026, and that they may have changed. These are the author's figures. I haven't verified them against current listings, and they leave out the cost of a stand or printed console.
The trade-offs are clear:
- You give up tactile keys. The author says so directly: glass instead of real keys.
- It is one board and one OS. The host is Windows only.
- It is a young project. Hackaday.io says version 0.9.0 runs daily on the author's desk. The testing claims, including over 650 host tests on that page, are the author's own, and the repository's figure is "over 600". The repository also has a page on what was verified on a real panel and what nobody has tried yet.
Planned items such as key-down and key-up actions for push-to-talk and Stream Deck profile import are roadmap items, not features you can use today.
The printable console
The author also drew a printable console and an open dock. Hackaday.io says the console reclines the panel 45° and hides the cables. It says the simpler dock leans it back 30°. Both are described as printing without supports. The repository has STL and STEP files, plus CAD models and print settings. Rendal also drew a printable console and an open dock, with STL, STEP, FreeCAD and Blender files in the repo. Hackaday.io estimates about 180 g of PLA for the console. The renders are from CAD, not a photographed print.
Who should care
Tessera suits tinkerers who want a hackable macro surface and don't mind flashing a board. It also suits developers who want a documented protocol and plugin API to script against. It is not a drop-in replacement for a hardware macro keyboard, and it is not for anyone who needs polished, signed software today. It is also a good example of keeping the embedded side thin and putting the logic in a PC host you can read and change.
References
- Tessera: a touchscreen macro deck on a 7-inch ESP32-P4 - Adafruit Adafruit · 2026-11-16T17:19:14+00:00
- GitHub - catorendal-a11y/tessera-deck: Tessera: a touchscreen macro deck for the ESP32-P4 with live gauges, real app icons and a Stream Deck-style Windows host · GitHub github.com
- Tessera: a touchscreen macro deck on a 7-inch ESP32-P4 - Hackster.io hackster.io