TimeTracker is a self-hosted, web-based time tracking application designed for freelancers, teams, and businesses who need professional time management with complete control over their data.

Perfect for:

💼 Freelancers tracking billable hours across multiple clients
👥 Small Teams managing projects and tracking productivity
🏢 Agencies needing detailed reporting and client billing
🔒 Privacy-focused organizations wanting self-hosted solutions

✨ Features

⏱️ Smart Time Tracking

One-Click Timers — Start tracking with a single click
Persistent Timers — Timers keep running even after browser closes
Idle Detection — Automatic pause after configurable idle time
Manual Entry — Add historical time entries with notes and tags
Real-time Updates — See live timer updates across all devices

📊 Project & Task Management

Unlimited Projects & Tasks — Organize work your way
Client Management — Store client details and billing rates
Task Board — Visual task management with priorities and assignments
Status Tracking — Monitor progress from to-do to completion
Estimates vs Actuals — Track project budgets and burn rates

🧾 Professional Invoicing

Generate from Time — Convert tracked hours to invoices automatically
Custom Line Items — Add manual items for expenses or services
Tax Calculation — Automatic tax calculations with configurable rates
PDF Export — Professional invoice templates (coming soon)
Status Tracking — Track draft, sent, paid, and overdue invoices

📈 Analytics & Reporting

Visual Dashboards — Charts and graphs for quick insights
Detailed Reports — Time breakdown by project, user, or date range
CSV Export — Export data for external analysis
Billable vs Non-billable — Separate tracking for accurate billing
Custom Date Ranges — Flexible reporting periods

🔐 Multi-User & Security

Role-Based Access — Admin and user roles with appropriate permissions
User Management — Add team members and manage access
Self-Hosted — Complete control over your data
Username-Only Login — Simple authentication for internal use
Session Management — Secure cookies and session handling

🛠️ Technical Excellence

Docker Ready — Deploy in minutes with Docker Compose
Database Flexibility — PostgreSQL for production, SQLite for testing
Responsive Design — Works perfectly on desktop, tablet, and mobile
Real-time Sync — WebSocket support for live updates
Automatic Backups — Scheduled database backups (configurable)

📸 Screenshots

Dashboard — Your Command Center

Start timers, view recent entries, and see your productivity at a glance

Projects & Tasks — Stay Organized

Manage multiple projects and break them down into actionable tasks

Time Tracking — Flexible & Powerful

Manual time entry and visual calendar view for better planning

Invoicing & Clients — Professional Billing

Generate invoices from tracked time and manage client relationships

Reports & Analytics — Data-Driven Insights

Comprehensive reporting and user analytics for informed decisions

Easy Creation — Streamlined Workflows

Simple, intuitive forms for creating projects, tasks, and clients

🚀 Quick Start

Docker (Recommended)

Get TimeTracker running in under 2 minutes:

# Clone the repository
git clone https://github.com/drytrix/TimeTracker.git
cd TimeTracker

# Start with Docker Compose
docker-compose up -d

# Access at http://localhost:8080

First login creates the admin account — just enter your username!

Quick Test with SQLite

Want to try it out without setting up a database?

docker-compose -f docker-compose.local-test.yml up --build

No configuration needed — perfect for testing!

💡 Use Cases

For Freelancers

Track time across multiple client projects, generate professional invoices, and understand where your time goes. TimeTracker helps you bill accurately and identify your most profitable clients.

For Teams

Assign tasks, track team productivity, and generate reports for stakeholders. See who's working on what, identify bottlenecks, and optimize team performance.

For Agencies

Manage multiple clients and projects simultaneously. Track billable hours, generate client invoices, and analyze project profitability — all in one place.

For Personal Projects

Even if you're not billing anyone, understanding where your time goes is valuable. Track personal projects, hobbies, and learning activities to optimize your time.

🌟 Why TimeTracker?

