Files
awtrix-abfallkalender/README.md
T
2026-05-15 13:42:15 +02:00

261 lines
2.2 KiB
Markdown

\# AWTRIX Müllkalender (ioBroker)
Zeigt bevorstehende Müllabfuhrtermine auf einer AWTRIX 3 Matrix-Uhr über MQTT an.
Das Skript nutzt den ioBroker Trashschedule-Adapter und veröffentlicht automatisch Hinweise für:
\* Hausmüll
\* Biomüll
\* Gelbe Tonne
Die Anzeige erfolgt als AWTRIX Custom App inklusive:
\* passendem Icon
\* individueller Farbe je Müllart
\* automatischer Rotation
\* Keep-Alive Refresh
\---
\# Funktionen
\* Anzeige der nächsten Müllabfuhr auf AWTRIX 3
\* Automatische Anzeige:
  \* ab Vortag 16:00 Uhr
  \* bis zum Abholtag 10:00 Uhr
\* Unterschiedliche Farben je Müllart
\* Eigene AWTRIX-Icons
\* MQTT-basierte Kommunikation
\* Keep-Alive Refresh gegen Ablauf der AWTRIX-App
\* Fallback auf `/notify` möglich
\---
\# Voraussetzungen
\## ioBroker Adapter
Benötigt werden:
\* JavaScript-Adapter
\* MQTT-Adapter
\* Trashschedule-Adapter
\---
\# Verwendete Datenpunkte
```text
trashschedule.0.type.hausmuell.nextDate
trashschedule.0.type.biotonne.nextDate
trashschedule.0.type.gelbetonne.nextDate
```
\---
\# AWTRIX Voraussetzungen
\* AWTRIX 3
\* MQTT-Anbindung aktiviert
\* Custom Apps aktiviert
\---
\# MQTT Topic
```text
awtrix/custom/TrashInfo
```
\---
\# Konfiguration
Im oberen Bereich des Skripts können folgende Werte angepasst werden:
\## MQTT
```javascript
const MQTT\_INSTANCE = "mqtt.0";
const AWTRIX\_PREFIX = "awtrix";
```
\## Anzeige
```javascript
const ROTATION\_NAME = "TrashInfo";
const LIFETIME\_SEC = 600;
```
\## Zeitfenster
```javascript
const CRON\_CHECK = "\*/5 \* \* \* \*";
```
Standard:
\* Prüfung alle 5 Minuten
\* Anzeige:
  \* ab Vortag 16:00 Uhr
  \* bis Abholtag 10:00 Uhr
\---
\# Unterstützte Müllarten
| Typ | Farbe |
| ----------- | ----- |
| Hausmüll | Weiß |
| Biomüll | Braun |
| Gelbe Tonne | Gelb |
\---
\# Besonderheiten
Das Skript nutzt einen regelmäßigen Keep-Alive Refresh, damit die AWTRIX-App nicht aus der Rotation verschwindet.
Wenn kein relevanter Mülltermin mehr aktiv ist, wird die Anzeige automatisch entfernt.
\---
\# Datei
```text
awtrix3-abfallkalender.js
```