Saturday, May 28, 2022
HomeTutorialsDomoticzDomoticz dzVents getGarbageDates script

Domoticz dzVents getGarbageDates script

This script is for Dutch users, that must place their containers on the street. But maybe it comes in hand as a nice example for others.

I often forget to check the calendar so I was happy that my local garbage collector (HVC) has made an app. An app that sends you a notification the day before. But the app doesn’t send always an app. So I searched for an alternative and found: Afval Nederland. dzVents getGarbageDates script Is now my alternative for the apps.

dzVents getGarbageDates script

It works very nice and has info for lots of collectors. But because of my love for Domoticz I want everything stored locally in my Domoticz overview. I asked the creator of the app for info and Waaren (from the Domoticz forum) made this fantastic DzVentz script for me.

Domoticz would show two devices: a text device that shows the next pickup dates, and an alert device that would inform you:

Domoticz Garbage collector

How to Setup?

It’s really simple:

Start your browser and go to
replace the red things with your info. for the url you can use the url of your collector:

Cyclus NV:
Afvalvrij / Circulus-Berkel:
Den Haag:
Alphen aan den Rijn: https://afvalkalender.alphenaandenrijn.nlrest/adressen/0505200000061116/afvalstromen

The output you get looks like this:

Write down your bagId number! that is the unique key of your address.
Then start domoticz and go to: settings > events
create a new script: give it a name like getGarbageDates, choose dzVents and choose for: device.

Paste the script below:

[ccen_lua width=”90%” line_numbers=”on”]

