A simple, customizable Home Assistant dashboard that can be used as a "backend" for wall-mounted displays like the Inkplate 10. The server automatically captures screenshots of the dashboard at configured interval, and is an alternative to other similar software like sibbl/hass-lovelace-kindle-screensaver, and at the same time an alternative to dealing with kiosk-mode, card-mod and layout-card plugins for Home Assistant.
# Build with default user (1000:1000)
$ docker build --tag inkplate-dashboard:latest .
# Or build with your user ID to avoid permission issues
$ docker build \
--build-arg UID=$(id -u) \
--build-arg GID=$(id -g) \
--tag inkplate-dashboard:0.6.0 \
--tag inkplate-dashboard:latest \
.
# Set up data directory
$ cp -R dev/sample_data data/
$ echo -e "homeassistant_url: \nhomeassistant_token:" > data/secrets.yaml
# Run container
$ docker run \
-p 9090:8000 \
-v $(pwd)/data:/app/data \
--name inkplate-dashboard \
--rm \
inkplate-dashboardInkplate 10 is a powerful, energy-efficient, Wi-Fi enabled ESP32 board with a recycled 9.7 inch e-paper display. It’s open hardware supported by an open-source software library, and it’s easy to program, regardless of whether you prefer MicroPython or the Arduino IDE.
The Inkplate MCU must be programmed to periodically download and display the captured dashboard image. See samples in the inkplate/ folder for how to do this, either by using the Arduino-based sketch or the config file for using the Inkplate with ESPHome. Another excellent alternative, is to use the PlatformIO-based solution lanrat/homeplate.
The server itself is configured using the environment variables specified below (see server/models/server.py::ServerConfig for defaults and more options).
# .env
DATA_PATH=data
HOST=127.0.0.1
PORT=8089
LOG_LEVEL=info
LOG_FILE=current.log
LOG_JSON=falseOther runtime config, including the dashboard itself, is defined in a YAML file called configuration.yaml placed at the root of the application data path (DATA_PATH).
# configuration.yml
homeassistant:
url: !secret homeassistant_url
token: !secret homeassistant_token
timezone: Europe/Oslo
locale:
default: nb
fallback: en
dashboard:
components: !include components.yaml
capture:
timeout: 10000
width: 1200
height: 825# secrets.yaml
homeassistant_url: http://ha.lan
homeassistant_token:# components.yaml
- type: vertical-stack
style: gap-12
components:
- type: weather-forecast
entity: weather.oslo_hourly
show:
state: true
forecast: true
dateFormat: HH:mm
- type: weather-graph
entity: weather.oslo_hourly
attribute: temperature
show:
labels: true
dateFormat: HH
- type: sun
- type: weather-forecast
entity: weather.oslo
show:
state: false
# - type: vertical-stack
# style: gap-12
# components:
# ...- type: horizontal-stack
components:
- type: vertical-stack
style: gap-2
components:
- type: ...- type: ...
title: ...
icon: ...- type: tile
entity: sun.sun
title: null (default, uses friendly name or id) | false
icon: flag # defaults to lightning bolt- type: entities
display: list (default) | grid | grouped
columns: 2 (default, when using `grid`)
entities:
- sensor.power_consumption
- entity: sensor.electricity_price
precision: 2
secondaryInfo: last-changed
- entity: sensor.monthly_electricity_cost
precision: 0
unit: kr
name: Monthly cost
icon: cash
secondaryInfo: sensor.electricity_price
- entity: sun.sun
secondaryInfo: attribute.next_dawn
# ...
groups: # optional
- id: temp
title: Temperatures
icon: thermometer
entities:
- entity: climate.heater
group: temp
attribute: temperature
unit: °C
- entity: sensor.temp2
group: temp- type: graph
entity: sensor.download_speed
unit: null (default, uses `unit_of_measurement`)
xAxis: false | true (default) | { min, max }
yAxis: false | true (default) | { min, max }
targetResolution: null (default) | <number>
labels: [true | false | 'min' + 'max' (default)]
annotations: [average, <number:yval> ...] (default)- type: sun
entity: sun.sun # optional, default- type: weather-forecast
entity: weather.home
state: true (default) | false
forecast: true | 'daily' | 'hourly' (default) | false- type: weather-graph
entity: weather.home
attribute: temperature (default)
unit: null (default, uses `{attribute}_unit`)
includeForecast: true (default) | false
includeHistory: true (default) | false
forecastType: daily | hourly (default) | twice_daily
annotations: [now, startOfDay, endOfDay] (default)- type: calendar
limit: 10 (default) # Limit events
calendars: # Optional list of calendars to include (defaults to all calendar entities)
- entity: calendar.work
icon: flag # defaults to card icon
showDescription: true (default) | false
showCalendarName: true (default) | false
filterBegun: false (default) | true # Filter events that have begun- type: todo-list
entity: todo.shopping- type: rss
url: https://www.nrk.no/toppsaker.rss
limit: 10 (default)- type: transmission
entity: sensor.transmission_total_torrents # optional, default
limit: 15 (default)
dateFormat: HH:mm (default)
lineClamp: 3 (default)
showCategories: true (default)
showDescription: true (default)- type: petcare
petEntity: binary_sensor.cat
hubEntity: binary_sensor.hub
flapBatteryEntity: sensor.hub_battery_level
flapConnectivityEntity: binary_sensor.hub_connectivity- type: markdown
entity: sensor.markdown
attribute: description
# or
content: |
# Foo
Bar# Environment
$ cat > .env << 'EOF'
DEBUG=true
STATIC_PATH=frontend/dist
VITE_SERVER_URL=http://localhost:8089
EOF# Setup
$ uv sync --extra dev # Install dependencies including dev tools
$ uv run playwright install chromium # Download browsers
$ uv run playwright install-deps # Install browser dependencies
# Start development server (uvicorn)
$ uv run python -m server [--data-path <path>]
# Linting and formatting
$ uv run black server/
# Version management
$ uv run bump-my-version show-bump # Show current version and next versions
$ uv run bump-my-version bump patch # Bump patch version (0.5.0 -> 0.5.1)
$ uv run bump-my-version bump minor # Bump minor version (0.5.0 -> 0.6.0)
$ git push --follow-tags # Push changes and tags (triggers CI/CD)$ cd frontend/
$ npm install
$ npm run dev
$ npm run build$ docker-compose -f dev/homeassistant/docker-compose.yml upUsername/password: foobar/foobar.