🛡️ PureGuard

A free browser extension that blocks adult (18+) websites, images, videos and removes ads.

🌟 What is PureGuard?

PureGuard keeps your browsing clean and safe. It blocks adult websites from opening, hides adult images and videos on normal pages, turns on SafeSearch in major search engines, and removes ads and pop-ups — all completely free, no account needed, works fully offline inside your browser.

You stay in control. One big shield button switches all protection on or off, and two switches control the adult filter and the ad blocker separately.

📋 Table of Contents

#	Section
1	Features
2	Install
3	How to Use
4	How It Works
5	Project Structure
6	Permissions
7	Privacy
8	Limitations
9	Troubleshooting
10	FAQ
11	Build from Source
12	Updating Block Lists
13	Roadmap
14	Credits
15	Contributing
16	License

✨ Features

🔞 Adult Content Protection

Feature	What it does
🚫 Adult website blocking	About 118,000 adult domains blocked. Shows a "This page was blocked" page instead.
🔗 Address keyword blocking	Blocks URLs containing words like `porn`, `xxx`, `hentai`, `xvideo`, `xnxx`.
🖼️ Embedded content blocking	Images, videos, scripts and frames from adult domains are blocked even on normal websites.
👁️ Image and video hiding	Images/videos whose filename, alt text, title or surrounding text look adult are hidden.
🏷️ Page label detection	Pages with `RTA` label or `rating: adult/mature` are blocked automatically.
📝 Title & description check	Pages whose title, description or keywords contain adult terms are blocked.
🔍 SafeSearch	Turns on SafeSearch for Google (`safe=active`), Bing (`adlt=strict`) and DuckDuckGo (`kp=1`).

🚫 Ad Blocking

Feature	What it does
📡 Ad network blocking	About 96,000 ad, tracker and pop-up domains blocked.
🎯 Banner hiding	Google AdSense, Taboola, Outbrain and "advertisement" containers hidden.

🎛️ Controls & Interface

🔘 One-click on/off shield button — toolbar icon shows OFF badge when off
⚙️ Separate switches for Adult content and Ads
📊 Live status line showing items hidden on current page
🔢 Counter of all images and videos hidden so far
⚠️ Clear error message if block lists fail to load
♿ Keyboard-friendly and reduced-motion support

📥 Install

Download the ZIP for your browser from the Releases page.

Browser	ZIP File
Chrome, Edge, Brave, Safari	`pureguard-chrome-edge-brave-safari.zip`
Firefox	`pureguard-firefox.zip`

🟡 Chrome, Edge and Brave

Unzip the file into a folder
Open the extensions page:
- Chrome → chrome://extensions
- Edge → edge://extensions
- Brave → brave://extensions
Turn on Developer mode
Click Load unpacked → select the unzipped folder (the one containing manifest.json)
Refresh every tab that is already open

💡 To update: Replace old folder files with new version → click reload icon on PureGuard card → refresh tabs.

🟠 Firefox

Unzip the Firefox file
Open about:debugging#/runtime/this-firefox
Click Load Temporary Add-on → select manifest.json
Open about:addons → PureGuard → Permissions → allow Access your data for all websites

⚠️ Firefox removes temporary add-ons when the browser closes. For a permanent install, the add-on must be signed on addons.mozilla.org.

🔵 Safari (Mac only)

Install Xcode

In Terminal, run:

xcrun safari-web-extension-converter /path/to/pureguard

Build and run the generated project in Xcode
Enable PureGuard in Safari → Settings → Extensions

🧭 How to Use

Click the PureGuard icon in the toolbar (pin it from the puzzle-piece menu)
Press the big shield button to turn all protection on or off
Use Adult content and Ads switches to control each part separately
Read the This page line:
- This page: 3 hidden, 12 blocked → PureGuard is working ✅
- Not active on this page yet → Reload the tab
- Open a website to see activity → Appears on browser pages (new tab, etc.)

Changes take effect immediately — no restart needed.

⚙️ How It Works (In Detail)

PureGuard has four parts that work together:

1. 🌐 Network Rules (`rules/*.json`)

The browser's declarativeNetRequest system stops blocked requests before they load.

