https://github.com/z1nc0r3/facebook-ad-blocker

A lightweight Chrome extension that automatically detects and hides Sponsored posts on Facebook.
https://github.com/z1nc0r3/facebook-ad-blocker

ad adblock adblocker chrome-extension facebook fb

Last synced: 15 days ago
JSON representation

A lightweight Chrome extension that automatically detects and hides Sponsored posts on Facebook.

• Host: GitHub
• URL: https://github.com/z1nc0r3/facebook-ad-blocker
• Owner: z1nc0r3
• Created: 2025-09-20T19:15:44.000Z (9 months ago)
• Default Branch: main
• Last Pushed: 2025-09-20T19:31:45.000Z (9 months ago)
• Last Synced: 2025-09-20T21:19:31.405Z (9 months ago)
• Topics: ad, adblock, adblocker, chrome-extension, facebook, fb
• Language: JavaScript
• Homepage:
• Size: 7.81 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# Facebook Sponsored Post Blocker (Chrome Extension)

A lightweight Chrome extension that automatically detects and hides **sponsored posts** on Facebook.  

It works by reconstructing obfuscated "Sponsored" labels, so even when Facebook scrambles the letters, this extension still catches them.

## ✨ Features

- 🔍 Detects sponsored posts by reconstructing hidden "Sponsored" text.  

- 🚫 Hides sponsored posts from your feed (default behavior).  

- 🟨 Debug Mode: highlight sponsored posts instead of hiding them.

  

- 📌 Optional banners: show a placeholder banner where the post was hidden.

  

## ⚙️ Installation (Developer Mode)

1. Clone or download this repository.  

2. Open **Chrome** → go to `chrome://extensions/`.  

3. Enable **Developer mode** (top-right).  

4. Click **Load unpacked** and select the project folder.  

5. The extension will appear in your toolbar.

## 🔧 Usage

- By default, sponsored posts are hidden.  

- Click the extension icon to open the pop-up:  

  - **Enable/Disable** – master switch to toggle functionality.  

  - **Debug Mode** – highlights posts instead of hiding them.  

  - **Show Banner** – places a placeholder for the hidden sponsored posts.  

### ToDo:

- [ ] Update **Show Banner** option to add toggle the hidden post.

---

### ⚠️ Disclaimer

This extension is for **educational purposes only**.  

Facebook may change its DOM structure at any time, which could break detection.