Skip to content
Giridharan2029Public

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

FocusLock — Browser Extension

A personal StayFocusd-style web blocker for Chrome/Edge (Manifest V3). No auth, no backend, fully local.

Installation

  1. Open Chrome/Edge → chrome://extensions (or edge://extensions)
  2. Enable Developer mode (top-right toggle)
  3. Click Load unpacked
  4. Select the A blocker folder
  5. The FocusLock icon appears in your toolbar — click it to open the popup

Features

Feature Description
Time Budget Groups Create groups (Social Media, News, etc.) with daily time limits
Blocked Sites Add domains per group — blocked after budget exhausted
Allowed Sites Always-accessible whitelist that overrides group blocks
Nuclear Option Hard irreversible lock for a set duration
Dashboard Usage chart + progress bars for all groups
Notifications Up to 5 warning thresholds before time runs out
Allowlist Mode Block everything except your allowlist

How Blocking Works

  • Uses MV3 declarativeNetRequest — fastest native blocking, no webRequest overhead
  • Redirects blocked sites to blocked.html with reason + time remaining
  • Nuclear mode persists across extension reloads (stored in chrome.storage.local)
  • Daily reset via chrome.alarms (configurable time, default midnight)
  • Idle detection pauses time tracking when browser is idle

File Structure

A blocker/
├── manifest.json       # MV3 manifest
├── background.js       # Service worker — all logic
├── popup.html/css/js   # Toolbar popup
├── options.html/css/js # Full settings page (6 tabs)
├── blocked.html/css/js # Redirect page
├── rules.json          # Static ruleset (empty — dynamic rules used)
└── icons/              # 16/48/128px icons

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages