A free, open-source, and strict website blocker for Windows 11 with cross-browser extension support.
Jiyuu has been recognized by the open-source community on SourceForge with prestigious achievements:
|
|
Awarded to Jiyuu for demonstrating exceptional growth, rapid user adoption, and community engagement since its launch. This award highlights the project's dedication to providing a high-quality, secure website-blocking solution for Windows. |
Jiyuu is a system-level website blocker designed to help you regain control over your digital habits. By pairing a robust Windows desktop application with a lightweight browser extension, Jiyuu ensures complete blocking coverage without loophole workarounds.
- System-Level Control: Desktop-level service, analytics engine, and configuration manager.
- Real-Time Blocking: Uses high-speed WebSockets to communicate block lists to Chromium- and Mozilla-based browsers instantly.
- Tamper-Proof Design: Employs uninstall and bypass prevention mechanisms to stop you from cheating your blocking rules.
- Lock Enforcement: Restricts access to supported browsers, closing options to bypass the blocker using minor browsers.
- 🚫 Domain & Keyword Blocking: Block specific URLs, complete domains, or custom keywords.
- 🎨 Custom Blocking Modes:
- Cover: Completely overlays the blocked webpage.
- Mute: Mutes all audio and video elements automatically.
- Grayscale: Removes colors from the screen to make bad habits less stimulating (scientifically proven to decrease digital impulse).
- Blur: Heavy Gaussian blur filter makes the restricted pages completely unreadable.
- 📁 Block Groups: Categorize and manage your blocked domains dynamically.
- 📊 Intuitive UI & Analytics: A modern dashboard containing detailed analytics tracking website usage across all active sessions.
- 🔒 Multi-Method Locking: Secure your groups with custom rules:
- Usage Limit: Activates blocks automatically when you exceed a certain browsing duration.
- Random Typing: Lock groups until you type a randomly generated string (copy-paste is disabled) to counter impulsive bypass urges.
- Time Limit: Hard-lock settings for a set number of days.
- Password: Protect adjustments with a password.
- 🛡️ Self-Healing Mechanics: The application automatically restarts background services if stopped, preventing easy task-kill workarounds.
- 🧭 Multi-Browser Sync: Runs seamlessly across Chrome, Firefox, Edge, Brave, and Opera.
- 🔍 Deep Request Analysis: Scans both page URLs and response headers to prevent trick bypass methods.
- 🕶️ Enforced Incognito Mode: Enforces installation and execution inside private/incognito windows to prevent loophole usage.
- Node.js v22.14.0 or higher
-
Clone the repository:
git clone https://github.com/xinzhao2627/jiyuu.git
-
Run the Desktop App (Electron):
cd jiyuu npm install npm run dev -
Run the Browser Extension (WXT):
cd extension npm install npm run dev
Caution
WSL, Docker, and Virtualization Conflict In some instances, applications that manipulate local network interfaces (such as WSL, Docker Desktop, or Kubernetes orchestrators) can interfere with the WebSocket server used by Jiyuu. If the extension cannot connect to the desktop application, run the following commands in an Administrator PowerShell session to restart the Windows NAT Driver:
# Stop the NAT driver
net stop winnat
# Start the NAT driver
net start winnat| Browser | Support Status |
|---|---|
 Google Chrome |
Supported |
 Mozilla Firefox & variants |
Supported |
 Brave Browser |
Supported |
 Opera Browser |
Supported |
| Opera GX |
Supported |
 Microsoft Edge |
Supported |
- Desktop Framework: Electron (with Vite) & electron-builder
- Frontend: React & Material UI (MUI)
- State Management: Zustand
- Database: SQLite with Kysely query builder
- Communication: WebSockets (ws) for real-time app-to-extension communication
- Browser Extension: WXT Framework for cross-browser extensions
- Installer: NSIS (Nullsoft Scriptable Install System)
This project is licensed under the terms of the GNU General Public License v3.0.