Ausführliche Anleitung mit Rezepten: soerenkaiser99.github.io/parcel_tracker · Alle Versionen: CHANGELOG
Home-Assistant-Integration, die Pakete von DHL, DPD, GLS, Hermes und (optional) UPS verfolgt, Amazon-, eBay- und AliExpress-Bestellungen sowie Eventim-Tickets mit Postversand aus E-Mails übernimmt und alles auf einer eigenen Dashboard-Karte zeigt.
Die Bilder zeigen erfundene Pakete: Namen, Orte und Sendungsnummern sind ausgedacht. Die Karte lässt sich ohne Home Assistant im Browser ausprobieren: Demo-Karte öffnen.
Ich war es leid, ständig in verschiedenen Apps Zustelltage und -zeiten zu checken. Ich wollte in Home Assistant an einer Stelle sehen: „Kommt heute ein Paket, und wann?“ – für alle Carrier zusammen, statt in fünf Apps und einem Stapel Mails zu suchen.
- Pakete erscheinen von selbst: Die Integration liest die Versandmails und legt die Pakete an – auch Amazons eigene Lieferungen, für die es keine öffentliche Sendungsverfolgung gibt.
- Benachrichtigung aufs Handy: sobald ein Paket in Zustellung geht oder zugestellt ist – ohne eigene Automation.
- Für Automationen gemacht: Status-Event, Kalender mit den Lieferterminen, Sensor „Pakete heute“ und ein Blueprint für eigene Benachrichtigungen.
- Lokal und datensparsam: kein Cloud-Konto, kein fremder Tracking-Dienst nötig; die Zugangsdaten bleiben in Home Assistant, gelesen wird nur ein eigenes Paket-Postfach.
- Offen: Open Source, gebaut für deutsche Carrier.
- Live-Status vom Paketdienst: DPD, GLS und Hermes ohne Zugangsdaten, DHL mit kostenlosem API-Key, UPS mit eigenem Entwicklerzugang (braucht ein UPS-Konto mit Abrechnung) – Was brauche ich für welchen Dienst?
- E-Mail-Import (optional): liest ein eigenes Paket-Postfach per IMAP und legt Pakete aus Shop- und Carrier-Mails an – E-Mail-Import
- Karte
custom:parcel-tracker-card: Pakete hinzufügen, umbenennen, als erhalten markieren und entfernen – Die Karte - Benachrichtigungen (optional): bei „in Zustellung“, „zugestellt“, „abholbereit“ oder einem Problem, ohne eigene Automation, auf Wunsch nur an die Person, der das Paket gehört (Pakete Personen zuordnen) – Benachrichtigungen
- Automationen: fünf Auslöser im Automations-Editor ohne YAML, das Event
parcel_tracker_status_changedundparcel_tracker_parcel_addedfür neue Pakete – Automationen - Rezepte: elf Beispiele für Automationen und Karten zum Kopieren – Rezepte
- Sensoren und Kalender:
sensor.paket_<nummer>pro Paket,sensor.pakete_heute, vier Zählsensoren undcalendar.pakete– Sensoren, Kalender und Dienste - Dienste:
parcel_tracker.add_parcel,remove_parcel,rename_parcel,mark_delivered,refresh,track_17track,set_gift,set_owner– Dienste - 17track (optional): ergänzt Ort, Zeitfenster und Verlauf und verfolgt Carrier ohne eigene Anbindung, z. B. FedEx – 17track
- Namen ausblenden (optional): Pakete heißen überall nur nach dem Paketdienst, für Geschenke auf einem gemeinsamen Dashboard; dazu der Geschenkmodus, in dem nur festgelegte Personen sehen, was in einem Paket steckt – Namen ausblenden
Die Integration ist für Deutschland gebaut (deutsche Carrier und deutsche Mail-Formate). Im Ausland funktionieren DHL (offizielle API, weltweit), UPS (offizielle API) und jeder Carrier über 17track; der Mail-Import versteht nur deutsche Mails (amazon.de sowie deutsche DHL-, Hermes-, UPS-, GLS-, eBay- und AliExpress-Mails). Was in Österreich und der Schweiz geht: Österreich und Schweiz.
Voraussetzung: HACS ist in Home Assistant installiert. Paket Tracker steht im Standardkatalog von HACS.
- In HACS nach „Paket Tracker“ suchen (oder den Knopf nutzen), Herunterladen wählen und Home Assistant neu starten.
- Einstellungen → Geräte & Dienste → Integration hinzufügen → „Paket Tracker“ einrichten.
- Die Seite einmal neu laden und im Dashboard die Karte „Paket Tracker“ hinzufügen.
Findet HACS die Integration nicht, kannst du sie weiter als benutzerdefiniertes Repository eintragen: HACS → Menü (⋮) → Benutzerdefinierte Repositories → https://github.com/SoerenKaiser99/parcel_tracker, Typ Integration.
HACS lädt die Integration nur herunter; ohne Schritt 2 passiert nichts. Installation ohne HACS, die Einrichtungsfelder und die Schritte nach einem Update: Installation.
- Installation – herunterladen, einrichten, Karte hinzufügen
- Was brauche ich für welchen Dienst? – DHL-API-Key, GLS, UPS, 17track, Österreich und Schweiz
- E-Mail-Import – Paket-Postfach, Absender für die Filterregel, was aus welcher Mail wird
- Die Karte – Pakete hinzufügen, „Erhalten“, die Optionen
add_form,show,headerundgifts - Benachrichtigungen – Ziele, Ereignisse, Texte und der Blueprint
- Automationen – Auslöser ohne YAML und die Felder des Events
- Rezepte – Beispiele zum Kopieren
- Sensoren, Kalender und Dienste – alle Entitäten, Attribute, Dienste und der Inhalt der Diagnose
- Datenschutz – welche Angabe wohin geht, Namen ausblenden, Zustell-Codes
- Hilfe – häufige Fragen, Fehler melden, Beispielmails einreichen
- Roadmap & Status – was umgesetzt, bestätigt und offen ist
- Mithelfen – was gerade am meisten hilft
Paket Tracker ist eine öffentliche Beta. Welche Funktionen noch eine Bestätigung aus dem Alltag brauchen und welche Beispielmails fehlen, steht unter Wie ihr helfen könnt; häufige Fragen beantwortet die Hilfe.
Die Diagnose herunterladen (Einstellungen → Geräte & Dienste → Paket Tracker → ⋮ → Diagnose herunterladen) und an ein Issue mit der Vorlage „Fehler melden“ hängen. Die Schritte und was die Diagnose enthält: Fehler melden. Geht es um eine Mail, die der Import nicht erkennt: siehe Beispielmails einreichen.
Landet eine Paketmail im Ordner Paket-Tracker-Nicht-erkannt oder fehlt ein Shop oder Carrier, lässt sich das nur mit einer Beispielmail beheben. Eingereicht werden ausschließlich anonymisierte Mails als ZIP an einem GitHub-Issue, erzeugt mit dem Skript anonymize_mail.py.
Nie rohe Mails hochladen. Nie Mails privat an den Autor schicken.
Die fünf Schritte stehen in der Anleitung: Beispielmails einreichen.
Sendungsnummern gehen nur an den jeweiligen Carrier, die PLZ nur an DHL und GLS, und an 17track geht eine Nummer nur auf ausdrücklichen Wunsch. Aus Mails übernimmt der Import nur Nummer, Artikeltitel, Shop- oder Firmenname, Status und Liefertermin; Adressen, Namen von Personen und Mail-Inhalte landen weder in Attributen noch im Log. Die Einzelheiten und die eine Ausnahme: Datenschutz.
DHL, DPD, Hermes, UPS, GLS, 17track, Amazon, eBay, AliExpress und Eventim sind Marken ihrer Inhaber. Die Logos (Simple Icons, CC0) dienen nur zur Kennzeichnung des Carriers; DHL als gelbes Schild mit rotem Schriftzug, UPS in der Textfarbe des Themes, Hermes erscheint als blauer Punkt mit „H“, GLS als blauer Punkt mit „G“ (Simple Icons hat kein GLS-Logo), AliExpress als roter Punkt mit „A“, Eventim als dunkelblauer Punkt mit „E“, „Andere (über 17track)“ als grauer Punkt mit „17“. Dieses Projekt ist nicht mit den Unternehmen verbunden.
Was umgesetzt, von Testern bestätigt, noch ungetestet oder offen ist, steht unter Roadmap & Status.
Paket Tracker is a Home Assistant custom integration, built for Germany, that tracks parcels from DHL, DPD, GLS, Hermes and, optionally, UPS. Why: one place in Home Assistant that answers "is a parcel coming today, and when?" across all carriers – parcels appear by themselves from shipping mails (Amazon, eBay, AliExpress, the carriers, and Eventim tickets sent by post), and everything runs locally with no cloud account and no third-party tracking service. It ships its own Lovelace card (custom:parcel-tracker-card), one sensor per parcel plus summary sensors, a delivery calendar, a parcel_tracker_status_changed event with device triggers for automations without YAML, and optional push notifications (notify entities or classic notify services such as Pushover) with a blueprint for custom texts. Install it through HACS: it is in the HACS default catalog, just search for "Paket Tracker". Tracking numbers are sent only to the matching carrier (or, on request, to 17track), and the postcode is sent only to DHL and GLS. A country setting (Germany, Austria, Switzerland) sets the postcode length; abroad, DHL, UPS and 17track work, while the mail import reads German mails only. The card and the documentation are in German: see the documentation and Roadmap & Status.