Package Tracker Card: Home Assistant parcel tracking card

Note

This card is vibe coded

A Home Assistant Lovelace card that shows your packages from multiple carrier integrations in one clean, unified view.

---

Features

• 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.

---

Installation

1. Go to HACS → three-dot menu → Custom repositories.
2. Enter https://github.com/klaptafel/ha-package-tracker-card, category Dashboard, click Add.
3. Find Package Tracker Card and click Download.

---

Configuration

The visual editor covers everything: Sources, Filter, Appearance.

Sources

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.

Filter

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.

Appearance

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.