Mail and Packages Smart-Home-Integration, kostenlos und Open Source

Pakete und Post aus Ihrem Postfach erkannt (DHL, Hermes, UPS, Amazon…).
Mail and Packages liest die Versandbenachrichtigungen in Ihrem Postfach und teilt Gladys mit, welche Pakete unterwegs sind, heute ankommen, auf Abholung warten, zugestellt wurden oder feststecken. Die Integration versteht 36 Versanddienste und Marktplätze (DHL, Deutsche Post, Hermes, DPD, GLS, UPS, FedEx, Amazon, Österreichische Post, Swiss Post…) auf Deutsch, Englisch, Französisch, Spanisch, Italienisch, Niederländisch und Polnisch.
Datenschutz
- Das Postfach wird per IMAP nur lesend geöffnet: nichts wird verschoben, markiert, als gelesen gesetzt oder gelöscht.
- Nur die E-Mails der aktivierten Versanddienste werden heruntergeladen; alle anderen werden nur anhand von Absender und Betreff gesehen und nie gespeichert.
- Nichts verlässt Ihr Gladys: kein Drittanbieter, keine Tracking-API.
- Die Integration speichert eine kleine Datei (
/data/state.json) mit den bereits gemeldeten Benachrichtigungen, damit ein Neustart sie nie doppelt auslöst. Kein E-Mail-Inhalt, kein Passwort.
Einrichtung
- Öffnen Sie den Tab Konfiguration der Integration.
- Tragen Sie IMAP-Server, Port und Sicherheit Ihres Anbieters ein (siehe Tabelle), dann Benutzername (meist die E-Mail-Adresse) und Passwort.
- Wählen Sie die zu prüfenden Ordner: standardmäßig
INBOX. Mehrere Ordner durch Kommas trennen, z. B.INBOX, Einkäufe. - Deaktivieren Sie bei Bedarf Versanddienste, die Sie nie nutzen. Fehlende Shops oder Versanddienste tragen Sie unter Andere Absender ein (Adressen oder Domains).
- Speichern und Verbindung testen klicken.
- Im Tab Erkennung die gewünschten Geräte hinzufügen.
| Anbieter | IMAP-Server | Port | Sicherheit | Passwort |
|---|---|---|---|---|
| Gmail | imap.gmail.com | 993 | TLS | App-Passwort |
| iCloud | imap.mail.me.com | 993 | TLS | App-Passwort |
| GMX | imap.gmx.net | 993 | TLS | IMAP in den GMX-Einstellungen aktivieren |
| WEB.DE | imap.web.de | 993 | TLS | IMAP in den WEB.DE-Einstellungen aktivieren |
| T-Online | secureimap.t-online.de | 993 | TLS | E-Mail-Passwort (nicht das Kundencenter-Passwort) |
| Outlook / Hotmail | — | — | — | Microsoft akzeptiert keine Passwörter mehr per IMAP: weiterleiten |
Tipp: Legen Sie ein eigenes Postfach nur für Gladys an und leiten Sie die E-Mails Ihrer Versanddienste dorthin weiter.
Geräte
- Post und Pakete: Zusammenfassung aller Versanddienste — Unterwegs, Kommt heute, Heute zugestellt, Abholbereit, Zustellprobleme, Heute erwartete Post (USPS Informed Delivery) und Letzte Aktualisierung (Text).
- Pakete – Versanddienst: dieselben fünf Zähler je Versanddienst.
Szenen
Auslöser (Kategorie „Integrationen“): Paket versandt, Paket in
Zustellung, Paket abholbereit, Paket zugestellt, Zustellproblem, Heute
Briefpost erwartet. Filterbar nach Versanddienst; Variablen:
{{triggerEvent.data.carrier_name}}, tracking, tracking_url,
pickup_code, subject. Jeder Schritt löst genau einmal aus.
Aktionen: Postfach nach Paketen prüfen (liest jetzt) und Paketzähler
abrufen (sofort, letzte Prüfung). Ausgaben: arriving_today, in_transit,
pickup, delivered, exception, mail, expected_today und summary
(fertiger Satz zum Versenden).
Dashboard-Widgets
- Pakete heute: Zähler als Kacheln, Postfachstatus, letzte Prüfung, Schaltfläche Jetzt prüfen.
- Sendungsverfolgung: Pakete unterwegs mit Sendungsnummer, Abholcode und Link zur Verfolgungsseite.
Fehlerbehebung
- Benutzername oder Passwort abgelehnt: Gmail, iCloud und Yahoo verlangen ein App-Passwort.
- Ordner existiert nicht: Groß-/Kleinschreibung beachten.
- Paket nicht erkannt: Melden Sie Absenderadresse und Betreff auf GitHub.
Ausführliche Dokumentation: English.
Konfigurationseinstellungen
Diese Einstellungen fragt Mail and Packages in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Ihr Postfach | section | Nein | Die Integration liest die Versandbenachrichtigungen Ihres Postfachs per IMAP, nur lesend: nichts wird verschoben, markiert oder gelöscht. Gmail, iCloud, Yahoo und Outlook verlangen ein App-Passwort, nicht Ihr übliches Passwort. Ein eigenes Postfach, an das Sie Ihre Versand-E-Mails weiterleiten, funktioniert auch. |
| IMAP-Server | string | Ja | |
| Port | number | Ja | 993 mit TLS, 143 mit STARTTLS. |
| Sicherheit | select | Ja | |
| Benutzername | string | Ja | |
| Passwort (oder App-Passwort) | secret | Ja | |
| Ordner | string | Ja | Zu prüfende Ordner, durch Kommas getrennt (z. B. INBOX, Einkäufe). Gmail-Labels sind Ordner. |
| Selbstsigniertes Zertifikat akzeptieren | boolean | Nein | Nur für einen Mailserver im eigenen Netz. Für einen Online-Anbieter ausgeschaltet lassen. |
| Versanddienste | section | Nein | Für jeden markierten Versanddienst erscheint ein Gerät im Tab „Erkennung“, neben dem Übersichtsgerät „Post und Pakete“. |
| Zu erkennende Versanddienste | multi_select | Nein | |
| Andere Absender | string | Nein | Shops oder Versanddienste, die in der Liste fehlen: Adressen oder Domains, durch Kommas getrennt. Gezählt unter „Andere Absender“. |
| Erweitert | section | Nein | |
| Prüfintervall (Minuten) | number | Nein | |
| Tage an E-Mails lesen | number | Nein | Ein Paket bleibt „unterwegs“, solange seine E-Mails jünger sind. |
| Sprache der Gerätenamen | select | Nein | |
| Zeitzone | string | Nein | Legt fest, wann „heute“ beginnt. Leer: die Zeitzone des Gladys-Servers. |
So installierst du Mail and Packages in Gladys
- Öffne in Gladys Integrationen: Mail and Packages erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/gboulvin/gladys-mail-and-packages:1.0.2) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/gboulvin/Gladys-Mail-and-Packages.
Mail and Packages benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
Mail and Packages ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von gboulvin veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation