react
Featured
react
React is a JavaScript library for building user interfaces with declarative, component-based, and cross-platform design.
declutter-facebook
Feed Filter is a browser extension for Chrome and Firefox that lets you reclaim your Facebook feed by showing only posts from friends you added and groups you joined, with options to dim, hide, or permanently opt out of everything else, all without any dependencies or network requests.
Stars
6
7-day growth
No data
Forks
2
Open issues
0
License
No data
Last updated
2026-07-29
AI repository intelligence
FR-AI / ANALYSISWhy it is worth attention
It inverts the typical blocklist approach by using an allowlist you build yourself, making it resilient to Facebook's constant UI changes, and it prioritizes privacy by keeping all data local and never sending anything off your machine.
Who it is for
- Privacy-conscious Facebook users who want to minimize data exposure
- Users overwhelmed by sponsored, suggested, or unwanted content in their feed
- People who want a simple, no-build-step tool to curate their social media experience
- Developers interested in a well-tested, dependency-free browser extension architecture
Use cases
- Filter out all sponsored and suggested posts from your Facebook feed
- Automatically hide posts from pages or strangers you never followed
- Build and maintain an index of your friends and joined groups to see only their content
- Audit your feed composition using the debug overlay to verify classification accuracy
Strengths
- No dependencies, no build step, and no third-party code—everything is plain JavaScript loaded directly
- Allowlist design based on your own friends and groups, which is unaffected by Facebook's rotating class names or new content categories
- Full privacy: no network requests, all data stored in chrome.storage.local, and no telemetry
- Extensive test suite (106 tests) covering classification priority, selectors, filters, and safeguards
Considerations
- Does not track pages you follow—only friends and groups—so some pages you follow may not be recognized as chosen content
- Label detection for 'Sponsored' and 'Suggested' supports many languages but not all, and Facebook actively obfuscates the sponsored label
- Deduplication is limited to the last 5,000 posts per tab, so very long sessions could double-count a few posts
README quick start
Feed Filter
A browser extension for Chrome and Firefox that gives you back the Facebook feed you actually chose: posts from friends you added and groups you joined. Everything else can be counted, greyed out, hidden, or permanently opted out of — your choice, one setting at a time.
No dependencies, no build step, nothing leaves your machine.
Where this is at
It started as a measurement-only tool, because the design rested on an assumption worth testing: that there was enough friend and group content in the home feed to be worth filtering for.
There is not. Measured over a real feed, roughly one post in six came from a friend or a joined group — and that was before ads were being counted at all, so the true share is lower. Four in five posts were things the user never asked for.
That answered the design question and settled the direction: dimming most of a feed is pointless, so the extension now hides, and can tell Facebook to stop sending a source altogether. The measurement side is still there and still running — it is how you tell whether the classifier is working.
Install
Runs on both Chrome and Firefox from the same folder — no build step, no separate branch.
Chrome
- Open
chrome://extensions - Turn on Developer mode (top right)
- Load unpacked → select this folder
Chrome will not let an extension pin its own icon. To keep it visible, click the puzzle-piece button in the toolbar and pin Feed Filter.
Firefox
- Open
about:debugging#/runtime/this-firefox - Load Temporary Add-on… → select
manifest.jsonin this folder - Click the extension's toolbar button and choose Always Allow on facebook.com
That third step is not optional and has no Chrome equivalent. Firefox treats Manifest V3 host permissions as opt-in: the extension is installed but can see nothing until you grant it the site, and until you do it will simply report "No reply from this tab" on every Facebook page.
Temporary add-ons are removed when Firefox restarts. To keep it installed you
either need it signed through addons.mozilla.org, or a Firefox ESR / Developer
Edition build with xpinstall.signatures.required set to false, into which
you can drop a zipped .xpi.
Packaged build
dist/feed-filter-.zip is the extension itself, zipped — the source,
icons and tests, without docs/, which is reposito
Description
Plugin that automatically grays out and/or auto opts out of stuff from your facebook feed that you don't follow.
Related repositories
Similar projects matched by category, topics, and programming language.
tandpfun
Featured
wardrobe
A GPT‑image powered app that extracts individual garment cutouts from photos, organizes them into a digital wardrobe, and generates modeled outfit previews.
mshumer
Featured
Claude-of-Duty
A browser-based first-person shooter built entirely with procedural generation and orchestrated AI agents, featuring 55k lines of Three.js/WebGL2 code and no art assets.