A simple, low-power dashboard using ESPHome and Home Assistant, displayed on a 7.5" e-paper device. It shows weather, temperatures, service status, and Proxmox container stats, cycling through splash, home, and Proxmox screens.

Provide key home and system data at a glance—without needing to unlock or tap anything. It’s always visible, silent, and easy to customize.

• 3 auto-rotating screens:
  1. Splash image
  2. Weather, indoors/outdoors, service health
  3. Proxmox container resource usage (CPU, memory, swap)
• Clean layout with Material Design icons
• Very low energy use—no backlight, always readable
• Runs on a Seeed Studio XIAO 7.5" ePaper Panel, fully integrated and easy to install

The project uses the Seeed Studio XIAO 7.5" ePaper Panel, which includes:

• Built-in XIAO ESP32-C3, Wi-Fi capable
• 7.5" 800×480 e-paper display
• USB-C port, boot/reset buttons, and optional battery
• Tight integration with ESPHome and Home Assistant via their wiki guide :contentReference[oaicite:0]{index=0}

Note: I plan to paint the panel matte black to blend with my setup.

• Go to Settings → Add-ons → Add-on Store
• Find ESPHome, click Install, then Start
• If it’s missing, you may need a supported Home Assistant installation. For Home Assistant Container, use ESPHome Device Builder via Docker :contentReference[oaicite:1]{index=1}.

• Select New Device, choose a name (e.g., epaper_dashboard)
• Pick ESP32-C3 as the board, then click Edit

• Replace the auto-generated YAML with dashboard.yaml from this repo
• Update Wi-Fi and Home Assistant API credentials
• Customize any sensor IDs to match your Home Assistant setup

• USB (initial setup): Click Install → Manual Download, then use the web uploader to flash the panel
• OTA (subsequent updates): After initial setup, updates can be pushed wirelessly if ota: and api: are properly configured

For full ESPHome setup and examples, see the official Seeed wiki .

This dashboard reflects my setup—but you can adapt it:

• Add different sensors (e.g., energy usage, security status)
• Re-order or combine slides
• Change icons, fonts, or layout elements - I got all the icons using the MDI font, and used this site to browse through icons.

The ESPHome code driving this display is fairly manual and hardcoded. Every element—icons, positions, font sizes, sensor mapping—is placed by hand, which makes it tricky to update or expand. There’s no dynamic layout or auto-scaling, so small tweaks often require testing and adjusting coordinates little by little.

It works for me as it is now, and I don't expect to need frequent changes. But it's definitely not plug-and-play, and there's plenty room for improvement.

I’d like to eventually improve the layout logic or even explore a different approach entirely—perhaps switching to Arduino and making direct API calls to Home Assistant for more flexibility. For now, this solution fits my needs, and it stays reliable once configured. Just be prepared for some trial and error if you decide to build your own version.

• dashboard.yaml – ESPHome configuration
• fonts/ – Font files including Material Design icons
• image/ – Boot splash image (optional), logos, etc

**REMINDER: For any images to be displayed nicely on a binary e-ink display, remember to reformat it as a binary image using a tool such as this one: https://onlinejpgtools.com/create-binary-jpg

Feel free to use, modify, and build on this—no restrictions.