One place for every shipment — with native providers, automatic fallback and a dedicated Home Assistant dashboard card.

Website & documentation · Installation · Support

English · Deutsch

---

Overview

PaketHub is a custom Home Assistant integration for parcel tracking through the official 17TRACK API v2.4. It adds native carrier support where available, falls back automatically when required and presents normalized shipment data as devices, entities and a purpose-built dashboard card.

Current integration version / Aktuelle Integrationsversion: 2.5.1

Features

• UI setup and configurable polling interval
• One Home Assistant device per shipment
• Central PaketHub device with counters, synchronization state, API connectivity and refresh button
• Status, location, latest event, last update, ETA, transit days and carrier sensors
• Full tracking history and accessible package-detail timeline
• Native UPS tracking with automatic 17TRACK fallback
• Extensible provider architecture and diagnostics
• Native Lovelace card with automatic shipment discovery
• German and English translations

Architecture

Tracking number / Trackingnummer
        ↓
Carrier detection / Carrier-Erkennung
        ↓
Native provider ── unavailable/error ──→ 17TRACK fallback
        ↓
Normalized shipment model
        ↓
Home Assistant devices, entities and PaketHub dashboard card

Installation

HACS

1. Open HACS and choose Custom repositories.
2. Add https://github.com/eifeldj/pakethub as an Integration.
3. Install PaketHub and restart Home Assistant.
4. Open Settings → Devices & services → Add integration.
5. Select PaketHub and enter your official 17TRACK API v2.4 key.

Manual installation / Manuelle Installation

Copy custom_components/pakethub to /config/custom_components/pakethub, restart Home Assistant and add PaketHub through the integrations UI.

Dashboard card

type: custom:pakethub-card
title: My packages
show_delivered: false
max_packages: 8
sort_by: status
tap_action: details

See dashboard/README.md for YAML-mode dashboards.

Actions

action: pakethub.add_package
data:
  tracking_number: EXAMPLE1234567890
  package_name: Example order

action: pakethub.remove_package
data:
  tracking_number: EXAMPLE1234567890

action: pakethub.refresh

Documentation

https://eifeldj.github.io/pakethub/

Contributing and support

Read CONTRIBUTING.md and SUPPORT.md.

Never publish API keys, full tracking numbers, addresses or private shipment details.

• Bug report
• Feature request
• Native provider request
• Security policy

Project links

Documentation · Releases · Roadmap · Changelog · License

_{Created and maintained by Volker Moeltgen · @eifeldj}