Website Blocker with Timer

WHAT IT DOES

Website Blocker with Timer helps you stay focused by blocking access to distracting websites for a set period. When you visit a blocked site, a full-page overlay appears with a motivational message and a countdown timer showing how much time remains. You can add or remove sites from the block list at any time. The tool supports scheduled blocking, allowing you to set specific hours when blocking is active (e.g., 9 AM to 5 PM). An optional password-protected override lets you unblock sites when you need to, preventing accidental unblocking. The timer continues running even if you refresh the page or navigate away.

WHERE IT RUNS

The extension runs entirely within your browser's local environment using the BotGentz framework. All site blocking, timer counting, and schedule checking occur on your machine without any network requests. No browsing data, blocked site history, or user activity is ever transmitted, uploaded, or stored externally. The tool works on any website and respects the browser's security boundaries, operating within the isolated extension sandbox. The block list and settings are stored locally using GM_setValue.

HOW TO USE

Click the extension toolbar icon to open the Website Blocker with Timer panel. To add a site, enter the domain name (e.g., "facebook.com") in the "Add Site" field and click "Add Site"—the site appears in the blocked sites list. Click "Remove" next to any site to remove it from the list. Set the "Block duration" in minutes (1-1440) to control how long sites remain blocked. Toggle "Enable schedule" to activate scheduled blocking, then set the "Start time" and "End time" in HH:MM format (e.g., 09:00 to 17:00). Set an "Override password" (4+ characters) to allow unblocking with a password. When a blocked site is loaded during an active schedule, a full-page overlay appears with a countdown timer and progress bar. Enter the override password and click "Unblock" to bypass the block.

THE BLOCKING ENGINE — WHY IT WORKS

Most website blockers rely on browser extensions with special permissions or DNS-based filtering. This tool uses a DOM-based approach: when you visit a page, the script checks if the current domain matches any entry in the blocked sites list. If a match is found and the current time falls within the scheduled block window, the tool creates a full-page overlay using fixed positioning with z-index 999999, completely covering the page content. The overlay includes a countdown timer that updates every second using setInterval, and a progress bar showing the elapsed time. The timer state is stored in memory using blockStartTime (timestamp) and blockDuration, so the countdown persists across page refreshes. The schedule check uses time string comparison (HH:MM format) to determine if blocking should be active. The password override stores the hashed password in GM_setValue and compares it on unblock attempts. This approach provides a reliable, self-contained blocking solution without requiring any external permissions.

THE PANEL

The Website Blocker with Timer panel is fully draggable by its title bar and remembers its position on screen per website. It snaps to the edges of your browser window for clean alignment. Collapse the panel to a compact icon strip using the minimize button, restoring it with a single click. Resize the panel by dragging any edge or corner; the site list and controls adjust proportionally. Press the Escape key to close the panel instantly. The panel maintains independent state for each browser tab, allowing you to manage blocking in multiple tabs simultaneously.

PLEASE NOTE

This extension requires the free BotGentz extension framework to be installed and enabled. The tool blocks sites by overlaying the page content; it does not prevent the page from loading in the background. The override password is stored in plain text locally; use a password you're comfortable storing. The schedule uses your system time; ensure your clock is accurate. All blocking data is processed locally and is never transmitted, logged, or shared. The extension requests no network permissions and functions entirely offline. The source code is fully auditable and available for review.