# almarklein/timetagger

Tag your time, get the insight

Repository: https://github.com/almarklein/timetagger
Canonical: https://ross.abutalabs.com/products/timetagger
Homepage: https://timetagger.app
Language: Python
License: GPL-3.0
License Family: copyleft
Topics: python, timetracker
Last push: 2026-05-17T09:59:08+00:00

## Health v2 (maintenance only)
Score: 81/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 82, release rhythm 68, longevity 100
- inputs: {"age_days": 2072, "days_push": 108, "days_rel": 212, "gap_med": 26.0, "n_releases_24m": 7}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1778, forks 166 (observed 2026-08-28T04:05:35.208189+00:00)

## What it is
TimeTagger is an open-source, web-based time-tracking application for individuals and freelancers, built around an interactive timeline and tag-based workflows. It runs locally or self-hosted via Docker, with reporting in PDF/CSV, goal targets, offline support, and device sync.

## Use cases
- track billable hours as a freelancer
- self-host a time tracker
- generate PDF timesheet reports for clients
- track time with tags instead of projects
- use a pomodoro timer while tracking work
- sync time tracking across devices
- track time from the terminal via CLI

## When to choose
- you want a self-hosted, privacy-friendly time tracker with no third-party tracking
- you prefer lightweight tag-based tracking over rigid project structures
- you need PDF/CSV reporting and daily/weekly/monthly targets
- you want a responsive web app that works offline and syncs

## When to avoid
- you need team-oriented features like approvals, invoicing, or payroll integrations
- you require native mobile apps from app stores
- you want enterprise time-tracking with SSO and compliance features

## Facets
- artifact type: application
- maturity: active
- function: web-framework, http-server, gui, analytics, sdk, self-hosted
- domain: developer-tools, self-hosted, web-development
- platform: python, self-hosted, cross-platform, cli
- tags: time-tracking, pomodoro, freelance, reporting, sqlite, web-app, pwa, web-server, docker

## Member repositories
- almarklein/timetagger (main) score 81

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:35.208189+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:25:09.201390+00:00, confidence not recorded.
  - readme: https://github.com/almarklein/timetagger (fetched 2026-08-28T04:05:35.208189+00:00, sha b191beaf5c02)
  - homepage: https://timetagger.app (fetched 2026-08-29T11:03:26.268898+00:00, sha bc0de14bc09d)
  - site_page: https://timetagger.app/about (fetched 2026-08-29T11:03:26.279868+00:00, sha 59b45fd07768)
  - registry_pypi: https://pypi.org/pypi/timetagger/json (fetched 2026-08-29T11:03:26.281368+00:00, sha 7686f511aeef)
  - site_page: https://timetagger.app/faq (fetched 2026-08-29T11:03:26.277912+00:00, sha 5e8724716379)
- Data as of 2026-08-30T08:39:29.467469+00:00.