Skip to content

Your first page ​

A screen starts empty. You fill it in Tessera, by dragging the things you want onto its page.

Put tiles on the screen ​

  1. Click your screen in the Tessera sidebar. The Layout tab shows its pages, as the screen will show them.
  2. In the Library on the right, search by name, device or room, or use the filters. The built-in Clock is at the top.
  3. Drag an entity onto a page. Or click an empty cell, then click an entity.
  4. Click a tile to change it: its name, what a tap does (On tap), its Size and its Display.
  5. Click Save & send.

You see "Saved · sent to screen", and within seconds the tiles are on the screen. To change them later, do the same again. You never reinstall a screen for its tiles.

The editor with a screen open: its pages side by side, and the library of the home under them

Good to know ​

  • The preview is real. It shows the real values from Home Assistant, drawn by the same code as the screen.
  • Sizes. A tile is Normal (one cell), Double-width, 1 × 2, 2 × 2 or Full page. You can also drag a tile's edge. Tiles has the details.
  • Pages. A screen holds up to eight pages and 64 tiles. Add page in the toolbar above the pages adds one. Pages explains how people get from one page to the next.
  • A tile says unavailable? The entity was renamed or removed in Home Assistant. Choose it again.

What a tap does ​

TileTap
Light, switch, fanTurns it on or off
Climate, vacuum, coverOpens its control card
Alarm panelOpens its card, with a keypad when a code is needed
SelectOpens a list of its options
Scene, script, buttonRuns or presses it
Media playerOpens the media card with keys and volume
CameraShows the picture full screen
Sensor, person, binary sensorOpens its history: 1 hour, 24 hours or 1 week
Go to pageOpens that page

Hold any tile to open its full card: for a light its brightness and colour, for a fan its speed. You can change what a tap does under On tap; Perform action runs any action Home Assistant offers for that entity.

Does your screen work? ​

A day after a new screen first comes online, its page in Tessera asks once: Does your screen work as you expect? Answering is optional and helps improve support for your board. What is shared? on the card lists exactly what is sent. You can change or delete your answer later under Screen settings → Feedback.

Free and open source, GNU AGPL v3. Built with ESPHome. Not affiliated with Home Assistant.
Looking for e-ink? See Tesserae (tesserae.ink), a separate project.