YAML scripts for Home Assistant displays on BLE E-Paper tags, designed for use with OpenEpaperLink.
This repository includes preconfigured display layouts for various screen sizes and tag types (SoluM, Gicisky, Hanshow, Chroma), integrating popular Home Assistant sensors and services such as Ecowitt, OpenUV, Flightradar24, DWD, and more.
Tested with SoluM 1.54" displays (152x152 px).
| File | Preview | Description |
|---|---|---|
1.54-dreo-fan-mini.yaml |
 |
Displays Dreo Tower Fan status. Requires Dreo HA Integration + media/dreo.jpg. |
1.54-aqara-tvoc-mini.yaml |
 |
Air quality from Aqara TVOC Zigbee sensor. |
1.54-weather-wind-compass.yaml |
– | Weather from WundergroundPWS via Ecowitt. |
1.54-waste-collection-calender.yaml |
 |
Waste collection schedule (requires region config via Müllkalender integration). |
1.54-openuvindex_mini.yaml |
 |
UV index display via OpenUV. |
1.54-ecowitt-wh51-soil.yaml |
 |
Soil data from WH51 sensor via Ecowitt API. |
1.54-ecowitt-w57-lighting.yaml |
 |
Weather Lighting from W57 sensor via Ecowitt API. |
1.54-smart-air.yaml |
 |
Air quality sensor display via SmartAir Zigbee. |
1.54-solar-rain-alert.yaml1.54-solar-rain-alerter-V2.yaml |
 |
Solar-powered Zigbee rain sensor alert. |
1.54-openplant-soil.yaml |
  |
Soil/motion data with OpenPlant. Includes 3D printable stand (STL in /stl). |
1.54-flightradar.yaml |
 |
Local air traffic from Flightradar24 (Nuremberg airport example). |
1.54-medi-marker.yaml |
 |
Displays Medication Marker. Must add homeassistant helper for my four medi. |
1.54-uv-stufe-dwd.yaml |
 |
Displays UV index pyramid. Must add homeassistant HACS Integration UV-INDEX-CARD. |
1.54-zigbee-soil-molsture.yaml |
 |
Solarbased Zigbee Soil Mosture Sensor. |
1.54-bsh-tide.yaml |
 |
BSH Tide sensor via BSH API. Must add Hacs Integration BSH |
Resolution: 250x132 px
| File | Preview | Description |
|---|---|---|
2.13.dwd-pollen-warning.yaml |
 |
Pollen alerts from DWD. |
2.13.openuv-warning.yaml |
 |
UV warnings via OpenUV. |
2.13-hochwasserportal-pegelstaende.yaml |
– | Flood levels from Hochwasserportal. |
Resolution: 250x122 px
| File | Preview | Description |
|---|---|---|
2.2-openplant-soil.yaml |
 |
OpenPlant soil data. |
2.2-ecowitt_wh51_soil_4ch.yaml |
 |
4-channel WH51 soil display via Ecowitt. |
2.2-lunar-phase.yaml |
 |
moon-stand on 2.2 over lunar phase integration Integration source |
Resolution: 296x152 px
| File | Preview | Description |
|---|---|---|
2.66-openuv.yaml |
 |
OpenUV Warning. |
2.66-sun-stand.yaml |
 |
Sun and Moon stand.Calculation based on https://github.com/ngocjohn/lunar-phase?tab=readme-ov-file#using-the-home-assistant-ui integration. |
2.66-ecowitt_wh51_soil_4ch.yaml |
 |
Ecowitt WH51 Soil Motion sensor. |
Resolution: 296x128 px
| File | Preview | Description |
|---|---|---|
2.9-accu-weather.yaml |
 |
Weather from AccuWeather. |
2.9-hochwasserportal-pegelstaende.yaml |
 |
Flood levels. |
2.9-waste-collection.yaml |
– | Waste schedule display via Müllkalender. |
Resolution: 384x184 px
| File | Preview | Description |
|---|---|---|
3.5-dwd-weather-warning.yaml |
– | DWD weather alerts. |
3.5-dwd-weather-lighting-warning.yaml |
 |
Lightning warning view. |
Resolution: 400x300 px
| File | Description |
|---|---|
4.2-flight-radar.yaml |
Flightradar24 integration. Requires modification for your airport and use case. Integration source |
4.2-dwd-weather.yaml |
DWD weather integration. Modify YAML for your use case. |
Resolution: 640x384 px
| File | Preview | Description |
|---|---|---|
7.4-dwd-weather-ranking-hh-n.yaml |
 |
Compares weather rankings between Hamburg and Nuremberg. |
Resolution: 800x480 px
| File | Preview | Description |
|---|---|---|
7.5-pws-weather.yaml |
 |
Ecowitt PWS weather display (Nuremberg). |
7.5-dwd-pollenflug.yaml |
 |
DWD Pollenflug for Nuremberg. |
- Template sensors to extend Home Assistant functionality.
- Includes CAPE and Lifted Index sensors.|
- Add to your
\homeassistant-configs\input-helpers.yaml.
- Add to your
\homeassistant-configs\medi-marker-card.yaml.
- Fonts required for certain scripts (e.g., AccuWeather).
- Copy to:
/homeassistant/custom_components/open_epaper_link/
- Display examples for each YAML script.
- 3D printable parts (e.g., OpenPlant stand).
| Tag Size | Resolution |
|---|---|
| 1.54" | 152x152 |
| 2.13" | 250x132 |
| 2.2" | 250x122 |
| 2.66" | 296x152 |
| 2.9" | 296x128 |
| 3.5" | 384x184 |
| 4.2" | 400x300 |
| 7.4" | 640x384 |
| 7.5" | 800x480 |
To use fonts in scripts (e.g., for AccuWeather):
- Place the font file in your
/media/directory. - Copy the font to your Home Assistant folder:
/homeassistant/custom_components/open_epaper_link/
Pull requests are welcome! Please ensure that:
- YAML is valid and tested.
- Tags are correctly sized.
- External dependencies are noted clearly.
This repository is released under the MIT License.
3D models may be subject to separate licenses (see /stl folder).