Rule Set	File	Contents
`adult`	`rules/adult.json`	~118,000 adult domains + keyword URL blocking
`ads`	`rules/ads.json`	~96,000 ad, tracker and pop-up domains
`safesearch`	`rules/safesearch.json`	SafeSearch parameters for Google, Bing, DuckDuckGo

2. 📄 Content Script (`content.js`)

Runs on every page, at start of loading, in every frame.

Checks <img>, <video>, <picture> and <iframe> sources
Climbs up 7 DOM levels to find and hide entire adult content cards
Re-checks on infinite scroll, lazy loading, and after 1.5, 4 and 9 seconds
Hidden elements get visibility: hidden + data-pg-hidden marker

3. 🪟 Popup (`popup.html`, `popup.css`, `popup.js`)

Reads/writes settings
Shows current tab status
Shows blocked request count (Chrome-based)
Shows errors if block lists fail

4. 🚫 Blocked Page (`blocked.html`)

Simple redirect page with Go back button shown when a site is blocked.

📁 Project Structure

pureguard/
├── manifest.json                 # Chrome / Edge / Brave / Safari
├── manifest.firefox.json         # Firefox manifest
├── background.js                 # Switches rule sets on/off
├── content.js                    # Hides adult images/videos, blocks pages
├── popup.html                    # Popup layout
├── popup.css                     # Popup design
├── popup.js                      # Popup logic and status
├── blocked.html                  # Blocked website redirect page
├── blocked.css
├── blocked.js
├── assets/
│   └── logo.png                  # PureGuard logo
├── icons/
│   ├── icon16.png
│   ├── icon48.png
│   └── icon128.png
├── rules/
│   ├── adult.json                # Adult domain rules
│   ├── ads.json                  # Ad / pop-up domain rules
│   └── safesearch.json           # SafeSearch rules
└── tools/
    └── build_rules.py            # Regenerates rule files from public lists

🔐 Permissions

Permission	Why it is needed
`storage`	Saves settings and counter on your device
`declarativeNetRequest`	Blocks adult and ad requests
`declarativeNetRequestFeedback`	Shows blocked request count in popup (Chrome only)
`<all_urls>`	Lets content script hide adult images/ads on any website

✅ PureGuard does not request access to your history, bookmarks, downloads or cookies.

🔒 Privacy

PureGuard does not collect, store or send any personal data or browsing history.

✅ No server
✅ No analytics
✅ No tracking
✅ No account required
✅ All checks happen inside your browser
✅ Only your settings and a counter are saved in local browser storage

⚠️ Limitations

Does not look at image pixels — blocking is text-based (filenames, alt text, labels). An adult image with no adult words nearby may still appear.
Block lists are not perfect — new adult/ad domains not yet on the lists won't be blocked until updated.
False positives can happen — a normal page with words like "adult" or "sexy" near an image may be hidden.
Not a parental-control system — anyone with browser access can switch it off. Use with OS or router parental controls for children.
Firefox needs all-websites permission granted manually, and temporary add-ons disappear on restart.
Private/incognito windows only work if you allow the extension in those windows.

🛠️ Troubleshooting

Problem	Fix
Nothing is blocked	Refresh the tab. Check shield button says "Protection is on".
Popup says "Not active on this page yet"	Reload the tab
New version not showing after update	Click reload icon on extension card → refresh tabs
"Block lists failed to load"	Reload the extension. If it stays, open Errors on extensions page and report it.
Firefox: nothing happens	Allow Access your data for all websites in `about:addons` → PureGuard → Permissions
A normal website is blocked	Turn Adult content switch off → report the site in an Issue
A site looks broken	Turn Ads switch off → report the site
"Load unpacked" shows manifest error	Select the folder directly containing `manifest.json`, not a parent folder
Works in normal window, not incognito	Enable Allow in Incognito in extension details

❓ FAQ

Is it really free?

Yes. No paid plans, accounts or ads. Free forever.

Does it slow down my browser?

Rules are handled by the browser natively and are very fast.

Does it work on my phone?

Chrome for Android does not support extensions. Firefox for Android supports a limited set. PureGuard has not been tested on phones yet.

Can I add my own sites to block?

Not from the popup yet. You can add domains to EXTRA_ADULT or EXTRA_ADS in tools/build_rules.py and rebuild.

Can I allow one website?

Not yet — allow list is on the roadmap.

Why is an image still visible?

PureGuard reads text, not pixels. See Limitations.

