e-Paper HA Dashboard

Portrait dashboard for Waveshare 7.5" V2 e-Paper (800x480) driven by Home Assistant. It shows outdoor weather, intraday + multiday forecast, indoor room temperature/humidity, and a daily quote.

Preview

Quick Start

1. Install dependencies.

sudo apt install python3-pil python3-numpy python3-rpi.gpio python3-spidev

2. Clone Waveshare driver library.

git clone https://github.com/waveshare/e-Paper ~/src/e-Paper

3. Prepare local config files.

cp secrets.json.example secrets.json
cp config.json.example config.json

4. Edit credentials/entities.

nano secrets.json
nano config.json

5. Test with PNG preview.

python3 ha_epaper_dashboard.py --simulate --output preview.png

6. Run on e-Paper.

python3 ha_epaper_dashboard.py --mode clock-daemon \
  --epd-lib-path ~/src/e-Paper/RaspberryPi_JetsonNano/python/lib

Documentation

• Configuration reference: docs/CONFIGURATION.md
• CLI modes and runtime behavior: docs/USAGE.md
• systemd service setup: docs/SYSTEMD.md
• Localization and translations: docs/I18N.md
• Icon assets naming/path rules: assets/icons/README.md

Available locales: en, it, es, fr, de, pt

Notes

• secrets.json contains your HA token and must stay private.
• show_clock: false disables clock drawing; header shows a larger date instead.
• Daily quote defaults to ZenQuotes (https://zenquotes.io/api/today) with local cache.