Skip to content

Custom Home Assistant integration for Matkahuolto package tracking

Notifications You must be signed in to change notification settings

jesmak/matkahuolto_tracking

Repository files navigation

Matkahuolto package tracking for Home Assistant

What is it?

A custom component that integrates with Matkahuolto to retrieve information about coming and recently delivered packages. The big idea of this integration is that one does not have to manually add packages in order to track them, but the list is updated automatically by retrieving tracking data from the user's account.

Installation

With HACS

  1. Add this repository to HACS custom repositories
  2. Search for Matkahuolto package tracking in HACS and install with type integration
  3. Restart Home Assistant
  4. Enter your account credentials and configure other settings as you wish

Manual

  1. Download source code from latest release tag
  2. Copy custom_components/matkahuolto_tracking folder to your Home Assistant installation's config/custom_components folder.
  3. Restart Home Assistant
  4. Configure the integration by adding a new integration in settings/integrations page of Home Assistant
  5. Enter your account credentials and configre other settings as you wish

Integration settings

Name Type Requirement Description Default
username string Required Username of your Matkahuolto account (your email)
password string Required Password of your Matkahuolto account
language string Required Used language (fi or en) en
prioritize_undelivered boolean Required Toggle this if you want undelivered packages to be shown first, when there are more than the maximum allowed amount of packages available true
max_shipments int Required Maximum number of packages to retrieve 5
stale_shipment_day_limit int Required After how many days a stalled shipment gets hidden? Sometimes shipments stay in "in delivery" state indefinitely 15
completed_shipment_day_shown int Required After how many days are completed deliveries hidden? 3

About

Custom Home Assistant integration for Matkahuolto package tracking

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages