A Firefox extension that blocks web browsing when your public IP is not in a list of allowed IPs. A browser-integrated VPN killswitch to protect your privacy.
Une extension Firefox qui bloque la navigation web lorsque votre IP publique n'est pas dans une liste d'IPs autorisées. Un killswitch VPN intégré au navigateur pour protéger votre vie privée.
| Mode | Description (EN) | Description (FR) |
|---|---|---|
| Killswitch | Blocks ALL browsing when VPN is disconnected | Bloque TOUTE la navigation quand le VPN est déconnecté |
| Blacklist | Only blocks specific domains without VPN | Bloque uniquement certains domaines sans VPN |
- ✅ Automatic IP monitoring - Periodic checks (10s to 5min intervals)
- ✅ Multiple VPN IPs - Add several allowed IP addresses
- ✅ Domain wildcards - Support for
*.example.compatterns - ✅ Bilingual UI - French and English interface
- ✅ Modern dark theme - Clean and intuitive interface
- ✅ Block page - Informative page when access is denied
- ✅ Persistent settings - Configuration saved locally
| Protected | Blocked | Blacklist Mode |
|---|---|---|
 |
 |
- Open Firefox and navigate to
about:debugging - Click on "This Firefox" (or "Ce Firefox")
- Click "Load Temporary Add-on..."
- Select the
manifest.jsonfile from the extension folder
- Package the extension as a
.xpifile - Go to
about:addonsin Firefox - Click the gear icon → "Install Add-on From File..."
- Select the
.xpifile
- Click the shield icon in the Firefox toolbar
- Connect to your VPN
- Click "Add current IP" to whitelist your VPN's IP address
- Enable the protection with the toggle switch
When enabled, all websites are blocked if your IP changes from the allowed list. Perfect for:
- Torrenting
- Accessing geo-restricted content
- Maximum privacy protection
Only specific domains are blocked without VPN. Perfect for:
- Streaming services (Netflix, Hulu, BBC...)
- Accessing region-locked content
- Keeping normal browsing accessible
netflix.com → Blocks netflix.com
*.netflix.com → Blocks all subdomains (www.netflix.com, help.netflix.com, etc.)
┌─────────────────────────────────────────────────────────┐
│ VPN Killswitch │
├─────────────────────────────────────────────────────────┤
│ │
│ 1. Extension checks public IP periodically │
│ └── Uses: ipify.org, ipinfo.io, ip.sb │
│ │
│ 2. Compares current IP with allowed list │
│ │
│ 3. If IP not allowed: │
│ ├── Killswitch Mode → Block ALL requests │
│ └── Blacklist Mode → Block only listed domains │
│ │
│ 4. Redirects blocked requests to info page │
│ │
└─────────────────────────────────────────────────────────┘
vpn-killswitch-extension/
├── manifest.json # Extension configuration
├── popup.html # Main popup interface
├── blocked.html # Block page displayed when access denied
├── css/
│ └── popup.css # Styles (dark theme)
├── js/
│ ├── background.js # Core logic (IP check, request blocking)
│ ├── i18n.js # Translations (FR/EN)
│ └── popup.js # Popup UI logic
└── icons/
├── icon-48.svg
└── icon-96.svg
| Permission | Reason |
|---|---|
webRequest |
Intercept and block web requests |
webRequestBlocking |
Block requests before they complete |
storage |
Save settings locally |
<all_urls> |
Monitor all website requests |
- ❌ No data collection
- ❌ No external servers (except IP check services)
- ❌ No analytics or tracking
- ✅ All data stored locally in your browser
- ✅ Open source code
Contributions are welcome! Feel free to:
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
Protect your privacy. Stay safe online.