Initial commit

README.md

@@ -0,0 +1,260 @@
+\# 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
+
+```
+
+
+