PAGE LØCK3R

Lightweight Chrome/Chromium extension that blocks any URL or page you add to its list. Built by NØM4D as a minimal distraction filter.

What it does

• Blocks any URL or domain you add in the popup list.
• Each blocked entry can be enabled or disabled individually.
• Global toggle in the popup enables or disables all blocking (on by default).
• Background service worker enforces the policy on every tab update.

Install (load unpacked)

1. Clone the repo locally.
2. Open chrome://extensions in Chrome/Chromium and enable Developer mode.
3. Click Load unpacked and select the extension/ folder in this repository.
4. Pin the extension if you want quick access to the popup.

Using the popup

• Open the popup and flip Enable page blocker to turn blocking on or off.
• Add URLs or domains in the input (e.g. example.com, news.ycombinator.com/newest).
• Toggle each entry to enable/disable it or remove it entirely.
• The status console confirms when settings are saved or if an error occurs.

How it works (under the hood)

• extension/plugin/service-worker.js listens to chrome.tabs.onUpdated.
• When the URL matches an enabled entry in blockedPages, the tab is redirected to the custom blocked page.
• Redirects only run when blockerEnabled is true; the toggle controls that flag.
• Permissions used:
  • tabs to read and update the current tab URL.
  • storage to persist the toggle state and blocked list.
  • host_permissions on all HTTP/HTTPS URLs so matching can run.

Project layout

• extension/manifest.json: MV3 manifest and permissions.
• extension/plugin/: popup UI, styles, service worker, and storage helpers.
• extension/docs/: short product docs (index.html in Spanish, index-en.html in English).
• icons/, fonts/, screenshot/: static assets for the extension and docs.

Troubleshooting

• Blocked pages still load: open the popup and ensure the toggle is on, then refresh the tab.
• After changing code, reload the extension in chrome://extensions to refresh the service worker.
• Incognito windows require enabling the extension for that mode in the extensions page.

License

All rights reserved. See LICENSE for usage restrictions.