aw-pop

This is a small tool to supervise your time allocation on different task categories, build on ActivityWatch.

If your current time allocation is not what you want, you can use this tool to help you. It will show warning message and minimize all windows when you have been working on one wrong task for a period of time.

The program read the categorization rules from aw-server , you can modify it in the WebUI.

Currently only works on Windows.

TODO

• afk-checking: If afk, don't pop. To reduce the standby power comsumption

Usage

Just change config.json, and run main.py. There will be a icon tray in the system tray, you can exit the program by right clicking the icon.

To run as a background service or startup program, you can use start pythonw.exe main.py, see run_bg.bat. Make sure you use the correct python interpreter.

Config file

See config.json

{
    "monitor_interval": 100,  # monitor interval in minutes
    "check_interval": 5,  # check time period in seconds
    "constraint":
    [
        {
            "term": ["Work"], #  categories to monitor
            "op": "ge", # operator to check, see python `operator` module
            "value": 0.7 # threshold
        }
    ]
}

It means all events under Work category should occupy at least 70% of non-afk time in the last 100 minutes. The program will check if this constraint is still not met in the last 5 seconds. If so, it will pop up a warning message and minimize all windows.

After changing the config file, you need to restart the program.