OpenTimeTracker

Free and open-source, local-first time tracking app for developers and small teams.

What is • Key Features • Quick start • Contributing • License

---

What is OpenTimeTracker?

OpenTimeTracker is a desktop time-tracking application built with Angular + Electron, designed for people who want:

• full control over their data
• no SaaS subscriptions
• a fast, offline-first experience

All data is stored locally using SQLite.

---

✨ Key Features

• 📊 Project and task management
• ⏱️ Time tracking with notes and dates
• 📅 Calendar view of your activity
• 🏷️ Tags and task categorization
• 🌙 Dark mode by default
• 🌐 English and Spanish support
• 💾 Local SQLite database
• 🔄 Automatic backups on shutdown

---

🚀 Quick start

Download (recommended)

Download the latest version for your platform from Releases:

👉 https://github.com/altaskur/OpenTimeTracker/releases

Supported platforms:

• Windows (.exe)
• macOS (.dmg, Intel & Apple Silicon)
• Linux (.AppImage, .deb)

---

Run from source (development)

git clone https://github.com/altaskur/OpenTimeTracker.git
cd OpenTimeTracker

npm install
npm run prisma:generate
npm run dev

npm run dev is the recommended and supported development command. It runs Angular and Electron together as intended.

🧪 Project status

⚠️ Alpha stage

OpenTimeTracker is under active development. Features, UI and internal APIs may change.

Feedback, bug reports and contributions are welcome.

🤝 Contributing

Interested in contributing? Great ❤️ All contribution-related documentation lives outside this README to keep things clear and up to date.

📘 CONTRIBUTING.md — setup, workflow and quality checks

🧭 COLLABORATION.md — technical and architectural details

🛡️ SECURITY.md — how to report vulnerabilities

📜 CODE_OF_CONDUCT.md — community guidelines

🌐 DeepWiki — optional, supplementary documentation (secondary): https://deepwiki.com/altaskur/OpenTimeTracker

Before opening a PR, please read CONTRIBUTING.md.

📄 License

This project is licensed under the GNU General Public License v3.0.

You are free to:

use, study and modify the software

redistribute it under the same license

See the LICENSE file for details.

👤 Author

altaskur GitHub: https://github.com/altaskur