Time Tracker for Obsidian

A fully-featured, time tracking plugin built into Obsidian. Track your work, analyze your productivity, and block out your time, all built in.

Big thanks to the Simple Time Tracker Android App, this plugin was greatly inspired by it.

Features

Time Tracking

• Create projects with custom icons and colors
• Organize projects in categories
• One-click start/stop from sidebar

Analytics

• Pie charts by project or category
• Timeline graphs over time
• Filter by day, week, month, year, or custom range

Schedule View

• Daily calendar view of tracked time, using Full Calendar
• ICS calendar integration (Google Calendar, etc.)
• Timeblocking, right in your sidebar

Tracking Modes

• Standard - Click to start, click to stop
• Retroactive - Fills time gaps when switching projects

Data

All data are stored as CSV files in your vault

• Auto-backup every 3 hours
• Conflict resolution for sync issues
• Import from Simple Time Tracker
• Mobile support

Commands

Command	Description
Open Time Tracker	Open sidebar
Open Analytics	Open analytics
Toggle Last Used Timer	Start/stop last project
View Backups	Browse backups
Resolve Conflicts	Fix sync conflicts
Import from Simple Time Tracker	Import STT data

---

Installation

BRAT

1. Install BRAT
2. Add beta plugin: https://github.com/luwaiwong/obsidian-time-tracker
3. Enable in settings

Manual

1. Download from Releases
2. Extract to {vault}/.obsidian/plugins/time-tracker/
3. Enable in settings

---

Development

git clone git@github.com:luwaiwong/obsidian-time-tracker.git
cd obsidian-time-tracker
npm install

Set DEV_DIRECTORY in vite.config.ts to your test vault.

npm run dev      # watch mode
npm run build    # production build
npm run check    # type check
npm run lint     # lint
npm run format   # format

---

Support

---

License

GPL-3.0 © Lu-Wai Wong