Popup-Blocker-Pro

Popup Blocker Pro : an open source, free, secure and powerful browser extension that blocks attempts to open tabs in the background without user consent.

By : Fabien Conéjéro

Live Demo :

Try the interactive demo →

About this demo page :

• 100 % standalone page (zero external dependency except Google Fonts). What it does :

• Auto-triggers 2.5s after loading (silent popup intercepted)

• Simulate a real Chrome browser with an address bar, traffic lights, extension icon in the toolbar

• Contains a questionable fake streaming site (FreeMovies4K) to stage the danger

• The extension "slides" into an animated popup from the top-right corner of the window with the real design of the extension

• Functional "Keep Blocked" / "↗ Allow Once" buttons (Allow actually opens the URL)

• Real-time timestamp log, animated statistical counters, red flash on the viewport at each attempt

• Manual buttons: Auto popup, Delayed (1s), Burst 3, Reset

Browser Compatibility :

• Chrome (Manifest V3)
• Firefox (Manifest V2/V3)
• Edge
• Opera
• Brave

Quick Installation :

• Chrome / Edge / Brave / Opera :

1. Unzip popup-blocker-pro-chrome.zip
2. Open chrome://extensions (or edge://extensions, brave://extensions)
3. Enable Developer mode
4. Click on "Load unpacked"
5. Select the unzipped folder

• Firefox :

1. Unzip popup-blocker-pro-firefox.zip
2. Open about:debugging
3. Click on "This Firefox" in the left menu
4. Click on "Load Temporary Add-on"
5. Select the manifest.json file inside the unzipped folder

OFFICIAL DOWNLOAD LINKS

For Google Chrome :

https://github.com/madjeek-web/Popup-Blocker-Pro/raw/main/releases/popup-blocker-pro-chrome.zip

For Mozilla Firefox :

https://github.com/madjeek-web/Popup-Blocker-Pro/raw/main/releases/popup-blocker-pro-firefox.zip

• HOW TO INSTALL THE EXTENSION IN CHROME / Edge / Brave / Opera (Step-by-step instructions with explanations)

STEP 1 : FIND AND DOWNLOAD THE FILE

Go to the GitHub repository :

https://github.com/madjeek-web/Popup-Blocker-Pro

Look for the file popup-blocker-pro-chrome.zip in the file list (inside the releases folder)

RIGHT-CLICK on this file (not left-click)

A menu appears

Choose "Save link as..." or "Download the file"

Choose where to save it (example: Desktop or Downloads)

The file will download to your computer

STEP 2 : UNZIP THE FILE (VERY IMPORTANT!) A ZIP file is like a compressed suitcase. You need to open it to see what's inside.

On Windows :

Go to the folder where you downloaded the file (Downloads or Desktop)

Find popup-blocker-pro-chrome.zip

RIGHT-CLICK on it

In the menu, choose "Extract All..."

A window opens: click on "Extract"

RESULT : A new folder appears, called popup-blocker-pro-chrome (without the .zip at the end)

On Mac :

Simply double-click on the .zip file

It automatically decompresses and creates a folder next to it

WARNING : You must KEEP this unzipped folder! Do not delete it after installation, otherwise the extension will stop working.

STEP 3 : OPEN THE EXTENSIONS PAGE IN CHROME Open Google Chrome (the browser)

In the address bar (at the top, where you type website addresses), type exactly :

chrome://extensions Press Enter

RESULT : You arrive at a page showing all extensions installed in Chrome.

STEP 4 : ACTIVATE DEVELOPER MODE Look at the top RIGHT of the chrome://extensions page

You see a switch called "Developer mode"

Click on it to activate it

The switch changes from gray to blue/green

BUTTONS APPEAR at the top left: "Load unpacked," "Pack extension," etc.

STEP 5 : LOAD THE EXTENSION Click on the "Load unpacked" button (at the top left)

A window opens to choose a folder on your computer

Navigate to the folder you unzipped in STEP 2 :

popup-blocker-pro-chrome (the folder, not the ZIP file!)

Select this folder (click on it once to highlight it)

Click on "Select Folder"

STEP 6 : VERIFY THE EXTENSION IS INSTALLED The extension now appears in the list of extensions on chrome://extensions

Look at the top right of Chrome (near your profile icon)

You should see a new icon appear (the Popup Blocker Pro icon)

The extension is enabled by default and works immediately

HOW TO USE THE EXTENSION Click on the icon in the toolbar

