Here is a list of the common issues

The daemon does keeps updating every 240 minutes, even though I specified a lower value in the configuration file

This bug is usually caused by the fact that you specified a value that's too low for the daemon in your configuration file. The lowest value supported by the daemon is 60 minutes. If the value you specified is lower than 60 minutes, it will automatically change it to 240 minutes (which is the default value).

tblock module not found

When running TBlock as root, you can possibly get an error message such as:

importlib.metadata.PackageNotFoundError: No package metadata was found for tblock
ModuleNotFoundError: No module named 'tblock'

This is usually caused by the fact that you installed TBlock using pip and its --user option. To solve that, follow the steps below.

First, remove the Python package:

pip uninstall --user tblock

Next, install it again with pipx or any other installation method.

Daemon is unable to start: /usr/bin/tblockd does not exist

Depeding on the installation method you choose, the daemon might not be installed under /usr/bin/tblockd, but rather under /usr/bin/local/bin/tblockd.

To fix that, you simply have to create a symbolic link under /usr/bin/tblockd, pointing to the real executable:

ln -s /usr/local/bin/tblockd /usr/bin/tblockd