Day Off Tracker

I needed a way to manage several QA’s, scenes and automation scenarios differently on weekends and public holidays.

For example, my blinds normally open early on weekdays — which quickly became annoying on days off when everyone wanted to sleep longer. Same thing for the coffee maker and several other morning automations...

So I created a simple solution based on a global variable called DayOffToday.

When DayOffToday = YES my scenes can prevent or delay their execution automatically on weekends or public holidays.

 

How it works

Day Off Tracker first identifies your country by geolocating your HC3 box using the Nominatim / OpenStreetMap API.
(You can also manually select your country from a list of more than 100 countries)

The QA then retrieves all public holidays for your country using the Nager.Date API and automatically sets the global variable: DayOffToday = YES when the current day matches a public holiday.

The QuickApp also displays a countdown until the next public holiday.

 

Using the global variable

All your scenes and QA’s simply need to check the value of DayOffToday.

Both of these methods work:

hub.getGlobalVariable("DayOffToday")

 or 

api.get("/globalVariables/DayOffToday")

The variable value is always either:

• YES
• NO

 

As for GEA users, the condition to add is the following (use YES or NO depending on your need):

{"Global", "DayOffToday", "YES"}

 

Weekend Mode

A new WEEKEND MODE switch button allows you to enable or disable weekends being considered as days off.

 

QA Icon

The QuickApp icon is installed automatically when importing the .fqa file.

However, the icon is also included separately as a .png file inside the ZIP archive, in case you wish to reassign it manually or customize it later.

 

Important setup notes

After importing the .fqa file, you should provide your email address in the QA variables.

This is recommended in order to comply with the Nominatim / OpenStreetMap usage policy when geolocation requests are performed.
(The QA will still work without it, but good practice is appreciated.)

Also make sure that "Use the new views in mobile application" remains unchecked in the QA Advanced Settings.

↑ uncheck this ↑

The QA relies on HTML rendering, and enabling this option may break the display inside the mobile apps. A safety routine has been added to automatically force the correct setting whenever possible.

If an update is available, a download link will automatically appear at the bottom of the QuickApp.

 

Final note

I'm not a professional programmer — I created this QuickApp for my own use during my spare time.

There are probably bugs hiding somewhere, and the QA may occasionally crash or behave unexpectedly.

If you'd like to help improve or debug it, you're more than welcome.

And if you enjoy this QA, feel free to leave a rating or a review, and even help me focus while coding by buying me a coffee ♥ 

 

Changelog 

 

 v2.1 - 28/05/2026 

• Updated QuickApp icon + automatic icon installation
• Added version check mechanism
• 123 countries support from Nager.Date API
• Improved UI color scheme for better dark/light theme integration

 

 v2.0 - 14/09/2025 

• Added Weekend Mode switch
• Forced 'Use the new views in mobile application' property
• Added Next Day Off countdown display
• Improved layout and overall UI structure

 

v1.0 - 07/09/2025 

• Initial release
• Email validation check
• Auto-reload if no country or invalid country is set
• 117 countries support from Nager.Date API

 

 

Credits

• Nager.Date Worldwide Public Holiday API
• Nominatim open-source geocoding with OpenStreetMap