WorkPulse: tracking your active time on screen

Hi folks,

As things are usually solved, I was losing track of my work time (since I work from home) and created a simple bash script that would log my daily screen time (not including lock screen or suspend). This worked well for me so I created a Python package to share this.

WorkPulse is a Python CLI app that sets up a timer and logs active daily time to a database. The reason I’m sharing this here is because I have added a feature to share this information with Home Assistant using MQTT.

Here’s the link: workpulse · PyPI

There are usage instructions on the PyPi page and my Github repo is linked there as well!

It looks like this on my HA dashboard:

Current limitations are:

  • it only works on Linux machines that use systemd.
  • the tool generates the YAML snippet that you must add to the configuration.yaml on HA. I have not yet tried automatic discovery for this.

Support for other systems is very welcome, as it is obviously a tool currently limited to a certain environment.

Feel free to submit PRs or recommendations.

Best regards,
Filipe