[!IMPORTANT]
LOOKING FOR FUNDING
I have a day job that pays the bills, and it comes first. Tessera keeps getting bigger, and I simply don't have the time it needs. To keep it alive, I need funding: so I can give it the time it deserves, or hire someone to help. Help now with a donation, or mail me an offer or an idea.
Donate now · Mail an offer or idea
Max, maker of Tessera
Thank you! I work on this project with a lot of love, and every bit of support helps. I truly love the Home Assistant community.
I lead Tessera's development and maintenance, with contributions from the community. Your support gives me more time to build, review and test improvements. A small monthly contribution or a one-time coffee is welcome.
or buy me a coffee once
A touch screen for every room that you lay out yourself, and manage from Home Assistant. Incredibly easy to set up and to use.
Why. Your phone is in the other room and a tablet on the wall is expensive. A small ESP32 touch
panel costs a fraction of that, sits on a table or in a wall box, and is always at hand for the
lights, the heating or the vacuum.
What. Firmware for affordable panels, five of them today, from the 2.8-inch CYD to the 10.1-inch Guition, with
tiles over up to eight pages, or more on the boards with the memory for them, as many per page as the glass holds: lights, climate, humidifiers, blinds and curtains, the vacuum, media, the weather,
history graphs, the energy of your house live, clocks and timers, your alarm with its keypad, and your cameras and a map of where everyone is on every screen with room for pictures. A tile can take the whole page, one big switch you push without
looking, and a tile can go to another page. An automation can put an alert on every screen when someone rings
the bell, and a screen with room for pictures shows who is there with the doorbell camera's picture. A tap can run any
action Home Assistant has for a tile, and Dark mode suits a screen beside the bed.
How. Tessera Screen Manager is an app inside Home Assistant. It flashes a new screen over USB, updates
it over Wi-Fi and sends it your tiles. Changing a screen is pick, drag and Save & send:
no reflash, no YAML to write, no blueprint, MQTT or token. Brightness, night hours and Dark mode can
also be changed on the screen or by an automation, and your own YAML for one screen survives every update.
Install it · The manual · Pages · Screen settings · Troubleshooting · What's new
The manual is on the Tessera website: from the quick start to every tile, every screen setting, every supported screen and troubleshooting, with search. Anyone with a GitHub account can improve a page with Edit this page. This README is the overview; the files under docs/ are the reference for contributors.
Requests, questions and bugs
GitHub Issues are for bugs only. Feature requests, improvements and new board requests posted on GitHub will not be reviewed. Submit and discuss them on the Tessera wishlist. Questions and general discussions are handled in Community, not GitHub Discussions.
- Features and improvements: search the wishlist. Upvote an existing wish or add your own.
- New ESP boards and displays: use the New boards category. Include the exact model, a product link and whether you can test it. Votes show how many people would use it and help set priorities. They do not guarantee support or a release date.
- Questions and examples: post in Community, where the earlier GitHub conversations and replies have moved.
- Bugs: use GitHub Issues for something that is broken in existing functionality. Include reproducible steps and version information.
- Code changes: open a pull request and link the bug or website wish it implements.
Sign in on the website with GitHub to vote, post or reply. Search before posting so the conversation and votes stay together.
In real life
A Guition in the living room, 37 seconds in one take: tapping tiles, swiping through the pages,
opening cards and a history graph, while the lamp behind it goes from purple to orange.
https://github.com/user-attachments/assets/f9f6a933-d388-4c8b-9c9a-011dfa37617b
Print a stand for your screen
A screen looks best on a stand that was made for it. These are free to download and print on MakerWorld, each with a
ready Bambu Studio print profile and no supports needed.
- Home Assistant tablet base for the Seeed reTerminal D1001 (8 inch): a
round base with a dock, tilted 30 degrees. Two printed rails hold the screen by its VESA holes, with four M4 x 8 mm
screws. The ESP32-P4 inside plays your cameras live and talks to Assist.
- Wedge stand for the Guition 4" ESP32-S3-4848S040: a calm wedge that
holds the square screen at a comfortable angle. Take the small back plate off the screen first (two tiny screws on
its back), then push it in.
- Upright stand for the same Guition 4": the first Tessera stand, with a
small heart in its speaker grille. Push the screen in, no screws.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
