An open API service indexing awesome lists of open source software.

https://github.com/hiteshydv001/codeclock

VS code extension
https://github.com/hiteshydv001/codeclock

Last synced: 4 months ago
JSON representation

VS code extension

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
![Code Time Tracker Widget](app1.jpg)

![Code Time Tracker Widget](app2.jpg)

## πŸš€ 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!** β³πŸ’»