Project Timer is a lightweight VS Code extension that tracks the time you spend on your projects. It provides detailed insights into your productivity by analyzing your coding activity by dates, programming languages and specific files.
Feature
Privacy-first Storage: Stores data locally in VS Code; synchronization happens only through Settings Sync.
Cross-device synchronization: Optionally, you can enable synchronization across multiple devices using VS Code Settings Sync.
Real-time Status Bar Timer: Displays a timer in the VS Code status bar showing your progress in real-time. The display format is customizable.
Smart Idle Detection: Automatically pauses the timer when you are inactive for a configurable duration.
Visual Statistics: Provides a comprehensive webview with charts and insights into your coding habits.
Usage
Simply open a folder or workspace, and Project Timer will begin tracking.
The timer will appear in the status bar. Click on the status bar item to quickly open the statistics view.
Note: On the first launch of this version, you will be prompted to choose whether to enable synchronization.
Extension Settings
This extension contributes the following settings:
project-timer.statusBar.enabled: Enable or disable the status bar timer.
project-timer.statusBar.displayPrecision: Set time precision to second, minute, hour, or auto.
project-timer.statusBar.displayProjectName: Toggle the visibility of the project name in the status bar.
project-timer.statusBar.displayTimeMode: Set the display mode to today, total, or both.
project-timer.timer.pauseWhenUnfocused: Automatically pause the timer when VS Code is not the active window.
project-timer.timer.unfocusedThreshold: Set the threshold (in minutes) for unfocused pause. If the window is unfocused for longer than this threshold, the timer will pause.
project-timer.timer.pauseWhenIdle: Automatically pause the timer when user is idle.
project-timer.timer.idleThreshold: Set the idle time threshold (in minutes) after which the timer pauses. Set to 0 to disable.
project-timer.synchronization.enabled: Enable or disable data synchronization via VS Code Settings Sync.
project-timer.synchronization.syncedProjects: The list of projects that are tracked for synchronization.
Commands
Project Timer: Open Statistics: View your project's time tracking dashboard.
Project Timer: Export Data: Save your tracking history to a JSON file.
Project Timer: Import Data: Load tracking history from a previously exported JSON file.
Project Timer: Delete All Storage: Clear all local tracking data, both current device and remote devices (requires confirmation).
Project Timer: Rename Project: Rename the current project.
Project Timer: Disable Sync For Current Project: Disable synchronization for the current project.
Project Timer: Enable Sync For Current Project: Enable synchronization for the current project.
Development
clone repository
git clone https://github.com/LKLLLLLLLLLL/project-timer.git
cd project-timer
install dependencies
npm install
debug extension
Press F5 to toggle debug mode.
build VSIX
npm run build
run checks (compile, lint, test)
npm run pretest
npm run test
release
release on github
git tag vX.X.X
git push origin vX.X.X # Toggle github action to release
Restored data synchronization service by default, resolving previous consistency concerns with a more robust implementation.
Introduced per-project sync controls: You can now use commands to Enable or Disable synchronization for specific projects as needed.
A dded a new management configuration project-timer.synchronization.syncedProjects that provides a readable overview of all projects currently participating in sync.
UI Accessibility Improvements:
Added a vertical scrollbar to the Statistics Page to ensure full accessibility on low-resolution or smaller screens.
Refined the overall layout of the dashboard for better visual balance and clarity.
0.3.2
Resolved a issue on the Windows platform where the extension failed to activate due to parent path parsing errors.
Error messages and stack traces are now correctly logged to the VS Code Output panel for easier troubleshooting.
Temporarily disabled the synchronization feature to prevent potential data consistency issues.
0.3.1
Improved UI responsiveness: The status bar and menus now refresh immediately after data management operations (Delete, Import, Rename).
Updated extension icon color to a blue theme (#007FD4).
0.3.0
Force-refreshes all cached data 5 seconds after startup to ensure the Git remote URL is resolved correctly.
Added diagnostic logging to the VS Code Output panel.
Redesigned statistics dashboard with an improved layout and new insights:
KPI strip showing Total, Today, Avg / Day, and Best Day.
Activity chart with 7d / 30d / 90d / All range tabs; the All view fills the complete calendar range including gap days.
Languages and Top Files panels auto-fit to available space, with a coloured progress bar per entry.
Devices panel appears automatically when data from multiple devices is detected.
Responsive layout that stacks panels vertically on narrow viewports.
0.2.2
Fixed an issue where the Git remote URL could not be retrieved correctly.
Fixed incorrect refresh frequency when displayTimeMode is set to Both.
Further reduced background CPU usage by lowering refresh frequency for the status bar, hover menu, and time calculator.
The today value in the status bar and hover menu now consistently reflects local device data only.
0.2.1
Performance enhancement: Implemented caching and reduced refresh frequency to reduce power consumption (approx. 50% reduction in idle state).
Increased status bar item priority.
Resolved latency in status bar icon refreshes.
Fixed multi-project record display issues.
Fixed time calculation to use local time instead of UTC for accurate daily statistics.
0.2.0
Added Git remote URL matching for more accurate cross-device project recognition.
Added support for customizing project display names.
Optimized status bar performance with a new caching layer.
0.1.1
Introduced Storage cache system to improve performance.
Fixed timer remaining at 0/1s when multiple windows were open simultaneously.
Fixed issue where statistics were incorrectly merged when multiple project folders existed under the same parent directory.
0.1.0
Introduced V2 data storage structure with automatic migration from V1.
Added synchronization support via VS Code Settings Sync.
Added a one-time prompt to choose synchronization preference on startup.
Refined Import, Export, and Delete command behaviors for multi-device data management.
Fixed a bug where the status bar timer failed to refresh periodically.
0.0.2
Improved time tracking precision with new setting items.
Refactored status bar display modes for better customization.
UI refinements and optimized default configurations.
0.0.1
Initial release of Project Timer.
Automatic time tracking with idle detection and focus awareness.
Project Timer