TimeTagger

GPL-3.0
Platform
Web Docker
Licence
GPL-3.0 Open source
TimeTagger

TimeTagger is an open source time tracker built around one idea: instead of filling in forms, you drag on a timeline. Developed by Almar Klein, it runs as a small async-Python server (uvicorn plus asgineer, with SQLite storage) that you can run locally or host for a team, and it is aimed squarely at freelancers and individuals who want insight into where their hours went.

What you get

  • An interactive 24-hour timeline where an entry is drawn, stretched and moved rather than typed.
  • Tag-based organisation (#client1, #meeting, #admin) instead of a rigid project hierarchy, so recording takes seconds.
  • Reporting exported to PDF and CSV, with daily, weekly and monthly targets you can set and track.
  • An overview panel totalling the day, plus an experimental built-in Pomodoro mode.
  • A responsive interface that works on small screens as well as desktops, with sync between devices.
  • Optional multi-user authentication with bcrypt-hashed credentials, or trust from a reverse proxy such as Authelia through an HTTP header.
  • A companion command-line client and a third-party VS Code extension for starting and stopping records without opening the web UI.

Running it yourself

TimeTagger is a Python library: pip install -U timetagger then python -m timetagger, with single-user mode working out of the box on localhost. For a server, the project publishes container images to GitHub Container Registry in two variants — one running as root inside the container and a non-root one running as UID 1000 — with example Docker Compose files in the repository. Data lives in SQLite, which keeps deployment and backups simple. Credentials go in an environment variable or command-line argument as username:bcrypt-hash, generated on the project’s credential page; a managed hosted instance is also available for €3 per month if you would rather not run a server.

Alternatives

  • Kimai — open source time tracking for teams and freelancers
  • ActivityWatch — automatic, open source time tracking for your devices

Explore More Categories

Sign In

Register

Reset Password

Please enter your username or email address, you will receive a link to create a new password via email.