Home

Awesome

<!-- GitHub Markdown Reference: https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github --> <img src="https://raw.githubusercontent.com/mampfes/hacs_waste_collection_schedule/master/images/icon.png" alt="Waste Collection Schedule logo" title="Waste Collection Schedule" align="right" height="60" />

Waste Collection Schedule

A custom component for Home Assistant that retrieves waste collection schedules from a wide range of service providers.

<img src="https://raw.githubusercontent.com/mampfes/hacs_waste_collection_schedule/master/images/wcs_animated.gif" alt="Waste Collection Schedule animation" title="Waste Collection Schedule" align="right" height="200" />

Waste collection schedules from service provider web sites are updated daily, derived from local ICS/iCal files, or generated from user-specified dates or regularly repeating date patterns. The Home Assistant built-in Calendar is automatically populated with schedules, and there is a high degree of flexibility in how information can be format and displayed in entity cards or pop-ups. The framework can easily be extended to support additional waste collection service providers, or other services which provide schedules.

Supported Service Providers

Waste collection schedules in the following formats and countries are supported. Click on the section heading to view details of individual service providers.

If your service provider is not listed, feel free to open a source request issue (please first check the Issues section if there already is an open issue for your service provider.).

<details> <summary>ICS/iCal and User-Specified</summary> </details> <!--Begin of country section--> <details> <summary>Australia</summary> </details> <details> <summary>Austria</summary> </details> <details> <summary>Belgium</summary> </details> <details> <summary>Canada</summary> </details> <details> <summary>Czech Republic</summary> </details> <details> <summary>Denmark</summary> </details> <details> <summary>Finland</summary> </details> <details> <summary>France</summary> </details> <details> <summary>Germany</summary> </details> <details> <summary>Hungary</summary> </details> <details> <summary>Italy</summary> </details> <details> <summary>Lithuania</summary> </details> <details> <summary>Luxembourg</summary> </details> <details> <summary>Netherlands</summary> </details> <details> <summary>New Zealand</summary> </details> <details> <summary>Norway</summary> </details> <details> <summary>Poland</summary> </details> <details> <summary>Slovenia</summary> </details> <details> <summary>Sweden</summary> </details> <details> <summary>Switzerland</summary> </details> <details> <summary>United Kingdom</summary> </details> <details> <summary>United States of America</summary> </details> <!--End of country section-->

Installation

hacs badge hacs installs

Waste Collection Schedule can be installed via HACS, or by manually copying the waste_collection_schedule directory to Home Assistant's config/custom_components/ directory.

Configuration

This integration can be configured through the Home Assistant UI. From the Devices & Services page click 'Add Integration' and search for 'Waste Collection Schedule'.

Alternatively, Waste Collection Schedule can be configured manually in the yaml configuration files. This is required for certain advanced options. For further details see the installation and configuration page, or the FAQ.

Contributing To The Project

python badge github contributors last commit Community Discussion

There are several ways of contributing to this project, they include:

For further details see contributing guidelines, or take a look at our online mentions.

<!-- # Development Roadmap The top 3 things on the development wish-list are: - [ ] idea #1 - short description - [ ] idea #2 - short description - [ ] idea #3 - short description If you'd like to help with any of these, please raise an [issue](https://github.com/mampfes/hacs_waste_collection_schedule/issues) indicating which item you'd like to work on. --> <!-- # Code of Conduct Not sure if this is relevant for this project. -->

Known Issues

The following waste service providers return errors when running the test_source script:

If you can fix any of these, please raise a Pull Request with the updates.

Home Assistant Hangs

Problem: Home Assistant hangs during restart or configuration check. This occurs typically after Waste Collection Schedule has been added to the configuration.

Root Cause: Home Assistant tries to install the required Python packages and fails somehow. This is not an issue of Waste Collection Schedule.

Solution: Try to reinstall Waste Collection Schedule (if you are using HACS) or install the required Python packages manually. This list of required packages can be found in manifest.json.

The actual procedure depends on your Home Assistant installation type.

Example:

sudo docker exec -it homeassistant /bin/bash
pip list
pip install recurring_ical_events  # in case recurring_ical_events is missing

Licence

github licence

This project uses the MIT Licence, for more details see the licence document.

Showing Your Appreciation

If you like this project, please give it a star on GitHub or consider becoming a Sponsor.