Skip to content

mampfes/hacs_waste_collection_schedule

Repository files navigation

Waste Collection Schedule logo

Waste Collection Schedule

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

Waste Collection Schedule animation

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.).

ICS/iCal and User-Specified
Australia
Austria
Belgium
Canada
Czech Republic
Denmark
Finland
France
Germany
Hungary
Ireland
Italy
Lithuania
Luxembourg
Malta
  • Malta / wastecollection.mt
Netherlands
New Zealand
Norway
Poland
Slovakia
Slovenia
Sweden
Switzerland
United Kingdom
United States of America

Installation

hacs badge hacs installs

Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.

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:

  • Adding new service providers
  • Updating or improving the documentation
  • Helping answer/fix any issues raised
  • Join in with the Home Assistant Community discussion

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

License

github license

This project uses the MIT License, for more details see the license document.

Showing Your Appreciation

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