Skip to content

An integration that synchronises your Royal Mail tracking data with Home Assistant

License

Notifications You must be signed in to change notification settings

jampez77/RoyalMail

Repository files navigation

Logo Royal Mail parcel tracking for Home Assistant

This integration synchronises your Royal Mail tracking data and adds sensors to Home Assistant which can be used in your own automations.


GitHub Release License hacs_badge Project Maintenance

Enjoying this? Help me out with a 🍻 or ☕!

coffee

Installation through HACS

There is an active PR to get this into HACS, once that is merged then you can install the Royal Mail integration by searching for it there in HA instance.

Until then you will have to add this repository manually:

Go to HACS -> 3 dot menu -> Custom Repositories:-

Paste https://github.com/jampez77/RoyalMail into Repository field and select Integration

Now you should be able to find it in HACS as normal.

You can install the Royal Mail integration by searching for it there in HA instance.

Manual Installation

Use this route only if you do not want to use HACS and love the pain of manually installing regular updates.

  • Add the royalmail folder in your custom_components folder

Data

The integration creates a new entity for each parcel on you Royal Mail account with it's current delivery status, all other associated data are saved as attributes. Additionally there are entities for total mail pieces and total number of mail pieces that are due to be delivered today.

The integration will automatically remove a mail piece from your Royal Mail account and Home Assistant 24 hours after the delivery event.

Contributing

Contirbutions are welcome from everyone! By contributing to this project, you help improve it and make it more useful for the community. Here's how you can get involved:

How to Contribute

  1. Report Bugs: If you encounter a bug, please open an issue with details about the problem and how to reproduce it.
  2. Suggest Features: Have an idea for a new feature? I'd love to hear about it! Please open an issue to discuss it.
  3. Submit Pull Requests: If you'd like to contribute code:
    • Fork the repository and create your branch from main.
    • Make your changes in the new branch.
    • Open a pull request with a clear description of what you’ve done.

Royal Mail Tracking API

To acheive all that this integration does I reverse engineered the Royal Mail tracking API, here is everything i've found so far, i will keep it as up to date as i can.

Royal Mail Tracking API Document