whatisgithub

What is ha-eink-wx?

tollycat/ha-eink-wx — explained in plain English

Analysis updated 2026-05-18

1Audience · generalComplexity · 3/5Setup · hard

In one sentence

Configuration files for showing a Home Assistant weather dashboard on a small black and white e-ink display.

Mindmap

mindmap
  root((ha-eink-wx))
    What it does
      Shows weather on e-ink
      Renders a HA dashboard
      Pulls forecast and alerts
    Tech stack
      Home Assistant
      ESPHome
      Puppet
    Use cases
      DIY smart home weather display
      E-ink dashboard hardware project
    Audience
      Home Assistant users
      Hobbyist makers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Build a small e-ink weather display for a home using Home Assistant.

USE CASE 2

Show National Weather Service forecasts and alerts on a physical screen.

USE CASE 3

Learn how to render a Home Assistant dashboard as an image with Puppet.

USE CASE 4

Adapt the configuration to a personal weather station setup.

What is it built with?

Home AssistantESPHomePuppet

How does it compare?

tollycat/ha-eink-wx0xkinno/neuralvault0xlocker/d17-contracts
Stars111
LanguageTypeScriptSolidity
Setup difficultyhardhardhard
Complexity3/54/55/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires an existing Home Assistant setup, ESPHome, the specific Seeedstudio e-ink hardware, and Puppet for image rendering.

No license information was found in the README.

So what is it?

ha-eink-wx is a small project that shows how to set up a simple weather display on a black and white e-ink screen using Home Assistant, a popular home automation platform. It is built specifically to fit the Seeedstudio XIAO 7.5 inch ePaper panel, an 800 by 480 pixel e-ink display. The repository is really a set of configuration files rather than a program you run. One file holds the layout of a Home Assistant dashboard that shows the weather, and another file is the configuration used to get that dashboard onto the physical e-ink screen through ESPHome, a tool for programming small smart home devices. To get weather data onto the display, the setup relies on optional add ons for Home Assistant, including a personal weather station plugin, the National Weather Service for forecasts and alerts in the United States, and optionally an Ecowitt weather station integration. It also uses a tool called Puppet to turn the dashboard into an image file that the e-ink screen can show. Setting it up involves creating a new dashboard in Home Assistant, pasting in the provided configuration, and editing it so the weather sensors match your own local weather station instead of the example one included in the file. The README also links out to Seeedstudio's own instructions for wiring the yaml configuration into the e-ink hardware itself using ESPHome. This is a personal hobby project shared as is, with instructions aimed at people who are already comfortable using Home Assistant and ESPHome. The README does not mention a license.

Copy-paste prompts

Prompt 1
Walk me through setting up the inkwx dashboard configuration in Home Assistant.
Prompt 2
Explain how to wire the ha-display.yaml file into ESPHome for this e-ink panel.
Prompt 3
Help me change the weather station sensor in this config to match my own location.
Prompt 4
Show me how Puppet is used to turn this dashboard into an image for the e-ink screen.

Frequently asked questions

What is ha-eink-wx?

Configuration files for showing a Home Assistant weather dashboard on a small black and white e-ink display.

What license does ha-eink-wx use?

No license information was found in the README.

How hard is ha-eink-wx to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is ha-eink-wx for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.