A custom component for Home Assistant that retrieves waste collection schedules from a wide range of service providers.
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.
Waste collection schedules in the following formats and countries are supported. Click on the section heading to view details of individual service providers.
ICS/iCal and User-Specified
Australia
- Banyule City Council / banyule.vic.gov.au
- Belmont City Council / belmont.wa.gov.au
- Brisbane City Council / brisbane.qld.gov.au
- Campbelltown City Council / campbelltown.nsw.gov.au
- City of Canada Bay Council / canadabay.nsw.gov.au
- Gold Coast City Council / goldcoast.qld.gov.au
- Inner West Council (NSW) / innerwest.nsw.gov.au
- Ipswich City Council / ipswich.qld.gov.au
- Ku-ring-gai Council / krg.nsw.gov.au
- Lake Macquarie City Council / lakemac.com.au
- Macedon Ranges Shire Council / mrsc.vic.gov.au
- Maribyrnong Council / maribyrnong.vic.gov.au/Residents/Bins-and-recycling
- Maroondah City Council / maroondah.vic.gov.au
- Melton City Council / melton.vic.gov.au
- Nillumbik Shire Council / nillumbik.vic.gov.au
- North Adelaide Waste Management Authority / nawma.sa.gov.au
- RecycleSmart / recyclesmart.com
- Stonnington City Council / stonnington.vic.gov.au
- The Hills Shire Council, Sydney / thehills.nsw.gov.au
- Wollongong City Council / wollongongwaste.com
- Wyndham City Council, Melbourne / wyndham.vic.gov.au
Austria
- Burgenländischer Müllverband / bmv.at
- infeo / infeo.at
- Stadtservice Korneuburg / korneuburg.gv.at
- Umweltprofis / umweltprofis.at
- WSZ Moosburg / wsz-moosburg.at
Canada
- City of Toronto / toronto.ca
Germany
- Abfall Stuttgart / service.stuttgart.de
- Abfall-Wirtschafts-Verband Nordschwaben / awv-nordschwaben.de
- Abfall.IO / AbfallPlus / abfallplus.de
- Abfallbewirtschaftung Ostalbkreis / goa-online.de
- Abfallkalender Würzburg / wuerzburg.de
- AbfallNavi (RegioIT.de) / regioit.de
- Abfalltermine Forchheim / abfalltermine-forchheim.de
- Abfallwirtschaft Alb-Donau-Kreis / aw-adk.de
- Abfallwirtschaft Lahn-Dill-Kreises / awld.de
- Abfallwirtschaft Landkreis Böblingen / awb-bb.de
- Abfallwirtschaft Landkreis Freudenstadt / awb-fds.de
- Abfallwirtschaft Landkreis Harburg / landkreis-harburg.de
- Abfallwirtschaft Landkreis Kitzingen / abfallwelt.de
- Abfallwirtschaft Landkreis Landsberg am Lech / abfallberatung-landsberg.de
- Abfallwirtschaft Landkreis Wolfenbüttel / alw-wf.de
- Abfallwirtschaft Neckar-Odenwald-Kreis / awn-online.de
- Abfallwirtschaft Nürnberger Land / nuernberger-land.de
- Abfallwirtschaft Ortenaukreis / abfallwirtschaft-ortenaukreis.de
- Abfallwirtschaft Rems-Murr / abfallwirtschaft-rems-murr.de
- Abfallwirtschaft Rendsburg / awr.de
- Abfallwirtschaft Stadt Fürth / abfallwirtschaft.fuerth.eu
- Abfallwirtschaft Stadt Nürnberg / nuernberg.de
- Abfallwirtschaft Stadt Schweinfurt / schweinfurt.de
- Abfallwirtschaft Südholstein / awsh.de
- Abfallwirtschaft Werra-Meißner-Kreis / zva-wmk.de
- Abfallwirtschaft Zollernalbkreis / abfallkalender-zak.de
- Abfallwirtschafts-Zweckverband des Landkreises Hersfeld-Rotenburg / azv-hef-rof.de
- Abfallwirtschaftsbetrieb Bergisch Gladbach / bergischgladbach.de
- Abfallwirtschaftsbetrieb Esslingen / awb-es.de
- Abfallwirtschaftsbetrieb Landkreis Ahrweiler / meinawb.de
- Abfallwirtschaftsbetrieb Landkreis Altenkirchen / awb-ak.de
- ALBA Berlin / berlin.alba.info
- ART Trier / art-trier.de
- ASO Abfall-Service Osterholz / aso-ohz.de
- AWA Entsorgungs GmbH / awa-gmbh.de
- AWB Bad Kreuznach / app.awb-bad-kreuznach.de
- AWB Köln / awbkoeln.de
- AWB Landkreis Augsburg / awb-landkreis-augsburg.de
- AWB Landkreis Bad Dürkheim / awb.kreis-bad-duerkheim.de
- AWB Landkreis Fürstenfeldbruck / awb-ffb.de
- AWB Landkreis Göppingen / awb-gp.de
- AWB Oldenburg / oldenburg.de
- AWB Westerwaldkreis / wab.rlp.de
- AWG Kreis Warendorf / awg-waf.de
- AWIDO Online / awido-online.de
- Bergischer Abfallwirtschaftverbund / bavweb.de
- Berlin Recycling / berlin-recycling.de
- Berliner Stadtreinigungsbetriebe / bsr.de
- Bielefeld / bielefeld.de
- Bogenschütz Entsorgung / bogenschuetz-entsorgung.de
- Bremener Stadreinigung / die-bremer-stadtreinigung.de
- Bürgerportal / c-trace.de
- C-Trace / c-trace.de
- Dillingen Saar / dillingen-saar.de
- Dinslaken / dinslaken.de
- EAD Darmstadt / ead.darmstadt.de
- EGN Abfallkalender / egn-abfallkalender.de
- EGST Steinfurt / egst.de
- EGW Westmünsterland / egw.de
- Entsorgungsbetriebe Essen / ebe-essen.de
- Gemeinde Lindlar / lindlar.de
- Gemeinde Roetgen / roetgen.de
- Gemeinde Unterhaching / unterhaching.de
- Göttinger Entsorgungsbetriebe / geb-goettingen.de
- Gütersloh / guetersloh.de
- Halver / halver.de
- Jumomind / jumomind.de
- KAEV Niederlausitz / kaev.de
- Kreis Coesfeld / wbc-coesfeld.de
- Kreis Heinsberg / kreis-heinsberg.de
- Kreis Pinneberg / kreis-pinneberg.de
- Kreiswirtschaftsbetriebe Goslar / kwb-goslar.de
- KV Cochem-Zell / cochem-zell-online.de
- KWU Entsorgung Landkreis Oder-Spree / kwu-entsorgung.de
- Landkreis Ansbach / landkreis-ansbach.de
- Landkreis Bayreuth / landkreis-bayreuth.de
- Landkreis Berchtesgadener Land / lra-bgl.de
- Landkreis Calw / kreis-calw.de
- Landkreis Coburg / landkreis-coburg.de
- Landkreis Erding / landkreis-erding.de
- Landkreis Erlangen-Höchstadt / erlangen-hoechstadt.de
- Landkreis Gotha / landkreis-gotha.de
- Landkreis Günzburg / kaw.landkreis-guenzburg.de
- Landkreis Heilbronn / landkreis-heilbronn.de
- Landkreis Kelheim / landkreis-kelheim.de
- Landkreis Kronach / landkreis-kronach.de
- Landkreis Limburg-Weilburg / awb-lm.de
- Landkreis Nordwestmecklenburg / geoport-nwm.de
- Landkreis Ostallgäu / buerger-ostallgaeu.de
- Landkreis Rhön Grabfeld / abfallinfo-rhoen-grabfeld.de
- Landkreis Rosenheim / abfall.landkreis-rosenheim.de
- Landkreis Rotenburg (Wümme) / lk-awr.de
- Landkreis Schweinfurt / landkreis-schweinfurt.de
- Landkreis Schwäbisch Hall / lrasha.de
- Landkreis Sigmaringen / landkreis-sigmaringen.de
- Landkreis Südliche Weinstraße / suedliche-weinstrasse.de
- Landkreis Tirschenreuth / kreis-tir.de
- Landkreis Tübingen / abfall-kreis-tuebingen.de
- Landkreis Wittmund / landkreis-wittmund.de
- Landkreisbetriebe Neuburg-Schrobenhausen / landkreisbetriebe.de
- Landratsamt Aichach-Friedberg / lra-aic-fdb.de
- Landratsamt Dachau / landratsamt-dachau.de
- Landratsamt Traunstein / traunstein.com
- Landratsamt Unterallgäu / landratsamt-unterallgaeu.de
- Ludwigshafen am Rhein / ludwigshafen.de
- MZV Biedenkopf / mzv-biedenkopf.de
- MüllALARM / Schönmackers / schoenmackers.de
- Müllmax / muellmax.de
- Neunkirchen Siegerland / neunkirchen-siegerland.de
- Neustadt a.d. Waldnaab / neustadt.de
- Pullach im Isartal / pullach.de
- RegioEntsorgung Städteregion Aachen / regioentsorgung.de
- Rhein-Hunsrück Entsorgung (RHE) / rh-entsorgung.de
- Rhein-Neckar-Kreis / rhein-neckar-kreis.de
- Sector 27 - Datteln, Marl, Oer-Erkenschwick / muellkalender.sector27.de
- Stadt Aachen / aachen.de
- Stadt Cottbus / cottbus.de
- Stadt Dorsten / ebd-dorsten.de
- Stadt Kaufbeuren / kaufbeuren.de
- Stadt Landshut / landshut.de
- Stadt Memmingen / umwelt.memmingen.de
- Stadt Norderstedt / betriebsamt-norderstedt.de
- Stadt Regensburg / regensburg.de
- Stadt Solingen / solingen.de
- Stadt Unterschleißheim / unterschleissheim.de
- Stadt Willich / stadt-willich.de
- Stadtreinigung Dresden / dresden.de
- Stadtreinigung Hamburg / stadtreinigung.hamburg
- Stadtreinigung Leipzig / stadtreinigung-leipzig.de
- StadtService Brühl / stadtservice-bruehl.de
- STL Lüdenscheid / stl-luedenscheid.de
- Städteservice Raunheim Rüsselsheim / staedteservice.de
- Südbrandenburgischer Abfallzweckverband / sbazv.de
- WBO Wirtschaftsbetriebe Oberhausen / wbo-online.de
- Wermelskirchen / wermelskirchen.de
- WGV Recycling GmbH / wgv-quarzbichl.de
- Wolfsburger Abfallwirtschaft und Straßenreinigung / was-wolfsburg.de
- WZV Kreis Segeberg / wzv.de
- ZAW Darmstadt-Dieburg / zaw-online.de
- Zweckverband Abfallwirtschaft Saale-Orla / zaso-online.de
- Zweckverband München-Südost / zvmso.de
Lithuania
- Kauno švara / grafikai.svara.lt
Netherlands
- ACV Group / acv-afvalkalender.nl
- Alpen an den Rijn / alphenaandenrijn.nl
- Area Afval / area-afval.nl
- Avalex / avalex.nl
- Avri / avri.nl
- Bar Afvalbeheer / bar-afvalbeheer.nl
- Circulus / mijn.circulus.nl
- Cyclus NV / cyclusnv.nl
- Dar / dar.nl
- Den Haag / denhaag.nl
- GAD / gad.nl
- Gemeente Almere / almere.nl
- Gemeente Berkelland / gemeenteberkelland.nl
- Gemeente Cranendonck / cranendonck.nl
- Gemeente Hellendoorn / hellendoorn.nl
- Gemeente Lingewaard / lingewaard.nl
- Gemeente Meppel / meppel.nl
- Gemeente Middelburg + Vlissingen / middelburgvlissingen.nl
- Gemeente Peel en Maas / peelenmaas.nl
- Gemeente Schouwen-Duiveland / schouwen-duiveland.nl
- Gemeente Sudwest-Fryslan / sudwestfryslan.nl
- Gemeente Venray / venray.nl
- Gemeente Voorschoten / voorschoten.nl
- Gemeente Wallre / waalre.nl
- Gemeente Westland / gemeentewestland.nl
- HVC Groep / hvcgroep.nl
- Meerlanden / meerlanden.nl
- Mijn Blink / mijnblink.nl
- PreZero / prezero.nl
- Purmerend / purmerend.nl
- RAD BV / radbv.nl
- Reinigingsbedrijf Midden Nederland / rmn.nl
- Reinis / reinis.nl
- Spaarne Landen / spaarnelanden.nl
- Stadswerk 072 / stadswerk072.nl
- Twente Milieu / twentemilieu.nl
- Waardlanden / waardlanden.nl
- Ximmio / ximmio.nl
- ZRD / zrd.nl
New Zealand
- Auckland Council / aucklandcouncil.govt.nz
- Christchurch City Council / ccc.govt.nz
- Gore, Invercargill & Southland / wastenet.org.nz
- Horowhenua District Council / horowhenua.govt.nz
- Waipa District Council / waipadc.govt.nz
- Wellington City Council / wellington.govt.nz
Norway
- Min Renovasjon / norkart.no
- Oslo Kommune / oslo.kommune.no
- Stavanger Kommune / stavanger.kommune.no
Poland
- Ecoharmonogram / ecoharmonogram.pl
- Warsaw / warszawa19115.pl
Slovenia
- Moji odpadki, Ljubljana / mojiodpadki.si
Sweden
- Jönköping - June Avfall & Miljö / juneavfall.se
- Landskrona - Svalövs Renhållning / lsr.nu
- Lerum Vatten och Avlopp / vatjanst.lerum.se
- Linköping - Tekniska Verken / tekniskaverken.se
- Region Gotland / gotland.se
- Ronneby Miljöteknik / fyrfackronneby.se
- SRV Återvinning / srvatervinning.se
- SSAM / ssam.se
- Sysav Sophämntning / sysav.se
- VA Syd Sophämntning / vasyd.se
- Västblekinge Miljö AB Sophämtning / vmab.se
Switzerland
- A-Region / a-region.ch
- Andwil / a-region.ch
- Appenzell / a-region.ch
- Berg / a-region.ch
- Bühler / a-region.ch
- Eggersriet / a-region.ch
- Gais / a-region.ch
- Gaiserwald / a-region.ch
- Goldach / a-region.ch
- Grosswangen / grosswangen.ch
- Grub / a-region.ch
- Heiden / a-region.ch
- Herisau / a-region.ch
- Horn / a-region.ch
- Hundwil / a-region.ch
- Häggenschwil / a-region.ch
- Lindau / lindau.ch
- Lutzenberg / a-region.ch
- Muolen / a-region.ch
- Mörschwil / a-region.ch
- Münchenstein / muenchenstein.ch
- Rehetobel / a-region.ch
- Rorschach / a-region.ch
- Rorschacherberg / a-region.ch
- Schwellbrunn / a-region.ch
- Schönengrund / a-region.ch
- Speicher / a-region.ch
- Stein / a-region.ch
- Steinach / a-region.ch
- Teufen / a-region.ch
- Thal / a-region.ch
- Trogen / a-region.ch
- Tübach / a-region.ch
- Untereggen / a-region.ch
- Urnäsch / a-region.ch
- Wald / a-region.ch
- Waldkirch / a-region.ch
- Waldstatt / a-region.ch
- Wittenbach / a-region.ch
- Wolfhalden / a-region.ch
United Kingdom
- Amber Valley Borough Council / ambervalley.gov.uk
- Ashfield District Council / ashfield.gov.uk
- Bracknell Forest Council / selfservice.mybfc.bracknell-forest.gov.uk
- Bradford Metropolitan District Council / bradford.gov.uk
- Braintree District Council / braintree.gov.uk
- Breckland Council / breckland.gov.uk/mybreckland
- Cambridge City Council / cambridge.gov.uk
- Canterbury City Council / canterbury.gov.uk
- Central Bedfordshire Council / centralbedfordshire.gov.uk
- Cheshire East Council / cheshireeast.gov.uk
- Chesterfield Borough Council / chesterfield.gov.uk
- Chichester District Council / chichester.gov.uk
- City of York Council / york.gov.uk
- Colchester City Council / colchester.gov.uk
- Cornwall Council / cornwall.gov.uk
- Derby City Council / derby.gov.uk
- East Cambridgeshire District Council / eastcambs.gov.uk
- East Herts Council / eastherts.gov.uk
- Eastbourne Borough Council / lewes-eastbourne.gov.uk
- Elmbridge Borough Council / elmbridge.gov.uk
- Environment First / environmentfirst.co.uk
- FCC Environment / fccenvironment.co.uk
- Glasgow City Council / glasgow.gov.uk
- Guildford Borough Council / guildford.gov.uk
- Harborough District Council / harborough.gov.uk
- Harlow Council / harlow.gov.uk
- Horsham District Council / horsham.gov.uk
- Huntingdonshire District Council / huntingdonshire.gov.uk
- Lewes District Council / lewes-eastbourne.gov.uk
- London Borough of Lewisham / lewisham.gov.uk
- Maldon District Council / maldon.gov.uk
- Manchester City Council / manchester.gov.uk
- Middlesbrough Council / middlesbrough.gov.uk
- Newcastle City Council / community.newcastle.gov.uk
- Newcastle Under Lyme Borough Council / newcastle-staffs.gov.uk
- Newport City Council / newport.gov.uk
- North Somerset Council / n-somerset.gov.uk
- Nottingham City Council / nottinghamcity.gov.uk
- Oxford City Council / oxford.gov.uk
- Peterborough City Council / peterborough.gov.uk
- Richmondshire District Council / richmondshire.gov.uk
- Rushmoor Borough Council / rushmoor.gov.uk
- Salford City Council / salford.gov.uk
- Sheffield City Council / sheffield.gov.uk
- South Cambridgeshire District Council / scambs.gov.uk
- South Derbyshire District Council / southderbyshire.gov.uk
- South Hams District Council / southhams.gov.uk
- South Norfolk and Broadland Council / area.southnorfolkandbroadland.gov.uk
- Southampton City Council / southampton.gov.uk
- Stevenage Borough Council / stevenage.gov.uk
- Stockport Council / stockport.gov.uk
- Telford and Wrekin Council / telford.gov.uk
- Tewkesbury Borough Council / tewkesbury.gov.uk
- The Royal Borough of Kingston Council / kingston.gov.uk
- Walsall Council / walsall.gov.uk
- Waverley Borough Council / waverley.gov.uk
- West Berkshire Council / westberks.gov.uk
- West Devon Borough Council / westdevon.gov.uk
- Wiltshire Council / wiltshire.gov.uk
- Wyre Forest District Council / wyreforestdc.gov.uk
United States of America
- City of Pittsburgh / pgh.st
- Republic Services / republicservices.com
- Seattle Public Utilities / myutilities.seattle.gov
The 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. For further details see the installation and configuration page, or the FAQ.
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 contribution guidelines, or take a look at our online mentions.
The following waste service providers return errors when running the test_source script:
banyule_vic_gov_au
: JSONDecodeError, caused by not supported Captcha wallawn_de
: all tests return 0 entries
If you can fix any of these, please raise a Pull Request with the updates.
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
This project uses the MIT Licence, for more details see the licence document.
If you like this project, please give it a star on GitHub or consider becoming a Sponsor.