Folders and files
| Name | Name | Last commit date | ||
|---|---|---|---|---|
Note
This card is vibe coded
A Home Assistant Lovelace card that shows your packages from multiple carrier integrations in one clean, unified view.
- Works out of the box: add the card with no configuration at all and it shows every package it recognizes automatically, no sources list required.
- One card, multiple sources: combine integrations from multiple carriers side by side, deduplicated automatically when the same parcel shows up through more than one source.
- Expandable detail per package: tracking code (tap to copy), full event timeline, and package size/weight when the carrier provides it.
- Auto-detecting editor: want to narrow the card down to specific integrations or accounts instead? Open the editor, click + next to a detected one, done. Multiple accounts of the same integration are detected and managed separately. No YAML required either way.
- Recipient chip: see whose package is whose on a shared, household card, auto-detected from the carrier where it reports one, or a name you set per account.
- Filter & layout options: filter by carrier, status, direction, or delivery window; single combined card or split incoming/outgoing cards.
- Go to HACS → three-dot menu → Custom repositories.
- Enter https://github.com/klaptafel/ha-package-tracker-card, category Dashboard, click Add.
- Find Package Tracker Card and click Download.
The visual editor covers everything: Sources, Filter, Appearance.
sources is optional. Leave it empty (or omit it) and the card shows everything it recognizes automatically; use filter (below) to narrow that down per card instance. Add specific sources here instead to limit a card to just those.
- Any integration/carrier from ha-parcel-integrations (e.g. PostNL, DHL, DPD) is detected automatically the moment it's installed.
- jmdevita/parcel-ha: a third-party aggregator covering several carriers generically; works alongside a carrier's own integration too, the card merges parcels automatically.
| Option | Default | Description |
|---|---|---|
| sources | [] | List of sources. An ha-parcel-integrations source just needs entity; others also need type. Empty or omitted shows everything auto-detected instead. |
Sharing one card between several people? Some carriers already report who a package is addressed to, shown automatically as a chip. Set a Recipient per account in the editor's Sources tab to override that, or to add a name where the carrier doesn't provide one.
| Option | Default | Description |
|---|---|---|
| state | all | all, enroute, or delivered. |
| direction | - | incoming or outgoing. |
| carriers | - | Filter by one or more carrier codes, e.g. [dpdgpcode]. The editor offers these as a dropdown populated from your own sources; easier than looking codes up. The older singular carrier (string) still works for existing configs. |
| slot_active | false | Active delivery window only. |
| date | - | Relative day. 0 = today, 1 = tomorrow, -1 = yesterday. |
Layout
| Option | Default | Description |
|---|---|---|
| layout | single | single or split. |
| max | 5 | Maximum packages to show. |
Show
| Option | Default | Description |
|---|---|---|
| recipient | true | Recipient chip next to the carrier name, auto-detected or set per account (see the Sources section above). |
| status | true | Status line. |
| carrier | true | Carrier name. |
| brand_icon | true | Carrier logo. Requires custom-brand-icons. |
| details | true | Expandable chevron with extra info per package: event timeline, tracking code, package size, or letter scan. |
| badge | true | Days until delivery on the icon. |
| location | false | Last known location. |
Behaviour
| Option | Default | Description |
|---|---|---|
| dim_delivered | true | Delivered packages at reduced opacity. |
| hide_when_empty | false | Hide the card when there are no packages. |