Yodel parcel tracking for Home Assistant

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

Enjoying this? Help me out with a :beers: or :coffee:!

Installation through HACS

There is an active PR to get this into HACS, once that is merged then you can install the Yodel 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/Yodel into Repository field and select Integration

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

You can install the Yodel 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 yodel folder in your custom_components folder

Data

The integration creates a new entity for each active parcel on your Yodel 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.

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.