–[[ getGarbageDates.lua for [ dzVents >= 2.4 ]

This script is only useful in those areas of the Netherlands where the HVC group collects household garbage

Enter your zipcode and housenumber in the appropriate place between the lines starting with –++++
Next is to set your virtual text and or virtual alert device.

the text device will contain the most nearby collectdates for the four types of household garbage
the alert device will contain the date and type for the garbagecollecion that will arrive first

Ga naar de volgende url in de browser, waarbij je de juiste url voor jouw afvalverwerker kiest, en postcode en huisnummer wijzigd.
de output die je krijgt te zien bevat een bagID wat je later nodig hebt.

Dit bagId wordt gebruikt in de volgende URLs:
Ophaaldagen: <<replace BagID
De ophaaldagen gebruiken ID’s om aan te geven welk afvaltype het betreft.
Informatie over deze afvaltypes kan opgehaald worden via: <<replace BagID


return {
on = { timer = { “at 00:05″,”at 08:00” }, — daily run twice
— { timer = {‘every 1 minutes’},
httpResponses = { “getGarbage_Response” } — Trigger the handle Json part

logging = { level = domoticz.LOG_INFO, — Remove the “– at the beginning of this and next line for debugging the script
marker = “collectGarbage” },

data = { garbage = {initial = {} }, — Keep a copy of last json just in case

execute = function(dz, triggerObject)

–++++——————— Mandatory: Set your values and device names below this Line ————————————–
local myTextDevice = “Garbage” — Name with quotes or idx without when created as virtual text device
local myAlertDevice = “GarbageAlert” — Name with quotes or idx without when created as virtual alert device
local myBagId = “0505200000092263”
local myYear =“%Y”)

— it can happen that other examples then HVC uses other numbers, change them at line
garbageTypes = {6,5,3,2}

–++++—————————- Set your values and device names above this Line ——————————————–

local function collectGarbageDates(secondsFromNow)
local getGarbage_url = “” ..myBagId .. “/kalender/” .. myYear
dz.openURL ({ url = getGarbage_url ,
method = “GET”,
callback = “getGarbage_Response” }).afterSec(secondsFromNow)

— Add entry to log and notify to all subsystems
local function errorMessage(message)

local function string2Epoch(dateString) — seconds from epoch based on stringdate (used by string2Date)
— Assuming a date pattern like: yyyy-mm-dd
local pattern = “(%d+)-(%d+)-(%d+)”
local runyear, runmonth, runday= dateString:match(pattern)
local convertedTimestamp = os.time({year = runyear, month = runmonth, day = runday})
return convertedTimestamp

local function string2Date(str,fmt) — convert string from json into datevalue
if fmt then return,string2Epoch(str)) end
return” %A %d %B, %Y”,string2Epoch(str))

local function alertLevel(delta)
if delta < 2 then return dz.ALERTLEVEL_RED end
if delta < 3 then return dz.ALERTLEVEL_YELLOW end
if delta < 4 then return dz.ALERTLEVEL_ORANGE end

local function setGarbageAlertDevice(alertDevice,alertText,alertDate)
local delta = tonumber(string2Date(alertDate,”%d”)) – tonumber(“%d”)) — delta in days between today and first garbage collection date
return (delta == 0)

local function longGarbageName(str) — Use descriptive strings
str = tostring(str)
str = str:gsub(“6″,” Plastic verpakkingen, blik en drinkpakken “)
str = str:gsub(“5″,” Groente-, fruit- en tuin afval “)
str = str:gsub(“3″,” Papier en kartonnen verpakkingen “)
str = str:gsub(“2″,” Restafval “)
return str

local function handleResponse()
if #triggerObject.json > 0 then = triggerObject.json
rt = triggerObject.json
errorMessage(“Problem with response from hvcgroep (no data) using data from earlier run”)
rt = — json empty. Get last valid from
if #rt < 1 then — No valid data in either
errorMessage(“No previous data. are zipcode and housenumber ok and in HVC group area ?”)
return false
local garbageLines = “”
local typeEarliestDate
local overallEarliestDate = “2999-12-31” — Hopefully we will have a different garbage collection system by then
local garbageToday = false
local today =“%Y-%m-%d”)

for i = 1,#garbageTypes do –walk the the type Table
typeEarliestDate = “2999-12-31″
for j = 1,#rt do — walk the result Table
— walk the response table
if rt[j].ophaaldatum >= today and rt[j].ophaaldatum < typeEarliestDate and
rt[j].afvalstroom_id == garbageTypes[i] then — Keep date closest to today per type
typeEarliestDate = rt[j].ophaaldatum
if typeEarliestDate < overallEarliestDate then — date closest to today overall ?
overallEarliestDate = typeEarliestDate — keep date
overallEarliestType = garbageTypes[i] — keep type
garbageLines = garbageLines .. string2Date(typeEarliestDate,”%a %e %b” ) .. longGarbageName(rt[j].afvalstroom_id) .. ” ” .. “\n”
typeEarliestDate = rt[j].ophaaldatum — Keep date closest to today


if myAlertDevice then — Update AlertDevice with nearby date / type
garbageToday = setGarbageAlertDevice( myAlertDevice,
longGarbageName(overallEarliestType) .. “\n” ..

if myTextDevice then — Update defined virtual text device with dates / types

if dz.time.matchesRule(“at 08:00-17:00”) and garbageToday then
dz.notify(longGarbageName(overallEarliestType) .. “will be collected today”)

— Main
if triggerObject.isHTTPResponse then
if triggerObject.ok then
errorMessage(“Problem with response from hvcgroep (not ok)”)
collectGarbageDates(600) — response not OK, try again after 10 minutes


Addjust your settings in this script: BagId, and collector url. (I only have tested HVC)

You must create 2 virtual devices:

TextDevice with the name: Garbage
AlertDevice with the name GarbageAlert
You can name them as you like but also have to change the names in the script then.

The script runs daily run twice. But for setting up and testing it’s handy to adjust it. above the script you find:
= { timer = { “at 00:05″,”at 08:00” }, — daily run twice
— { timer = {‘every 1 minutes’},

Delete the 2 minuses —  and place them on the row above. it makes comments from the things after the –. so that your script runs every minute.

Save your script, and watch the logs!

When all is done don’t forget to switch the — again, so it runs twice a day, what would be enough.


Thanks Afval Nederland and Waaren!!!

Please if you have another working URL or feedback to improve let us know!

Chef Gadget-Freak
Likes gadgets. Does not like cheese, unless it's on a pizza.
- Advertisment -

Most Popular

Recent Comments