[Custom Integration] Mail Package Tracker – Lokale Paketverfolgung per IMAP mit eigenem Sidebar-Panel, Live-Tester & ohne Regex-Zwang!

Hallo in die Runde,

ich habe in letzter Zeit einiges ausprobiert, was die Paketverfolgung meiner Bestellungen in Home Assistant angeht. Vorhandene Lösungen wie der „17TRACK“ waren mir oft viel zu umständlich in der Einrichtung, und das Thema Amazon ist ja ohnehin immer so eine Sache für sich.

Also habe ich mich hingesetzt und eine eigene, leichtgewichtige Integration (kompatibel mit HACS) gebastelt: den Mail Package Tracker.

Die Integration durchsucht lokal per IMAP euer Postfach nach Bestellungen, Versandbestätigungen und Zustellbenachrichtigungen, legt für jeden Shop bzw. Dienstleister ein eigenes Gerät an und erstellt dynamisch die passenden Paket-Sensoren für euer Dashboard.

Die wichtigsten Highlights im Überblick:

  • :desktop_computer: Eigenes Sidebar-Panel & Live-Tester: Über die eigene Ansicht :package: Paket-Tracker in der Seitenleiste (lässt sich jederzeit per Switch ein-/ausblenden) könnt ihr alle Shops verwalten, aktive Pakete einsehen und mit dem :test_tube: Live Email Tester echte Mails aus eurem Postfach mit einem Klick gegen eure Regeln testen.
  • :clipboard: Kein Regex-Studium nötig & Artikel-Erkennung: Ihr müsst keine komplizierten Regular Expressions schreiben (könnt es aber optional). Einfache Schlagworte oder Präfixe (wie DHL Trackingnummer: oder Bestellung) reichen völlig aus! Zudem liest die Integration auch direkt die bestellten Artikel aus der Mail aus (z.B. 3 Artikel: 1 PETG + 1 PLA+ …).
  • :counterclockwise_arrows_button: 4-Stufen-Lebenszyklus & Auto-Cleanup: Pakete wandern automatisch durch die Status :shopping_cart: Bestellt ➔ :delivery_truck: Unterwegs ➔ :high_voltage: In Zustellung ➔ :white_check_mark: Zugestellt (inkl. automatischer Bereinigung nach X Tagen).
  • :link: Smarte Duplikat-Erkennung (all_ids): Die Integration verknüpft die Bestellnummer aus der ersten Bestellbestätigung automatisch mit der späteren Trackingnummer aus der Versandmail. So taucht eine Sendung nicht doppelt auf.
  • :inbox_tray: 1-Click JSON Import/Export (inkl. Validator): Neue Regeln für weitere Shops lassen sich mit einem Klick als JSON exportieren und importieren – inklusive Echtzeit-Prüfung, damit man sich keine fehlerhaften Regeln einbaut.
  • :locked: Ressourcen- & Postfach-schonend: Es wird im Read-Only-Modus (BODY.PEEK) abgefragt. Ungelesene Mails bleiben im Postfach also ungelesen und große Anhänge (PDFs, Bilder) werden erst gar nicht heruntergeladen.

Installation & Dashboard: Ihr könnt die Integration ganz einfach als benutzerdefiniertes Repository über HACS installieren. Auf GitHub habe ich euch außerdem direkt den passenden YAML-Code für eine fertige Dashboard-Karte (auf Basis von Mushroom Cards und auto-entities) hinterlegt, die eure Pakete automatisch nach Status gruppiert und mit einem Klick zum Tracking-Link führt.

:backhand_index_pointing_right: Hier geht es zum GitHub-Repository (inkl. Screenshots & Anleitung): GitHub - Tabu1973/mail_package_tracker: 📦 Universal Mail Package Tracker for Home Assistant (HACS) with Sidebar Panel, Live Email Tester & Multi-Stage Package Lifecycle · GitHub

Mitmachen erwünscht! Da jeder Shop und Versanddienstleister seine E-Mails anders aufbaut und ich unmöglich alle selbst testen kann, lebt das Projekt vom Mitmachen. Wenn ihr Filter für weitere Shops erstellt, exportiert einfach die .json-Datei über das Sidebar-Panel und teilt sie!

Über Feedback, allgemeine Anregungen hier im Thread oder natürlich über Issues und Pull Requests (sehr gerne mit euren eigenen Shop-Vorlagen!) auf GitHub würde ich mich riesig freuen.

Bedenkt aber bitte, dass die Integration noch beta ist. Bis jetzt funktioniert es bei mir soweit.

Viel Spaß beim Testen!

Kai