Track Hours

A modern, offline-first desktop application for tracking time across projects and tasks.

Whether you are a freelancer, developer, or anyone who needs to keep track of how their time is spent, Track Hours gives you a clean and distraction-free environment to log, review, and export your work hours — without any cloud dependency.

Timer	Project

• Projects & Tasks — Create, edit, and archive projects and tasks with custom colors and categories (Development, Design, Meeting, Testing, Management, Research, and more)
• Live Timer — Start/stop real-time tracking with desktop notifications
• Manual Entries — Add or edit time entries retroactively with start time, end time, and notes
• Day / Week / Month View — Browse entries with filters by project, category, and full-text search
• Reports — Visual breakdowns of tracked time per project and category with bar charts
• Export — Export to CSV (UTF-8 BOM for Excel compatibility) or PDF
• Reminders — Configurable desktop notifications reminding you to log your time
• Offline-first — All data is stored locally; no account or internet connection required
• Themes & i18n — Dark/light theme, English and German interface
• Auto-Update — Automatic updates via GitHub releases (Electron)

npm install
npm run electron:dev

This installs dependencies and launches the app as a desktop window (Angular dev server + Electron).

Prefer the browser? Run npm start and open http://localhost:4200.

Full setup, scripts, and troubleshooting: Getting Started

Pre-built installers are available for Windows and Linux via the GitHub Releases page.

macOS builds are not currently provided.

All documentation lives in the docs/ folder:

src/app/
  models/            # Data models: Project, Task, TimeEntry, AppSettings
  services/          # StorageService, ProjectService, TimeEntryService,
                     #   TimerService, ExportService, UpdateService
  shared/            # DurationPipe, IconComponent
  components/        # Sidebar, UpdateBanner
  pages/             # Dashboard, Timer, Projects, Entries, Reports, Settings
electron/
  main.js           # Electron main process (window, IPC, auto-updater)
  preload.js         # Context bridge (secure IPC API)
public/
  i18n/             # Translation files (de.json, en.json)
docs/               # Project documentation

See the Development Guide for the full architecture breakdown.

Track Hours is offline-first. In Electron mode, data is persisted as JSON files in the OS user data directory; in browser mode, data uses localStorage.

Details: Data Storage

Contributions, issues, and feature requests are welcome. This project follows Conventional Commits, and releases are automated via Release Please.

git checkout -b feat/my-feature
npm run lint
npm test

Full workflow, code style, and conventions: Contributing

This project is licensed under the MIT License (Non-Commercial) — see the LICENSE file for details.