TimeTagger

TimeTagger is an open-source, self-hosted web application for tracking time. It utilizes a tag-based system rather than traditional project folders to organize activities, providing an interactive timeline for visualizing and managing logged hours. The software is designed for individuals and freelancers who need to monitor their productivity, track billable hours, and generate detailed reports on their time allocation.

Users can deploy TimeTagger as a local Python library or as a server using Docker containers. The application is responsive and works across different screen sizes, allowing for synchronization between devices. It supports single-user mode for local installations and offers several authentication options for multi-user environments. This includes the ability to provide credentials via environment variables or command line arguments, as well as support for reverse proxy authentication through HTTP headers for users running tools like Authelia.

Key features

• Interactive timeline user interface
• Tag-based time organization
• PDF and CSV reporting
• Daily, weekly, and monthly target setting
• Integrated Pomodoro timer
• Device synchronization
• Responsive design for mobile and desktop

The server is built with asynchronous Python using uvicorn and asgineer, while SQLite via itemdb handles data storage to simplify deployment. The client side uses a combination of HTML, CSS, and Markdown, with Python compiled to JavaScript via PScript. This architectural choice allows the developer to maintain a Python-centric stack across both the backend and frontend. For those using specific development environments, a third-party VS Code extension is available to integrate tracking directly into the code editor, and a CLI tool is provided for command line interactions.

TimeTagger serves as a lightweight utility for personal time management and freelance billing, focusing on flexibility through tags rather than rigid project structures.