Skip to content

Latest commit

 

History

History
76 lines (44 loc) · 3.65 KB

info.md

File metadata and controls

76 lines (44 loc) · 3.65 KB

hacs_badge Garbage-Collection Maintenance

Buy me a coffee

{% if prerelease %}

NB!: This is a Beta version!

{% endif %}

Garbage Collection

The garbage_collection component is a Home Assistant custom helper for scheduling/monitoring regular garbage collection. The helper can be configured for weekly schedule (including multiple collection days), bi-weekly (in even or odd weeks), monthly schedule (nth day each month), or annual (e.g. birthdays). You can also configure seasonal calendars (e.g. for bio-waste collection) by configuring the first and last month. You can also group entities, which will merge multiple schedules into one sensor.

Examples

Images (picture-entity)

List view (entities)

Icon view (glance)

Garbage Collection custom card

Look to the repository for examples of Lovelace configuration.

Configuration

Go to Settings/Devices & Services/Helpers, click on the + CREATE HELPER button, select Garbage Collection and configure the helper.
If you would like to add more than one collection schedule, click on the + CREATE HELPER button again and add another Garbage Collection helper instance.

The configuration via configuration.yaml has been deprecated. If you have previously configured the integration there, it will be imported to ConfigFlow, and you should remove it.

For the configuration documentation check the repository file

STATE AND ATTRIBUTES

State

The state can be one of

Value Meaning
0 Collection is today
1 Collection is tomorrow
2 Collection is later

If the verbose_state parameter is set, it will show the date, and remaining days. For example "Today" or "Tomorrow" or "on 2019-09-10, in 2 days"

Attributes

Attribute Description
next_date The date of next collection
days Days till the next collection
last_collection The date and time of the last collection

Services

garbage_collection.collect_garbage

If the collection is scheduled for today, mark it completed and look for the next collection. It will set the last_collection attribute to the current date and time.

Attribute Description
entity_id The garbage collection entity id (e.g. sensor.general_waste)

For more details see the repository.