A premium, gorgeous cyberpunk-themed Pomodoro and Mindfulness Chrome Extension designed for developers, creators, and high-performance screen-workers. It helps you manage focus cycles, rest your eyes, stretch, and beat screen fatigue.
👉 Download on the Chrome Web Store
Note
Modern MV3 Architecture Upgrade (v2.0.0):
This extension has been entirely rewritten to Chrome Extension Manifest V3 best practices. It features a fully stateless service worker backed by chrome.alarms and chrome.storage.local. Your timers are completely immune to background suspension!
- Holographic Cyberpunk UI: A visual centerpiece containing a gorgeous, interactive circular SVG progress ring that breathes and shrinks as time runs down.
- Auto-Cycling Sessions: Automatically transition from focus → break → focus without any interaction, allowing you to stay completely in the zone.
- Stateless & Robust Engine: Timers are scheduled via browser-level alarms. The extension is 100% immune to background service worker termination—it will never freeze or reset.
- Background Audio Alerts: Plays high-quality audible chime alerts (
alert.mp3) at the end of focus/break blocks viachrome.offscreensandboxed audio—working flawlessly even when the popup is closed. - Mindful Pause Prompts: Toggles periodic notifications that deliver hand-crafted physical stretches, breathing exercises, and eye relaxation cues (the 20-20-20 rule) to combat screen fatigue.
- Embedded Instant-Sync Settings: Open the glassmorphic settings drawer in the popup to instantly customize durations (1 to 120 minutes) and toggles. Your settings save instantly with immediate visual feedback.
- Privacy by Design: No accounts, no tracking, no analytics, no external network requests. All data stays strictly on your local device.
Click here to install Focus Timer PRO from the Chrome Web Store
- Clone this repository to your local computer:
git clone https://github.com/Param-10/Focus-Timer-Extension.git- Open your Google Chrome browser and navigate to
chrome://extensions/. - Toggle Developer mode (top-right switch) to ON.
- Click the Load unpacked button (top-left).
- Select the root folder of this project.
Click the puzzle piece icon in the Chrome toolbar, locate Focus Timer PRO, and click the Pin icon to lock the holographic dashboard for quick access.
Focus Timer PRO is designed to be highly resource-efficient and fully MV3-compliant:
┌─────────────────┐ ┌────────────────────┐
│ Extension ├────────────►│ chrome.storage │
│ Popup UI │ (Instantly) │ .local (State) │
└────────┬────────┘ └─────────▲──────────┘
│ │ (Event Tick Sync)
│ (Message Trigger) │
▼ │
┌─────────────────┐ ┌─────────┴──────────┐
│ background.js ├────────────►│ chrome.alarms │
│ (Service Worker)│ (Schedules) │ (Stateless Scheduler)
└────────┬────────┘ └─────────▲──────────┘
│ │ (Fires completion)
▼ (Spawns on Alert) │
┌─────────────────┐ │
│ offscreen.html ├───────────────────────┘
│ (Audio Chime) │
└─────────────────┘
- Popup UI: Renders the SVG circular animation, does local high-performance countdown loops, and lets you slide settings. Changes are immediately written to local storage.
- Stateless Background Service Worker: Handles incoming events and registers/clears alarms. The service worker safely suspends after 30 seconds of inactivity to save RAM and CPU.
- Chrome Alarms: The browser's native scheduler takes over and keeps track of the remaining seconds. When the alarm triggers, it wakes up the service worker.
- Offscreen Audio Player: The background worker temporarily opens a sandboxed, hidden document to play
sounds/alert.mp3, ensuring audio alerts work perfectly when the popup is closed, and then immediately destroys it to save memory.
Click the Settings Drawer at the bottom of the popup, or open the extension options page from Chrome to customize:
- Focus Duration: 1 to 120 minutes (Default: 25 min)
- Break Duration: 1 to 30 minutes (Default: 5 min)
- Audio Alerts: Toggle chime sounds on completion.
- Mindful Prompts: Turn on background mindfulness stretching notifications (Default: every 20 minutes of active browser time).
- Auto-Cycle Sessions: Enable/disable automatic transitioning between Focus and Break sessions.
Contributions are what make the open-source community an amazing place to learn, inspire, and create.
- Fork the Project.
- Create your Feature Branch (
git checkout -b feature/AmazingFeature). - Commit your Changes (
git commit -m 'Add some AmazingFeature'). - Push to the Branch (
git push origin feature/AmazingFeature). - Open a Pull Request.
Distributed under the MIT License. See LICENSE for more information.
Developer: Paramveer Singh
Email: bheleparamveer@gmail.com
Project Link: https://github.com/Param-10/Focus-Timer-Extension