Skip to content

New Share your ideas with the AWTRIX community. Keep your creations together in your account.

Sign in

Which AWTRIX do you have? Choose it once and the Hub shows what runs on it.

ScriptAWTRIX NG

Abfall

On an AWTRIX display
Abfall shown on an AWTRIX display
Abfall · by fshero

On your display

Visualisiert anstehende Müllabfuhr-Termine mit automatischer Farbcodierung nach Müllart.

Which AWTRIX do you have? See below where it runs, or choose your device.
Topic
Smarthome
Includes
Script

Runs on

  • Does not run on 32×8 (TC001 & DIY) Made for 52×16 (TC002).
  • Runs on 52×16 (TC002)
  • Does not run on 32×8 with AWTRIX 3 (TC001 & DIY) Made for AWTRIX NG.

Choose your display in the next step.

Send to AWTRIX

Choose your AWTRIX

AbfallAWTRIX NG script

Install this script on your AWTRIX NG. Its icons and sounds are installed with it.

Your AWTRIX’s local address, for example 192.168.178.39 or awtrix.local.

The name shown in your AWTRIX script list. Use letters, digits, hyphens or underscores.

Connection & device login

Connect your phone or computer to the same network as your AWTRIX. Allow local network access if your browser asks.

Use the device’s IP address, without a page path such as /#/apps.

If your AWTRIX requires a login, the username and password fields will appear when you connect.

Sign in to the Hub to install scripts. Attached files are installed separately.

Script description

Die App Abfall zeigt anstehende Müllabfuhr-Termine basierend auf empfangenen MQTT-Nachrichten an. Die Farbgebung der Mülltonne sowie das angezeigte Emblem passen sich vollautomatisch der erkannten Müllart an. Die App verwendet standardmäßig platzsparende Kurzbezeichnungen, sodass der Text ohne störenden Lauftext direkt lesbar ist.


Unterstützte Müllarten und Erkennung

Die App analysiert den Text im Feld type (Groß- und Kleinschreibung wird ignoriert) anhand von Schlüsselwörtern und weist automatisch die passende Anzeigebezeichnung und Farbwelt zu. Wird keine bekannte Müllart erkannt, greift der neutrale Fallback MÜLL, um Fehlinterpretationen zu vermeiden:

Müllart (Display) Farbwelt Erkannte Schlüsselwörter im Text Typische Bezeichnungen
RESTMÜLL Anthrazit / Schiefergrau rest, hausmüll, hausmuell, grau, schwarz Restmüll, Restabfall, Hausmüll, Graue Tonne, Schwarze Tonne
BIOMÜLL Braun mit grünem Blatt-Emblem bio, braun, kompost, garten, grün, gruen Biomüll, Biotonne, Bioabfall, Kompost, Gartenabfall, Grünschnitt
GELBER SACK Signalgelb mit Recycling-Emblem gelb, wertstoff, plastik, verpackung, lvp Gelber Sack, Gelbe Tonne, Wertstofftonne, Plastikmüll, Leichtverpackungen
PAPIER Blau mit weißem Papier-Emblem papier, pappe, blau, karton Papiertonne, Altpapier, Papiermüll, Blaue Tonne, Kartonagen
GLAS Türkis mit hellem Glas-Emblem glas Altglas, Glascontainer, Buntglas, Weißglas
SCHADSTOFF Signalrot mit gelbem Gefahren-Emblem sonder, schad, problem, gift, gefahr Sonderabfall, Sondermüll, Schadstoffmobil, Schadstoffe, Problemmüll, Giftmüll
SPERRMÜLL Violett mit hellem Emblem sperr Sperrmüll, Sperrgut
MÜLL Anthrazit / Schiefergrau (Fallback / Standard) Allgemeiner Fallback für unbekannte oder nicht zugeordnete Bezeichnungen

MQTT-Schnittstelle

Die Daten werden über das konfigurierte MQTT-Topic (Standard: awtrix/trash/next) als JSON-Objekt empfangen.