A small window opens with :

An ON/OFF switch to enable/disable

The number of blocked popups

An "Options" button to adjust settings

HOW TO UNINSTALL (IF NEEDED) Go back to chrome://extensions

Find "Popup Blocker Pro" in the list

Click on "Remove" (red button)

Confirm by clicking on "Remove" in the window that opens

• SIMPLE VISUAL SUMMARY :

1. DOWNLOAD → popup-blocker-pro-chrome.zip
2. UNZIP → it becomes a FOLDER
3. CHROME → type chrome://extensions
4. ACTIVATE → Developer mode (switch at top right)
5. CLICK → "Load unpacked"
6. CHOOSE → the unzipped FOLDER
7. DONE → The icon appears at top right

• HOW TO INSTALL THE EXTENSION IN FIREFOX (Step-by-step instructions with explanations)

STEP 1 : FIND AND DOWNLOAD THE FILE Go to the GitHub repository: https://github.com/madjeek-web/Popup-Blocker-Pro

Look for the file popup-blocker-pro-firefox.zip in the file list (inside the releases folder)

RIGHT-CLICK on this file (not left-click)

A menu appears

Choose "Save link as..." or "Download file"

Choose where to save it (example: Desktop or Downloads)

The file downloads to your computer

STEP 2 : UNZIP THE FILE (VERY IMPORTANT!) A ZIP file is like a compressed suitcase. You need to open it to see what's inside.

On Windows :

Go to the folder where you downloaded the file (Downloads or Desktop)

Find popup-blocker-pro-firefox.zip

RIGHT-CLICK on it

In the menu, choose "Extract All..."

A window opens : click on "Extract"

RESULT : A new folder appears, called popup-blocker-pro-firefox (without .zip)

On Mac :

Simply double-click on the .zip file

It automatically decompresses and creates a folder next to it

WARNING: You must KEEP this folder! Do not delete it after installation, otherwise the extension will stop working.

STEP 3 : OPEN THE FIREFOX DEBUGGING PAGE Open Firefox (the browser)

In the address bar (at the top, where you type website addresses), type exactly :

about:debugging Press Enter

RESULT : You arrive at the Firefox debugging page

STEP 4 : CLICK ON "THIS FIREFOX" Look at the left side menu of the about:debugging page

Click on "This Firefox"

RESULT : A page opens showing temporary extensions

STEP 5 : LOAD THE EXTENSION (DIFFERENT FROM CHROME!) Click on the button "Load Temporary Add-on" (under "Temporary Extensions")

A window opens to choose a file on your computer

Navigate to the folder you unzipped in STEP 2 :

popup-blocker-pro-firefox (the folder)

Open this folder (double-click on it)

INSIDE the folder, find and select the file named manifest.json

(Important: In Firefox, you select the manifest.json file, not the folder!)

Click on "Open" or "Select File"

STEP 6 : VERIFY THE EXTENSION IS INSTALLED The extension now appears in the "Temporary Extensions" list

Look at the top right of Firefox (near the menu icon ☰)

You should see a new icon appear (the Popup Blocker Pro icon)

The extension is enabled and works immediately

HOW TO USE THE EXTENSION Click on the icon in the toolbar

A small window opens with :

An ON/OFF switch to enable/disable

The number of blocked popups

An "Options" button to adjust settings

IMPORTANT NOTE FOR FIREFOX Temporary extensions (loaded via about:debugging) only last for the current Firefox session. If you close and reopen Firefox, you'll need to load it again.

For permanent installation, you'll need to submit the extension to Mozilla Add-ons store (or use Firefox Developer Edition for permanent unsigned extensions).

HOW TO UNINSTALL (IF NEEDED) Go back to about:debugging → "This Firefox"

Find "Popup Blocker Pro" in the "Temporary Extensions" list

Click on "Remove" (button on the right)

• SIMPLE VISUAL SUMMARY :

1. DOWNLOAD → popup-blocker-pro-firefox.zip
2. UNZIP → it becomes a FOLDER
3. FIREFOX → type about:debugging
4. CLICK → "This Firefox" (left menu)
5. CLICK → "Load Temporary Add-on"
6. CHOOSE → manifest.json file INSIDE the folder
7. DONE → The icon appears at top right

• KEY DIFFERENCE FROM CHROME : Browser What to select Chrome/Edge/Brave Select the whole FOLDER Firefox Select the manifest.json FILE inside the folder

