Home Assistant Dashboard on eInk Displays

A simple Python server to display a basic HTML page optimized for eInk displays.

I wrote more about it here.

Prerequisites

• Docker
• Docker Compose (V2)
• Python 3.9+ and uv (for local development)

Setup

1. Clone or download this repository
2. Provide your configuration (Home Assistant IP, port, token, and the sensor names you want to use) as environment variables. See .env.example for the full list of variables.
   • Docker / production: set these as environment variables wherever you run docker compose (the compose file passes them through to the container).
   • Local development: copy .env.example to .env, fill it in, and run make run — only make run loads .env.

Sensor integrations used:

• For the weather I used Met.no
• For the ETA to work I used Waze
• The other sensors are custom helpers set up in HA that you can customize by reading the code

Usage

Docker (recommended)

make docker-up       # Build and start the container
make docker-down     # Stop the container

Local Development

make setup           # Install dependencies
make run             # Start Flask dev server on 0.0.0.0:6123 (loads .env)

Tests & Linting

make test            # Run the test suite
make lint            # Check code style
make format          # Auto-fix lint issues and format code