Does it block ads on YouTube?

Not reliably. YouTube serves ads from its own domains.

🔨 Build from Source

# Step 1 — Clone the repository
git clone https://github.com/RongonKairy/pureguard.git
cd pureguard

# Step 2 — Load as unpacked extension (see Install section)

# Firefox build:
# Copy folder → replace manifest.json with manifest.firefox.json → zip it

# Chrome build:
# Zip the folder without manifest.firefox.json

🔄 Updating the Block Lists

The rules/ files are generated by tools/build_rules.py.

Download the newest lists into a lists/ folder:

File	Source
`nsfw.txt`	Hagezi `wildcard/nsfw-onlydomains.txt`
`porn.txt`	StevenBlack `alternates/porn-only/hosts`
`light.txt`	Hagezi `wildcard/light-onlydomains.txt`
`popupads.txt`	Hagezi `wildcard/popupads-onlydomains.txt`

Run the script:

python3 tools/build_rules.py lists rules

Reload the extension

🗺️ Roadmap

✅ Allow list ("never block this website") in popup
📝 Custom block list in popup
🔐 Optional PIN/password to prevent others switching off
🤖 On-device image recognition for adult images with no text clues
🌍 Bangla and multi-language interface
🏪 Published on Chrome Web Store, Edge Add-ons and Firefox Add-ons

🙏 Credits

Block lists used to generate the rules:

Hagezi DNS Blocklists — NSFW, Light and Pop-up Ads lists
StevenBlack/hosts — porn-only list

🤝 Contributing

Bug reports and ideas are welcome!

Report a problem: Open an Issue with the website address, browser name/version, PureGuard version, and what you expected.
Submit a change: Fork → make change → test as unpacked extension → open a Pull Request.

📄 License

This project is licensed under the MIT License — free to use, share, and modify.

MIT License
Copyright (c) 2026 RongonKairy

PureGuard — Browse Clean. Stay Safe. Forever Free.

⭐ If you find PureGuard useful, please give it a star on GitHub!

Name		Name	Last commit message	Last commit date
assets		assets
License		License
README.md		README.md

Navigation Menu

Repository navigation

About

Repository files navigation

🛡️ PureGuard

🌟 What is PureGuard?

📋 Table of Contents

✨ Features

🔞 Adult Content Protection

🚫 Ad Blocking

🎛️ Controls & Interface

📥 Install

🟡 Chrome, Edge and Brave

🟠 Firefox

🔵 Safari (Mac only)

🧭 How to Use

⚙️ How It Works (In Detail)

1. 🌐 Network Rules (`rules/*.json`)

2. 📄 Content Script (`content.js`)

3. 🪟 Popup (`popup.html`, `popup.css`, `popup.js`)

4. 🚫 Blocked Page (`blocked.html`)

📁 Project Structure

🔐 Permissions

🔒 Privacy

⚠️ Limitations

🛠️ Troubleshooting

❓ FAQ

🔨 Build from Source

🔄 Updating the Block Lists

🗺️ Roadmap

🙏 Credits

🤝 Contributing

📄 License

About

Releases

Packages

Contributors

Latest commit

History

Folders and files

Repository files navigation

🛡️ PureGuard

🌟 What is PureGuard?

📋 Table of Contents

✨ Features

🔞 Adult Content Protection

🚫 Ad Blocking

🎛️ Controls & Interface

📥 Install

🟡 Chrome, Edge and Brave

🟠 Firefox

🔵 Safari (Mac only)

🧭 How to Use

⚙️ How It Works (In Detail)

1. 🌐 Network Rules (rules/*.json)

2. 📄 Content Script (content.js)

3. 🪟 Popup (popup.html, popup.css, popup.js)

4. 🚫 Blocked Page (blocked.html)

📁 Project Structure

🔐 Permissions

🔒 Privacy

⚠️ Limitations

🛠️ Troubleshooting

❓ FAQ

🔨 Build from Source

🔄 Updating the Block Lists

🗺️ Roadmap

🙏 Credits

🤝 Contributing

📄 License

About

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

1. 🌐 Network Rules (`rules/*.json`)

2. 📄 Content Script (`content.js`)

3. 🪟 Popup (`popup.html`, `popup.css`, `popup.js`)

4. 🚫 Blocked Page (`blocked.html`)