Chrome Time Tracker

A simple and effective Chrome extension to track your time spent browsing, both overall and per tab.

About the Project

Welcome to the Chrome Time Tracker! This extension is designed for anyone who wants to be more mindful of their browsing habits. Whether you're a developer tracking your focus time, a student trying to stay on task, or simply curious about your digital life, this tool provides a clear overview of where your time goes.

The extension runs silently in the background, measuring the time you spend in Chrome. It not only gives you a total time but also breaks down the usage by individual tabs, so you can see exactly which websites are consuming most of your time.

Features

• Total Time Tracking: Keeps a running total of the time you have spent in Chrome.
• Per-Tab Tracking: Shows the time spent on each individual tab/website.
• Real-Time Updates: The timer updates in real-time, giving you an accurate picture of your current session.
• Simple UI: A clean and easy-to-read popup window that displays your time stats.
• Lightweight: Built with efficiency in mind to have minimal impact on your browser's performance.

Getting Started

Follow these steps to get the extension up and running in your Chrome browser.

Prerequisites

• Google Chrome browser (version 80 or later recommended).

Installation

1. Clone the repository:

git clone https://github.com/dibyasagar16/screentime-tracker.git

2. Open Chrome and go to chrome://extensions in your address bar.
3. Enable Developer Mode:

• Turn on the "Developer mode" toggle in the top-right corner of the page.

4. Load the extension:

• Click the "Load unpacked" button.
• Select the chrome-time-tracker folder from the cloned repository.

5. The extension icon should now appear in your browser's toolbar.

Usage

1. Click the Extension Icon:

• Click on the extension icon in your Chrome toolbar.

2. View the Popup:

• A popup window will appear, showing:
  • Total Time Today: The cumulative time you've spent in Chrome since the start of the day.
  • Tab-wise Breakdown: A list of active tabs and the time spent on each.

3. Tracking:

• The extension automatically starts tracking when you open a new window or tab.
• The timer is paused when the browser is closed or minimized.

Contributing

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".

1. Fork the Project
2. Create your Feature Branch:

git checkout -b feature/AmazingFeature

3. Commit your Changes:

git commit -am 'Add some AmazingFeature'

4. Push to the Branch:

git push origin feature/AmazingFeature

5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.