TimeTagger

Tag your time, get the insight - an open source time tracker with a focus on a simple and interactive user experience.

• Website: https://timetagger.app
• Docs: https://timetagger.readthedocs.io
• CLI tool: https://github.com/almarklein/timetagger_cli

Introduction

TimeTagger is a web-based time-tracking solution that can be run locally or on a server. In the latter case, you'll want to add authentication, and also be aware of the license restrictions.

The server runs on async Python using uvicorn and asgineer - which is fun and bloody fast. It uses SQLite via itemdb to store the data, making it easy to deploy.

The client is a mix of HTML, CSS, Markdown, and ... Python! PScript is used to compile the Python to JavaScript. This may be a bit idiosyncratic, but it's fun! Maybe I'll someday implement it in something that compiles down to Wasm :)

Usage example

This repo is organized as a library, making it quite flexible to apply tweaks. See

run.py

You can also see it in action at https://timetagger.app - you can purchase an account for €3 per month so you don't have to worry about maintaining a server, backups, and all that. Plus you'd sponsor this project and open source in general.

Installation

TimeTagger is a Python library and requires Python 3.6 or higher. The dependencies are listed in

requirements.txt

# Latest release
pip install -U timetagger

Latest from Github
pip install -U https://github.com/almarklein/timetagger/archive/main.zip
Uninstall
pip uninstall timetagger

After installation, copy and execute

python run.py

License

This code is subject to the GPL-3.0 License. Contributors must agree to the Contributor License Agreement to grant the right to use contributions at e.g. the TimeTagger.app service.

Developers

Additional developer dependencies:

pip install invoke black flake8 pytest requests

• invoke -l

  to see available invoke tasks

• invoke clean

  to remove temporary files

• invoke format

  to autoformat the code (using black)

• invoke lint

  to detect linting errors (using flake8)

• invoke tests

  to run tests (using pytest)