Home Assistant RecycleApp Integration

Integrate RecycleApp into your Home Assistant.

Installation

• Install HACS Repository:

• Restart Home Assistant
• Install the Integration:

• Complete the setup process:

Date Format

By default, dates are in Home Assistant date format: %Y-%m-%d

You can customize the format in the configure of the device:

The formatting is based on Python date formatting.

You can also set the Date Format as TIMESTAMP to display relative dates, such as "in 2 days" or "next week". This option uses Home Assistant's built-in timestamp formatting and localization features.

Usage Samples

Dashboard with next pickups

With entity-filter:

type: entity-filter
entities:
  - sensor.pmc
  - sensor.papier
  - sensor.dechets_non_recyclables_sac
  - sensor.dechets_biodegradables
state_filter:
  - operator: <=
    value: 1
    attribute: days
card:
  type: entities

Templates

Tomorrow's Pickup(s)

Template helper

Code:

{% set tomorrow_pickups = namespace(entities=[]) %}
{% set collect_types = ['sensor.dechets_non_recyclables_sac', 'sensor.pmc', 'sensor.papier'] %}
{% for collect_type in collect_types %}
  {% if state_attr(collect_type, 'days') == 1 %}
    {% set tomorrow_pickups.entities = tomorrow_pickups.entities + [state_attr(collect_type, 'friendly_name')] %}
  {% endif %}
{% endfor %}
{{ tomorrow_pickups.entities |join(' - ') }}

Notification

alias: Waste collection
description: ""
trigger:
  - platform: time
    at: "19:00:00"
condition:
  - condition: template
    value_template: >-
      {% if is_state('sensor.tomorrow_s_pickup_s', '') %}false{% else %}true{%
      endif %}
action:
  - service: notify.mobile_app_poco_f5
    data:
      message: Tomorrow waste collection of {{states('sensor.tomorrow_s_pickup_s')}}
mode: single

Thanks to @MathiasVandePol for the sample.

Node-RED Integration

Looking for more advanced automation with Node-RED? Check out @v12345vtm's Node-RED flow that provides a template-based approach to send RecycleApp data to MQTT or other services.

The flow offers a flexible way to process and distribute your waste collection data throughout your home automation setup.

Bug, ideas?

If some collections are missing, you find a bug or have enhancement ideas don't hesitate to open an issue.

API Fair Use & Credits

A warm thank you to FostPlus for providing the RecycleApp service.

This integration is designed to use their public API respectfully and responsibly. If you represent FostPlus and wish to get in touch or learn more about the technical measures in place, please refer to API Fair Use Policy & Information.

License

This project is licensed under the MIT License.