TimeTagger Watcher is a simple Python script designed to track your current task from TimeTagger and log it to an ActivityWatch bucket. This seamless integration can help you monitor your productivity and understand how your time is being allocated.
Before running the script, please ensure you have the following installed on your system:
- Python 3.x
- Requests package:
pip install requests - ActivityWatch Client package:
pip install aw-client
Set environment variables for your TimeTagger URL, token, and optionally, the log level:
export TIMETAGGER_URL="https://yourtimetagger.url/api/v2/records"
export TIMETAGGER_TOKEN="yourtimetaggertoken"
export LOG_LEVEL="INFO" # Default is WARNING, options: DEBUG, INFO, WARNING, ERROR, CRITICALFor local or self-signed certificates, you may disable SSL verification in the script by keeping VERIFY_CERTIFICATE = False.
To start tracking your TimeTagger tasks with ActivityWatch, simply run the timetagger_watcher.py script:
python timetagger_watcher.pyAssuming your TimeTagger URL is https://timetagger.example.com/timetagger/api/v2/records and you have received a token, the setup would be:
export TIMETAGGER_URL="https://timetagger.example.com/timetagger/api/v2/records"
export TIMETAGGER_TOKEN="your_unique_token_here"
export LOG_LEVEL="INFO"After setting these environment variables, run the script:
python timetagger_watcher.pyThe log level INFO allows you to see informative messages providing insight into the script's operations and any issues encountered.
This script is meant to run continuously. If you wish to execute it in a more robust environment (e.g., background service), you may need to take additional steps to daemonize the script or monitor it with a tool like supervisor or systemd.
Your contributions to improve TimeTagger Watcher are welcome! Please feel free to fork the repository, make your changes, and submit a pull request.
This project is licensed under the MIT License. Please see the LICENSE.md file for details.