Feature	TimeTracker	Traditional Time Trackers
Self-Hosted	✅ Complete data control	❌ Cloud-only, subscription fees
Open Source	✅ Free to use & modify	❌ Proprietary, locked features
Persistent Timers	✅ Runs server-side	❌ Browser-dependent
Docker Ready	✅ Deploy anywhere	⚠️ Complex setup
Invoicing Built-in	✅ Track to bill workflow	❌ Requires integration
No User Limits	✅ Unlimited users	❌ Per-user pricing

📚 Documentation

Comprehensive documentation is available in the docs/ directory:

Getting Started

📖 Getting Started Guide — Complete beginner's guide (⭐ Start here!)
Installation Guide — Detailed setup instructions
Requirements — System requirements and dependencies
Troubleshooting — Common issues and solutions

Features

Task Management — Break projects into manageable tasks
Invoice System — Generate professional invoices
Client Management — Manage client relationships
Calendar Features — Calendar and bulk entry features
Command Palette — Keyboard shortcuts for power users

Technical Documentation

Project Structure — Codebase architecture
Database Migrations — Database schema management
Version Management — Release and versioning
CI/CD Documentation — Continuous integration setup

Contributing

Contributing Guidelines — How to contribute
Code of Conduct — Community standards

🐳 Deployment

Local Development

docker-compose up -d

Production with PostgreSQL

# Configure your .env file
cp env.example .env
# Edit .env with production settings

# Start with production compose
docker-compose -f docker-compose.remote.yml up -d

Raspberry Pi

TimeTracker runs perfectly on Raspberry Pi 4 (2GB+):

# Same commands work on ARM architecture
docker-compose up -d

📖 See Deployment Guide for detailed instructions

🔧 Configuration

TimeTracker is highly configurable through environment variables:

# Timezone and locale
TZ=America/New_York
CURRENCY=USD

# Timer behavior
SINGLE_ACTIVE_TIMER=true
IDLE_TIMEOUT_MINUTES=30
ROUNDING_MINUTES=1

# User management
ADMIN_USERNAMES=admin,manager
ALLOW_SELF_REGISTER=false

# Security (production)
SECRET_KEY=your-secure-random-key
SESSION_COOKIE_SECURE=true

📖 See Configuration Guide for all options

🛣️ Roadmap

Planned Features

📄 PDF Invoice Templates — Professional PDF generation
📧 Email Integration — Send invoices to clients
📱 Progressive Web App — Install as mobile app
🔄 Recurring Invoices — Automate recurring billing
🎨 Custom Themes — Personalize your interface
🔌 API Extensions — RESTful API for integrations
📊 Advanced Analytics — More charts and insights

Recently Added

✅ Invoice Generation — Complete invoicing system
✅ Task Management — Full task tracking and management
✅ Command Palette — Keyboard-driven navigation
✅ Calendar View — Visual time entry calendar
✅ Bulk Operations — Bulk time entry creation

🤝 Contributing

We welcome contributions! Whether it's:

🐛 Bug Reports — Help us identify issues
💡 Feature Requests — Share your ideas
📝 Documentation — Improve our docs
💻 Code Contributions — Submit pull requests

📖 See Contributing Guidelines to get started

📄 License

TimeTracker is licensed under the GNU General Public License v3.0.

This means you can:

✅ Use it commercially
✅ Modify and adapt it
✅ Distribute it
✅ Use it privately

See LICENSE for full details

🆘 Support

📖 Documentation: Check the docs/ directory
🐛 Bug Reports: Open an issue
💬 Discussions: GitHub Discussions
📧 Contact: Create an issue for support

⭐ Star Us!

If TimeTracker helps you track your time better, consider giving us a star on GitHub! It helps others discover the project.

⭐ Star on GitHub

Built with ❤️ for the time-tracking community

Languages

Python 56.2%

HTML 34.4%

JavaScript 6.8%

Shell 1.2%

CSS 0.9%

Other 0.3%