Erwartete JSON-Felder
  • type (String, erforderlich): Name oder Bezeichnung der Müllart. Alternativ werden auch die Schlüssel waste_type oder name akzeptiert.
  • days (Integer, erforderlich): Anzahl der Tage bis zur Abholung als Ganzzahl (0 = heute, 1 = morgen, 2 = in 2 Tagen usw.). Alternativ werden daysTo oder day akzeptiert.
  • Optionale Felder wie date (z. B. "2026-10-18") können im JSON-Objekt übergeben werden; sie werden von der App für die Anzeige ignoriert.
Mehrere Termine gleichzeitig

Jede Nachricht beschreibt den kompletten aktuellen Stand und ersetzt den vorherigen. Mehrere Termine werden als Liste gesendet, auch mit unterschiedlichen Tagen:

[
  { "type": "Restmüll", "days": 0 },
  { "type": "Gelber Sack", "days": 0 }
]

Alternativ können mehrere Müllarten mit gleichem Termin zusammengefasst werden:

{
  "days": 0,
  "types": ["Restmüll", "Gelber Sack"]
}

Alle aktivierten Müllarten werden nach Tagen sortiert nacheinander angezeigt. Ist "Ausblenden wenn Termin weit entfernt" aktiv, erscheinen nur Termine innerhalb der Vorlaufzeit. Einzelobjekte wie in den folgenden Beispielen funktionieren weiterhin.


MQTT-Beispiele nach Müllart

Restmüll (Abholung heute)
{
  "type": "Restmüll",
  "days": 0
}
Biomüll (Abholung morgen)
{
  "type": "Biomüll",
  "days": 1
}
Gelber Sack (Abholung in 2 Tagen)
{
  "type": "Gelber Sack",
  "days": 2
}
Papiertonne (Abholung in 3 Tagen)
{
  "type": "Papiertonne",
  "days": 3
}
Glas (Abholung in 4 Tagen)
{
  "type": "Altglas",
  "days": 4
}
Sonderabfall / Schadstoffmobil (Abholung in 2 Tagen)
{
  "type": "Sonderabfall Limburg, Sonderabfall Elz",
  "days": 2,
  "date": "2026-10-18"
}
Sperrmüll (Abholung in 5 Tagen)
{
  "type": "Sperrmüll",
  "days": 5
}
Allgemeiner Müll / Fallback (unbekannte Bezeichnung)
{
  "type": "Müll",
  "days": 1
}
Beispiel mit alternativen Schlüsseln aus Home Assistant
{
  "waste_type": "Wertstofftonne",
  "daysTo": 1
}

App-Einstellungen

Die folgenden Einstellungen können in der AWTRIX Web-Oberfläche unter den App-Einstellungen (Zahnrad-Symbol) angepasst werden:

Parameter Bezeichnung im Web-UI Typ Standard Beschreibung
topic MQTT-Topic Text awtrix/trash/next MQTT-Topic, auf dem die Termindaten empfangen werden.
warn_days Vorlaufzeit in Tagen (1-14) Zahl 3 Maximale Vorlaufzeit in Tagen.
hide_far Ausblenden wenn Termin weit entfernt Schalter false Überspringt die App in der Rotation, wenn der Termin weiter entfernt ist als die Vorlaufzeit.
show_rest Restmüll anzeigen Schalter true Zeigt Restmüll-Termine an (bei Deaktivierung übersprungen).
show_bio Biomüll anzeigen Schalter true Zeigt Biomüll-Termine an.
show_yellow Gelben Sack anzeigen Schalter true Zeigt Gelber-Sack- und Wertstoff-Termine an.
show_paper Papier anzeigen Schalter true Zeigt Altpapier- und Kartonagen-Termine an.
show_glass Glas anzeigen Schalter true Zeigt Glas-Termine an.
show_hazard Sonderabfall / Schadstoffe anzeigen Schalter true Zeigt Sonderabfall- und Schadstoff-Termine an (z. B. Schadstoffmobil).
show_bulky Sperrmüll anzeigen Schalter true Zeigt Sperrmüll-Termine an.
show_other Sonstigen Müll anzeigen Schalter true Zeigt sonstige nicht zugeordnete Termine (Fallback MÜLL) an.

More scripts in Smarthome

Something wrong with this script? Report it.