Project Structure

popup-blocker-pro/
├── src/
│   ├── manifest.json (with browser-specific configurations)
│   ├── background.js (service worker)
│   ├── content.js (injected script)
│   ├── popup.html (user interface)
│   ├── popup.css (styles)
│   ├── popup.js (popup logic)
│   ├── options.html (options page)
│   ├── options.js
│   └── icons/
│       ├── icon16.png
│       ├── icon32.png
│       ├── icon48.png
│       └── icon128.png
├── docs/
│   └── README.md
├── .gitignore
├── LICENSE (MIT)
└── package.json

Required Features Core Features : Detection and blocking of popup/window opening attempts:

window.open() without user interaction

Links with target="_blank" using scripts

Redirects via JavaScript

Iframes attempting to open windows

User Interface : Toolbar icon

Control popup with :

ON/OFF switch

Block counter

Quick access to settings

Options page with:

Whitelist (authorized sites)

Protection levels (basic/strict)

Visual notifications

Security : No data collection

Minimal required permissions

Auditable and commented code

Automatic updates via GitHub

Development Instructions Manifest.json Structure: Permissions: ["storage", "webNavigation", "tabs"]

Host_permissions: ["<all_urls>"] or optional

Persistent background service worker

Detection Algorithm :

javascript :

 // Logic to implement
- Intercept window.open attempts
- Check source (user click vs. script)
- Block if not user-initiated

---

Installation from GitHub Clear instructions in README

Prepared build files

Packaging scripts for each browser

Installation and Packaging For Users : Download from GitHub Releases

Step-by-step instructions for each browser :

Chrome/Edge/Brave: Developer mode → Load unpacked extension

Firefox : about:debugging → Load Temporary Add-on

For Developers :

git clone [your-repo]
npm install
npm run build  # Generates builds for each browser

Required Tests Tests on various websites known for popups

Performance tests (memory/CPU impact)

Cross-browser compatibility tests

Security tests

Documentation to Provide Complete README.md in English/French

Installation guide

User guide

Privacy policy

MIT License

Expected Deliverables Complete and commented source code

Ready-to-use builds

User documentation

Automation scripts

Video demo (optional)

Popup Blocker Pro

Complete popup blocking extension for Chrome, Firefox, Edge, Brave, and Opera.

File Structure

Complete extension, file by file

File	Description
manifest.json	Manifest V3 for Chrome/Edge/Brave/Opera
manifest.firefox.json	Manifest V2 for Firefox
background.js	Service worker - core blocking logic
content.js	Content script - primary popup interception
popup.html	Toolbar popup interface
popup.css	Popup CSS styles
popup.js	Popup JavaScript logic
options.html	Options page
options.js	Options page script

Icon management

File	Description
build.js	Icon generation script
package.json	npm configuration and dependencies
LICENSE	MIT License
.gitignore	Git ignored files
README.md	Complete bilingual documentation

Installation packages

File	Description
popup-blocker-pro-chrome.zip	Ready-to-use extension for Chrome, Edge, Brave, Opera (MV3)
popup-blocker-pro-firefox.zip	Ready-to-use extension for Firefox (MV2)
popup-blocker-pro-source.zip	Complete source code with build scripts

Implemented Architecture

Main components

File	Role
content.js	Protection core, injected at document_start: • Replaces window.open() in a non-configurable way • Uses navigator.userActivation (native API Chrome 72+/Firefox 107+) • Intercepts synthetic clicks on target="_blank" links • Displays a discreet notification at bottom right
background.js	Secondary defense layer: • Intercepts via webNavigation.onCreatedNavigationTarget • Manages badge with per-tab counter • Centralizes statistics
Interface	Popup + Options page: • ON/OFF toggle • Session/tab/global counters • "Allow site" button (one-click whitelist) • Basic / Strict levels • Visual whitelist management

Quick Installation :

• Chrome / Edge / Brave / Opera :

1. Unzip popup-blocker-pro-chrome.zip
2. Open chrome://extensions (or edge://extensions, brave://extensions)
3. Enable Developer mode
4. Click on "Load unpacked"
5. Select the unzipped folder

• Firefox :

1. Unzip popup-blocker-pro-firefox.zip
2. Open about:debugging
3. Click on "This Firefox" in the left menu
4. Click on "Load Temporary Add-on"
5. Select the manifest.json file inside the unzipped folder

