Bin Collection

Bin Collection is a Home Assistant custom integration for Dutch waste collection calendars. Current version supports MijnAfvalwijzer and ACV (Ximmio), with a provider design intended for further other collectors.

It gives every configured address its own collection calendar, consistent Rest/Papier/GFT/PMD date sensors, provider notices, day-before reminders, and a compact Lovelace card.

Requirements

• Home Assistant 2026.7.0 or newer.

Install

HACS (Recommended)

1. Open HACS → ⋮ → Custom repositories.
2. Add hunter-nl/HA-Bin-Collection as an Integration repository.
3. Find Bin Collection, download it, and restart Home Assistant.
4. Add Bin Collection in Settings → Devices & services.

Manual

1. Copy custom_components/bin_collection to /config/custom_components/bin_collection.
2. Restart Home Assistant, then add Bin Collection in Settings → Devices & services. Each address is a separate integration entry.

The setup flow asks for provider, postcode, house number, and optional addition. Its options page controls the refresh period (six hours by default) and the day-before reminder (20:00 local time by default).

Upgrade

HACS

HACS checks hunter-nl/HA-Bin-Collection for published releases. Before upgrading, create a Home Assistant backup, read the release notes, download the release, and restart Home Assistant.

Manual

1. Create a Home Assistant backup.
2. Replace /config/custom_components/bin_collection with the custom_components/bin_collection directory from the desired GitHub release.
3. Restart Home Assistant.

Entities

For each address Bin Collection creates an all-collections calendar plus these stable sensors:

• Rest, Papier, GFT and PMD: the next pickup date for the category.
• Overview: the next pickup date and collections/notices attributes used by the card.
• Collector notices: the active notice count and full notice records.

Additional provider categories remain available in the Overview data instead of being silently discarded.

Dashboard card

For Home Assistant's standard storage-mode dashboards, Bin Collection automatically adds its bundled card as a JavaScript module resource. Then use the overview entity created for the address:

type: custom:bin-collection-card
entity: sensor.bin_collection_home_overview

The card shows the next pickups using Rest (grey), Papier (light blue), GFT (green), and PMD (orange), together with collector notices.

If you use Lovelace resource_mode: yaml, Home Assistant deliberately keeps resources in YAML. Add this resource to your Lovelace configuration instead:

resources:
  - url: /bin_collection/bin-collection-card.js?v=0.0.1-alpha
    type: module

Notifications and automations

New or changed collector notices and each scheduled reminder create a persistent Home Assistant notification. They also fire events, so users choose their own notify service rather than giving this integration device credentials:

• bin_collection.provider_notice: entry_id, title, body
• bin_collection.collection_reminder: entry_id, date, waste_types, message

Example mobile notification automation:

alias: Bin Collection reminder to phone
triggers:
  - trigger: event
    event_type: bin_collection.collection_reminder
actions:
  - action: notify.mobile_app_my_phone
    data:
      title: Bin Collection
      message: "{{ trigger.event.data.message }}"

Troubleshooting

Enable custom_components.bin_collection: debug in the logger configuration, refresh the integration entry, and include the provider and a redacted address when reporting an issue.

Support

• GitHub Issues
• Home Assistant Community

Funding

If you find this project useful, consider supporting its development: