Afvalbeheer provides Home Assistant sensors and a calendar entity for multiple Dutch and Belgian waste collectors using REST APIs.
⚠️ Important Notice: YAML configuration is deprecated as of v6.0.0. All new installations and configurations should use the Home Assistant UI (Config Flow). Existing YAML configurations will automatically be imported and should be removed form configuration.yaml after migration.
This integration works with many waste collectors, including:
ACV, Afval3xBeter, Afvalstoffendienstkalender, AfvalAlert, Alkmaar, Almere, AlphenAanDenRijn, AreaReiniging, Assen, Avalex, Avri, BAR, Berkelland, Blink, Circulus, Cleanprofs, Cranendonck, Cure (use MijnAfvalwijzer), Cyclus, DAR, DeAfvalApp, DeFryskeMarren, DenHaag, Drimmelen, GAD, Hellendoorn, HVC, Irado, Limburg.NET (requires streetname and cityname), Lingewaard, Maassluis, Meerlanden, Meppel, Middelburg-Vlissingen, MijnAfvalwijzer, Mijnafvalzaken, Montferland, Montfoort, Nijkerk Ôffalkalinder, Omrin, OudeIJsselstreek, PeelEnMaas, PreZero, Purmerend, RAD, RecycleApp (requires streetname), RD4, RWM, Reinis, ROVA, RMN, Saver, Schouwen-Duiveland, Sliedrecht, Spaarnelanden, SudwestFryslan, TwenteMilieu, Uithoorn, Venray, Voorschoten, Waalre, Waardlanden, Westland, Woerden, ZRD, Groningen.
- Search for "Afvalbeheer" in HACS and install. Included by default.
- Copy the files from
/custom_components/afvalbeheer/to[homeassistant]/config/custom_components/afvalbeheer/.
- Sensor entities for each waste type and for upcoming collections (today, tomorrow, next upcoming)
- Calendar entity showing all upcoming waste collection events (see below)
- Support for custom naming, icons, translations, and advanced mapping
- Easy configuration through Home Assistant UI (Config Flow)
This integration automatically creates a calendar entity (calendar.afvalbeheer_<name>) that shows all upcoming waste collection events for your address and selected waste types. You can use this entity in Home Assistant dashboards, automations, or notifications just like any other calendar.
- Go to Settings → Devices & Services in Home Assistant
- Click Add Integration and search for "Afvalbeheer"
- Follow the multi-step configuration wizard:
- Step 1: Select your waste collector from the dropdown
- Step 2: Enter your address details (postcode, street number, and suffix if applicable)
- Step 3: Select which waste types you want sensors for
- Step 4: Configure display options (date format, icons, naming, etc.)
All configuration options are available through the UI, including:
- Waste collector selection
- Address information (postcode, street number, suffix)
- Special address fields (streetname for RecycleApp/Limburg.NET, cityname for Limburg.NET)
- Waste type selection from available resources
- Display options (date format, upcoming sensors, icons, Dutch translation)
- Custom naming and prefixes
To set up multiple instances (e.g., for different addresses), simply add the integration multiple times through the UI. Each instance will have its own set of sensors and calendar entity with unique naming based on your configuration.
⚠️ YAML configuration is deprecated as of v6.0.0 and will be removed in a future version. Please migrate to Config Flow (UI configuration) for new installations.
Click to view legacy YAML configuration examples
afvalbeheer:
wastecollector: Blink
resources:
- restafval
- gft
- papier
- pmd
postcode: 1111AA
streetnumber: 1
suffix: a # (optional)
upcomingsensor: 0 # (optional)
dateformat: '%d-%m-%Y' # (optional)
dateonly: 0 # (optional)
name: "" # (optional)
nameprefix: 1 # (optional)
builtinicons: 0 # (optional)
dutch: 0 # (optional)afvalbeheer:
- wastecollector: Blink
resources:
- restafval
- gft
- papier
- pmd
postcode: 1111AA
streetnumber: 1
- wastecollector: Blink
resources:
- restafval
- gft
- papier
- pmd
postcode: 1111AA
streetnumber: 2Sensor names are built as: [WasteCollector] [CustomName] WasteType
- If Name Prefix is enabled (default):
WasteCollector CustomName WasteType - If Name Prefix is disabled:
CustomName WasteType - If Custom Name is empty:
WasteCollector WasteType
Examples:
- With waste collector "Blink", custom name "Buiten", name prefix enabled:
sensor.blink_buiten_restafval - With waste collector "Blink", no custom name, name prefix enabled:
sensor.blink_restafval - With custom name "Buiten", name prefix disabled:
sensor.buiten_restafval
Calendar names are always: Afvalbeheer WasteCollector
- Example:
calendar.afvalbeheer_blink
All configuration options are available through the Home Assistant UI (Config Flow). Here's what each option does:
Choose from the supported list above. This determines which API the integration will use to fetch your waste collection data.
- Postcode: Required for all collectors
- Street Number: Required for all collectors
- Suffix: Optional (e.g., "a", "bis")
- Street Name: Required for Limburg.NET and RecycleApp collectors
- City Name: Required for Limburg.NET collector
Select which waste types you want sensors for. At least one is required. Available options depend on your collector:
Common types:
- restafval (residual waste)
- gft (organic waste)
- papier (paper)
- pmd (plastic/metal/drink cartons)
Additional types (collector-dependent):
- gftgratis, textiel, glas, grofvuil, asbest, apparaten, chemisch, sloopafval, takken, pbd, duobak, restwagen, sortibak
- Upcoming Sensor: Adds 3 extra sensors (today, tomorrow, next upcoming) for automations
- Date Format: Customize how dates are displayed using Python strftime options. Default: '%d-%m-%Y'
- Date Only: Remove day name/today/tomorrow prefix from sensor states
- Day of Week: Add day name to sensor state if collection is within 7 days
- Day of Week Only: Show only day name when
Day of Weekis enabled - Always Show Day: Remove 7-day limit for showing day names
- Date Object: Return sensor state as date-time object instead of string
- Name: Custom name for your sensors (useful for multiple instances)
- Name Prefix: Include waste collector name in sensor names (enabled by default)
- Built-in Icons: Use integration's built-in icons instead of collector-provided icons
- New Built-in Icons: Use newer icon set (requires Built-in Icons enabled)
- Disable Icons: Disable entity pictures to use custom MDI icons
Built-in Icons:
New Built-in Icons:
- Dutch: Display day names in Dutch instead of English
If the integration cannot retrieve data from your waste collector (e.g., due to network issues or API changes), the previous valid data will be kept and a persistent notification may be shown in Home Assistant. Check the Home Assistant logs for more details if you encounter issues.
- Omrin API - @Jordi1990