https://github.com/hiteshydv001/codeclock
VS code extension
https://github.com/hiteshydv001/codeclock
Last synced: 4 months ago
JSON representation
VS code extension
- Host: GitHub
- URL: https://github.com/hiteshydv001/codeclock
- Owner: Hiteshydv001
- License: mit
- Created: 2025-03-08T17:19:25.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-03-10T10:30:17.000Z (10 months ago)
- Last Synced: 2025-03-17T11:18:23.723Z (10 months ago)
- Language: TypeScript
- Size: 601 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
# π― Code Time Tracker
Welcome to **Code Time Tracker** β a sleek, lightweight, and powerful **VS Code extension** designed to help you track and analyze your coding time effortlessly. Stay productive, gain insights, and boost your efficiency with real-time tracking! π
---
## β¨ Features at a Glance
### β³ **Real-Time Tracking**
βοΈ Automatically logs time spent on each file.
βοΈ Dynamic updates as you work β no manual input needed!
### π **Visual Analytics & Insights**
βοΈ **Live Timer Widget** displaying:
- β²οΈ Total coding time
- π Active file being edited
- βΈοΈ Pause & βΆ Resume buttons
βοΈ **Bar Chart Visualization** β see coding time per file.
βοΈ **Status Bar Clock** β always visible in VS Code.
### π― **Pause & Resume Tracking**
βοΈ Need a break? **Pause** the tracker anytime.
βοΈ Hit **Resume** when youβre back at it.
βοΈ Ensures precise time logging.
### π **Persistent Data Tracking**
βοΈ Logs persist even after restarting VS Code.
βοΈ Helps maintain long-term coding activity records.
### β‘ **Lightweight & Non-Intrusive**
βοΈ Runs efficiently in the background.
βοΈ No performance slowdowns, just seamless tracking.
---
## π Visual Analytics & Insights


## π Installation
1. Open **Visual Studio Code**.
2. Go to the **Extensions Marketplace**.
3. Search for `Code Time Tracker`.
4. Click **Install**.
5. Activate the extension by running `Show Code Time Tracker` from the Command Palette (`Ctrl+Shift+P` / `Cmd+Shift+P`).
---
## π How to Use
### π¬ **Step 1: Launch the Timer Widget**
πΉ Open the **Command Palette** (`Ctrl+Shift+P` / `Cmd+Shift+P`).
πΉ Type `Show Code Time Tracker` and select it.
πΉ The **Timer Widget & Chart** will appear in a webview panel.
### π― **Step 2: Start Coding & Track Time**
π’ Open any file and begin coding.
π’ **Total Time** updates dynamically.
π’ The **Active File** section shows the file youβre editing.
π’ The **Bar Chart** visualizes time spent per file.
### βΈ **Step 3: Pause & Resume Tracking**
βΈ Click **Pause** to stop tracking temporarily.
βΆ Click **Resume** to continue logging time.
### β **Step 4: Monitor Time in the Status Bar**
π A **Status Bar Clock** shows total coding duration.
π± Hover over it for additional insights.
---
## π Extension Settings
This extension provides the following customizable settings:
- `codeTimeTracker.enable`: β
Enable/disable time tracking.
- `codeTimeTracker.resetTime`: π Manually reset tracked time.
---
## π Upcoming Features
πΉ **Project-based Time Tracking** β monitor time per project!
πΉ **Custom Reports** β export data for better productivity analysis.
πΉ **Dark Mode Support** β for an even sleeker UI.
---
## β Known Issues
- β³ The timer may reset if VS Code crashes unexpectedly.
- π Performance may vary on very large projects.
---
## π Release Notes
### π₯ **Version 1.1.0** (Latest)
βοΈ Added **Status Bar Clock**.
βοΈ Improved performance and UI responsiveness.
### π **Version 1.0.0**
βοΈ Initial release of Code Time Tracker.
---
## π‘ Contributing
We β€οΈ open-source contributions! If youβd like to enhance this extension, feel free to submit a **pull request** or open an **issue** on [GitHub](https://github.com/Hiteshydv001/CodeClock/issues).
---
## π¬ Need Help?
For issues, feature requests, or support, visit our [GitHub Repository](https://github.com/Hiteshydv001/CodeClock/issues).
---
## π License
This extension is released under the [MIT License](LICENSE).
---
π **Happy Coding with Code Time Tracker!** β³π»