Screenshots From the README of robbrad/UKBinCollectionData.
About
UK Bin Collection Data is an integration that pulls bin collection dates from UK council websites and outputs them as JSON. It targets councils that offer no API, and most of its council scripts scrape web pages, while others emulate a browser or read CSV files. In Home Assistant it adds calendars and sensors for the next collection of each bin type. Setup happens in the UI, where the council details vary and can include a postcode, house number, property reference number or a Selenium web driver address. A JSON mapping can assign a colour and icon to each bin type, since councils do not supply colours, and it can be changed later by reconfiguring. It needs the vendor's cloud connection and is installed through the Marketplace, or HACS on 2026.10 and older.
Automatic summary of the README and code of robbrad/UKBinCollectionData. Something wrong, or are you the maintainer and want your own text here? Get in touch
Supports
Uses the vendor's cloud Needs an internet connection and an account with the vendor.
From the Marketplace Installed through the Marketplace, formerly HACS.
Actively maintained Its author released or pushed a change in the last six months.
Provides
- Sensors
- Calendars
Setting it up
Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.
Select the council
- Location name
- Council
- Enable automatic data refresh
- JSON to map Bin Type for Colour and Icon (see documentation)
Provide council details
- URL to fetch bin collection data
- The time in seconds for how long the sensor should wait for data
- Time in hours between updates
- UPRN (Unique Property Reference Number)
- Postcode of the address
- House number of the address
- USRN (Unique Street Reference Number)
- To run on a remote Selenium Server add the Selenium Server URL
- Run Selenium in headless mode (recommended)
- Don't run on remote Selenium server, use local install of Chrome instead
- Submit
Update council details
- URL to fetch bin collection data
- The time in seconds for how long the sensor should wait for data
- Time in hours between updates
- UPRN (Unique Property Reference Number)
- Postcode of the address
- House number of the address
- USRN (Unique Street Reference Number)
- To run on a remote Selenium Server add the Selenium Server URL
- Run Selenium in headless mode (recommended)
- Don't run on remote Selenium server, use local install of Chrome instead
- Enable automatic data refresh
- JSON to map Bin Type for Colour and Icon (see documentation)
- Submit
After setup
- Enable automatic data refresh
Texts from the code of robbrad/UKBinCollectionData.
From the README
This project aims to provide a neat and standard way of providing bin collection data in JSON format from UK councils that have no API to do so.
Why would you want to do this? You might want to use this in Home Automation—for example, say you had an LED bar that lit up on the day of bin collection to the colour of the bin you want to take out; then this repo provides the data for that.
Shows in Vulpo
Calendar card, Chart card, Apple Watch.Information
- Installs
- 1.2k sharing analytics
- GitHub stars
- 362
- Connection
- Uses the vendor's cloud
- Upkeep
- Updated in the last 6 months
- Version
- 0.173.5,
- Category
- Waste and recycling
- Kind
- Marketplace integration
- Needs
- Needs the Marketplace (HACS on 2026.10 and older)
- Domain
uk_bin_collection- Issues
- Report an issue












