TimeTrack Pro 🕒
Automatic project coding time tracker with keystroke detection, git branch breakdown, and 1-click invoice timesheet export for VS Code.
✨ Features
- ⏱ Smart Inactivity Detection: Tracks coding time automatically when you are typing or editing. Pauses automatically after idle inactivity (configurable, default 2 mins).
- 📊 Real-Time Visual Dashboard: View today's time, 7-day work history, active language breakdown, and estimated earnings in an interactive dashboard (
Alt+Shift+T / Cmd+Shift+T).
- 🌿 Git Branch & Workspace Isolation: Automatically tags your tracked time by Git branch and workspace folder.
- 💰 Freelance Invoicing & Billing Rate: Configure your hourly rate (
$50/hr) and currency symbol ($, €, £, ₹) to calculate billable earnings live.
- 📥 1-Click Timesheet Export: Export professional timesheets to Markdown Invoices or CSV Spreadsheets ready for clients, Excel, or Google Sheets.
- 🔔 Compact Status Bar Item: Shows current active session hours and earnings directly in the status bar with 1-click action popup.
⌨️ Shortcuts & Commands
| Command |
Title |
Default Shortcut |
timeTrack.openDashboard |
Open Analytics Dashboard 🕒 |
Alt+Shift+T (Cmd+Shift+T on Mac) |
timeTrack.exportTimesheet |
Export Billable Timesheet (CSV & Markdown) |
Command Palette |
timeTrack.toggleTracking |
Pause / Resume Tracking |
Command Palette |
timeTrack.resetToday |
Reset Today's Tracked Time |
Command Palette |
⚙️ Configuration Settings
Customize TimeTrack Pro in VS Code Settings (Ctrl+, -> search TimeTrack):
timeTrack.hourlyRate: Set your billing rate per hour (default: 50).timeTrack.currency: Set your currency symbol (default: $).timeTrack.idleTimeoutMinutes: Inactivity timeout before auto-pausing (default: 2 minutes).timeTrack.showInStatusBar: Display active coding time in the bottom status bar (default: true).
1. Markdown Invoice
Generates an invoice breakdown with date, project name, git branch, hours worked, keystroke count, hourly rate, and total billable amount.
2. Tabular CSV
Generates a structured spreadsheet file ready for Excel, LibreOffice, or Google Sheets with full headers: Date, Project, Branch, Hours, Keystrokes, HourlyRate, TotalAmount, PrimaryLanguages.
🔒 Privacy & Offline Operation
- 100% Local & Private: All time logs are stored locally within your VS Code workspace state.
- Zero Telemetry / No Cloud Dependence: No servers, no tracking APIs, and no external connections required.
👤 Author
Developed by Pirapaakaran Pirathapan
📜 License
MIT License. Free for personal and commercial usage.
