This repo shows how to integrate the waste collection schedule for properties in Aarhus into Homeassistant. It fetches the schedule from Kredsløb which exposes the schedules for the categories (Category names in Danish):

• Restaffald, madaffald
• Pap, Papir, tekstil
• Glas, Metal, Plast, Mad- og drikkekartoner

The webpage exposes an API which is used by this integration.

The script runs 4 times a day, since the schedule is not expected to update often. Initially it only ran once, however this meant that if it ran in the evening, the following day the schedule would be off until the evening. In order to change the frequency, update the scan_interval field which should be in seconds.

In order to make the script work, the first step is to identify the KVHX number for the given property. There is a utility script in this repo called get_kvhx.py which helps to identify the value, by looking up the property in DAWA.

>>> python get_kvhx.py "Tranekærvej 58, 8240"
Match: Tranekærvej 58, 8240
KVHX: 07518746__58_______

Copy the KVHX number and insert it into the sensor.yaml file under the resource as:

resource: https://portal-api.kredslob.dk/api/calendar/address/07518746__58_______

This should be done three times, as there are three sensors.

Next step is to copy the sensor.yaml file into your Homeassistant configuration directory, typically ~/.homeassistant and add the following line to configuration.yaml:

sensor: !include sensor.yaml