Multi-test diagnostic page with visual interface. Download the html test page, to see in real time how the Pro popup blocker extension works :

popup-blocker-pro-test.html{:target="_blank" rel="noopener noreferrer"}

If you simply want to display the page in the browser (to use it directly without downloading), use instead :

🌐 https://madjeek-web.github.io/popup-blocker-pro-test.html

COMPREHENSIVE EXTENSION TEST PAGE TEST : Complete HTML diagnostic page with multiple test scenarios (auto, manual, iframe, scripted links) — each test displays in real-time with PASS/FAIL. Security terminal style.

File created, read a file: popup-blocker-pro-test.html

What This Test Page Does Automatic Tests (launched on page load)

Scenario What It Verifies

1 window.open() automatic Basic popup blocking 2 window.open("https://…") Popup with real URL 3 window.open(…, "features") Popup with window options 4 Delayed popup (1 second with setTimeout) Classic ad site technique 5 Fake mousemove + window.open Attempt to bypass detection 6 Attempt from an iframe Multi-frame protection

Manual Tests (you click) Scenario What It Verifies Real user click Checks that the extension isn't too aggressive (should allow it) target="_blank" link Behavior of a standard link Burst × 5 5 popups at once

Interface Feature Description Global banner Turns green/red in real-time Score display Example : 6 / 6 Event log Timestamped log at the bottom Design Terminal/cybersecurity theme consistent with the extension

How to Use Install the extension

Open popup-blocker-pro-test.html in your browser

Tests run automatically - everything should pass in green

Graphic Video

Popup Blocker Pro, just the word popup made me think of popcorn jumping in the air, like an internet window that opens without warning and of course without your consent. I imagined the logo in this spirit, playful and fun and explicit at the same time: the popcorn in zero gravity refers to popup and the purple children's toy is rectangular in shape to evoke the idea of a window in reference to a web page (the square and rectangle side of screens on our various devices). This little amusing video is therefore the popcorn (the corn, cereal, grain) that comes to fight the purple window, in reference to the function of this extension that comes to block, fight against, and combat. Some web browser security extensions have a shield as their icon, here in this video, the hidden subtlety is that the popcorn kernel also has this same shape of a triangular shield with an ogival point.

Fabien Conéjéro

See video file : HD-video-popup-blocker-pro-HD.mp4

SECURITY BONUS :

RECOMMENDED EXTENSIONS In addition to Popup Blocker Pro, here are extensions that enhance your online security and privacy :

_{HTTPS Everywhere Automatically redirects to the HTTPS version of websites for a more secure and encrypted browsing experience.}

_{McAfee® WebAdvisor Browse safely : McAfee® WebAdvisor warns you about dangerous sites, suspicious links, and malicious downloads}

_{Privacy Badger Blocks hidden trackers. Created by the EFF (Electronic Frontier Foundation), a digital rights nonprofit, to prevent companies from spying on you.}

_{uBlock Origin Lite An efficient and lightweight content blocker. Blocks intrusive ads, trackers, cryptocurrency miners, and more, right after installation.}

_{Bitdefender TrafficLight (NEW) A lightweight extension from renowned security company Bitdefender. It displays a color-coded indicator (green/red) next to search results to warn you about dangerous sites. It also blocks phishing attempts, malware, and fraudulent websites in real-time.}

_{Bitwarden (NEW) An open-source password manager, widely recognized as one of the most secure and reliable. It stores your passwords, credit cards, and notes in an encrypted vault, automatically fills them on websites, and syncs across all your devices. The free version is extremely generous.}

_{Guardio (NEW) A powerful security extension that protects against phishing, malicious sites, and scams. It actively blocks harmful websites and alerts you if your personal information (email, passwords) has been exposed in a data breach. It's a comprehensive solution that secures your browser without slowing it down.}

. Why These Extensions ?

These 7 extensions perfectly complement Popup Blocker Pro for maximum protection :

Extension Primary Role HTTPS Everywhere Encrypts your connections McAfee WebAdvisor Protects you from dangerous sites Privacy Badger Blocks invisible trackers uBlock Origin Lite Removes ads and miners Bitdefender TrafficLight Visual indicator for safe/unsafe sites Bitwarden Secure password manager Guardio All-in-one browser security Together, these extensions + Popup Blocker Pro = a safer, more private, and worry-free browsing experience !

༄☕︎︎︎ Buy Me A Coffee :

༄☕︎︎︎ stripe.com

. Thank you for your support