Skip to content

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

FB Feed Diet - Clean Feed & Ads Declutter for Facebook

GitHub release License: MIT Sponsor

中文說明 | Español | English

👉 Driectly download.

FB Feed Diet is a browser extension for Facebook designed to hide sponsored posts, recommended content, Reels, and ads from your news feed, decluttering your reading experience.

Folded posts are replaced with a sleek title bar that can be expanded anytime with a single click, without abruptly removing blocks or breaking page layout. You can also customize folding rules and display preferences to suit your reading habits.

Preview

Before Filtering After Filtering (Ads & Suggestions)
Before Filtering After Filtering

Features

Standard Mode (Default)

  • Block Ads (Sponsored Content): Folds sponsored posts, Marketplace recommendations, and search ads.
  • Block Suggestions (Recommended Posts): Folds algorithmic recommendations like "Suggested for you".
  • Hide Short Videos (Reels & Stories): Optional toggles to fold Reels and Stories carousels.
  • Live Stats: Counts daily blocked ads, suggestions, and video items.
  • Hover Preview: Hover your cursor over the title bar to preview full post content without clicking "See more".
  • Expand & Collapse Anytime: Replaces folded content with title bars; click anywhere on the bar to reveal the post.
Regular Post Hover Tooltip Preview Folded State
Regular Post Hover Tooltip Preview Folded State

Forum / Index Mode

  • Custom Folding Rules: Ideal if you prefer skimming headlines and clicking to expand only what interests you.
  • Appearance Customization: Customize title bar height (18px or 36px, default 18px).

Minimized Mode

Installation

Google Chrome

Method 1: Chrome Web Store

Coming soon.

Method 2: Download Release Package

  1. Go to the Releases page and download the latest Chrome ZIP package.
  2. Extract the ZIP file to a local folder and keep the folder intact for your browser to load.
  3. Open Google Chrome and navigate to chrome://extensions/.
  4. Enable Developer mode in the top-right corner.
  5. Click Load unpacked.
  6. Select the extracted project folder.
  7. Open Facebook.

Once loaded, the extension will be active on Facebook pages.

Firefox (128 or newer)

Currently loadable via Firefox's Temporary Add-on feature:

  1. Download or clone this repository.
  2. Open Firefox and navigate to about:debugging#/setup/runtime/this-firefox.
  3. Click Load Temporary Add-on….
  4. Select manifest.json in the project directory.
  5. Open Facebook.

Note: Temporary add-ons in Firefox are unloaded when the browser restarts; repeat step 3 to reload.

How to Use

Quick Toggle

Click the FB Feed Diet icon in your browser toolbar to instantly toggle filtering and view current diet statistics.

Popup

Configure Settings

Open "Options" in the extension popup:

  • Folding rules for the five main post categories.
  • Title bar height, title snippet display, hover text preview, and more.
  • Interface language (English / Traditional Chinese / Spanish) and Light / Dark theme mode.
  • Detection engine (Relay or DOM).
Live Stats & Categories Appearance & Detection Mode
Live Stats & Categories Appearance & Detection Mode

Privacy & Permissions

FB Feed Diet is designed with a local-first privacy architecture:

  • Zero Data Collection: No user data, browsing history, or feed content is collected, tracked, or transmitted. Zero telemetry, no backend servers, no external network requests.
  • 100% Local Storage: All preferences and filtering statistics are stored strictly on your local device (chrome.storage.local).
  • Minimal Permissions:
    • Host permission (*://*.facebook.com/*): Only used to execute filtering logic on Facebook pages.
    • storage: Stores local preferences and statistics.
    • scripting: Synchronizes settings dynamically with already-open Facebook tabs.
  • Open Source & Transparent: All code is open source and verifiable.
  • Privacy Policy: For full terms, please refer to PRIVACY.md.

Compatibility & Limitations

  • Supports Firefox, Google Chrome, Microsoft Edge, and other Chromium-based browsers.
  • Facebook frequently updates its DOM structure, post formatting, and internal data structures, which may cause classifiers to break over time.
  • Provides two classification engines: Relay (direct inspection of Facebook's raw GraphQL data) and DOM (broader rendered page scanning).
  • If you encounter unclassified posts or anomalies, feel free to report them on Issues with the feed probe log attached.

Acknowledgements

This project was inspired by:

Support the Project

Facebook updates frequently, and keeping the filters working requires ongoing maintenance time.

If the time and frustration it saves you is worth far more than a $2–$5 cup of coffee, consider buying me a coffee to support the long-term maintenance of this project!

Sponsor on GitHub

License

This project is licensed under the MIT License.

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages