🚧 [ STATUS: ACTIVE DEVELOPMENT ]
BrowseTime is currently an actively evolving project. Expect rapid architectural updates, expanded tracking logic, and new glassmorphic UI features in upcoming iterations.
BrowseTime is a lightweight, privacy-focused Chrome extension engineered to precisely monitor your active browser usage. It operates on a strict "active attention" philosophy—tracking time only when you are genuinely focused on a website. With zero telemetry, zero cloud sync, and ephemeral local storage, BrowseTime ensures your data belongs exclusively to you and vanishes the moment your browser closes.
- 🎯 Surgical Accuracy: Intelligently pauses tracking when the browser is minimized, loses OS focus, or when you step away from your keyboard.
- 🎧 Media Awareness: Fully aware of your media consumption. Watching a long video without touching the mouse? BrowseTime tracks the tab's
audiblestate to ensure your time is logged seamlessly. - 🔮 Glassmorphic Cyber UI: A stunning, hacker-inspired live monitoring dashboard featuring animated deep mesh gradients, frosted glass panels, and glowing neon typography.
- ⚡ Real-Time Dynamic Sorting: Butter-smooth live rendering allows you to dynamically sort tracked domains by
Time (Desc),Time (Asc), orA-Zwithout interrupting the live ticker. - 🛡️ Absolute Privacy: Utilizes Manifest V3's volatile
chrome.storage.session. No persistent databases, no tracking cookies, and absolutely no external network requests.
| Category | Technology |
|---|---|
| Architecture | Chrome Extension Manifest V3 |
| Logic | Vanilla JavaScript (ES6+) |
| Styling | Custom CSS3 (Backdrop-filters, CSS variables, Keyframes) |
| APIs | tabs, windows, idle, storage.session, runtime |
The BrowseTime engine runs purely in the background via a sophisticated, race-condition-immune state machine:
- Focus Tracking: Listens to OS-level window transitions to guarantee the browser is actively targeted.
- Idle Detection: Leverages the
chrome.idleAPI to detect system idleness. - State Management: Aggregates elapsed time against the active domain and securely caches the session asynchronously.
- Popup Bridge: When the stats panel is opened, an active
chrome.runtime.Portestablishes a direct connection to guarantee the background tracker accurately evaluates focus states.
- Clone this repository to your local machine.
- Open Chrome/Chromium and navigate to
chrome://extensions/. - Enable Developer mode via the toggle in the top right.
- Click Load unpacked and select the root
BrowseTimedirectory. - Pin the extension to your toolbar and initialize the monitoring!
