Time Tracking for Frappe Framework

Watch is a modern, standalone time tracking app built on the Frappe Framework. Designed for teams and individuals who need clean, distraction-free time tracking without leaving their Frappe ecosystem, Watch offers a one-click timer, flexible tagging, and clear daily and weekly views.

Start tracking time instantly with a single click or keyboard shortcut. Pause, resume, and stop without friction.

• Start/pause/stop from the top bar or keyboard shortcuts
• Active timer banner shows elapsed time across all pages
• Focus widget for distraction-free time tracking
• Timer state persists across page reloads

Record where your time goes with structured entries that capture everything you need for reporting and billing.

• Date, start/end time, and automatic duration calculation
• Free-text descriptions for context
• Billable flag for client work
• Manual entry bar for adding past entries quickly

Organize entries with reusable tags for clients, projects, categories, or anything else that helps you slice your time data.

• Create and manage reusable tags
• Apply multiple tags per entry
• Filter views by tag
• Color-coded labels for quick visual scanning

See exactly how your day is going with a focused view of today's entries, total hours, and active timer.

• Chronological entry list for the selected day
• Running total of tracked time
• Quick-edit entries inline
• Navigate between days

Step back and see the bigger picture with weekly summaries, bar charts, and donut breakdowns.

• Weekly bar chart showing daily totals
• Donut chart breaking down time by tag
• Week-over-week navigation
• Summary statistics

Gentle reminders help you build consistent tracking habits without being intrusive.

• Daily nudge banner when no time has been tracked
• Idle detection banner after periods of inactivity
• Configurable nudge preferences

Power users can drive Watch entirely from the keyboard.

• Shortcuts overlay showing all available bindings
• Start/stop timer without reaching for the mouse
• Navigate between views quickly

Get your data out in standard formats for invoicing, reporting, or analysis.

• Download entries as CSV
• Excel export support
• Filter before export to get exactly what you need

Optionally bridge Watch entries into ERPNext Timesheets for billing and payroll workflows.

• Sync time entries to ERPNext Timesheets
• Map tags to ERPNext Activity Types
• Configurable sync settings

When Dock is installed, Watch integrates seamlessly into the ecosystem top bar.

• Timer widget in the Dock navbar
• Start/stop timer from any app in the ecosystem
• Timer state shared across all Dock-connected apps

• Frappe Framework v16 or higher
• Python 3.14+
• Node.js 24+
• MariaDB 10.6+

# Get the app
bench get-app watch https://github.com/tonic-6101/watch.git

# Install on your site
bench --site your-site.localhost install-app watch

# Run migrations
bench --site your-site.localhost migrate

# Build assets
bench build --app watch

After installation, access Watch at: https://your-site.localhost/watch

1. Start the Timer: Click the play button or press the keyboard shortcut
2. Add a Description: Describe what you're working on
3. Tag It: Apply tags for client, project, or category
4. Stop: Click stop when you're done — the entry is saved automatically
5. Review: Check your daily and weekly views to see where your time went

• Backend: Frappe Framework, Python 3.14+
• Frontend: Vue 3, TypeScript, Tailwind CSS
• UI Components: FrappeUI
• Database: MariaDB
• Build: Vite

Contributions are welcome! This project uses pre-commit for code formatting and linting:

cd apps/watch
pre-commit install

Pre-commit runs the following tools automatically:

• ruff — Python linting and formatting
• eslint — TypeScript/JavaScript linting
• prettier — Code formatting
• pyupgrade — Python syntax modernization

• Issues: GitHub Issues
• Discussions: GitHub Discussions

GNU Affero General Public License v3.0 (AGPL-3.0)

See LICENSE for details.

SPDX-License-Identifier: AGPL-3.0-or-later
Copyright (C) 2024-2026 Tonic

Built with Frappe Framework and FrappeUI.