Artificial-Sweetener/facebook-clean-my-feeds

Clean up Facebook feeds by hiding sponsored, suggestions and other posts.

123

stars

335

commits

JavaScript

primary language

Jul 5, 2026

updated

facebook
filter
social-media
userscript

README

mop FB - Clean My Feeds

License: GPL v3 GreasyFork GreasyFork installs Linted with ESLint Tested with Jest Built with esbuild semantic-release

English | Tiếng Việt

You should be in control of what you see online, but Facebook throws all kinds of garbage at you making it practically impossible to see updates from your friends and pages you care about. "FB - Clean My Feeds" is the mop bucket you roll in when you want control back.

Originally built by zbluebugz and battle-tested since 2021.

Thanks to trinhquocviet for helping maintain filters in 2025.

install Installation

  1. Install a userscript manager such as Violentmonkey, Tampermonkey, or FireMonkey.
  2. Add the script (your preference of method):
  3. Reload Facebook. You can set the mop icon to appear in the bottom-left, top-right, or hide it completely.

features Features

"FB - Clean My Feeds" is designed to make your browsing experience calm, clean, and completely under your control.

  • Nuke the Ads: We automatically scrub "Sponsored" posts, "Paid Partnership" labels, and "Suggested for you" sections across News, Groups, Watch, Marketplace, Search, and Reels.
  • Built for Any Locale: The core filters are designed to work across Facebook languages without depending on translation dictionaries, so they keep doing their job even when your Facebook isn't in English.
  • Cut the AI Clutter: Hide "Try Meta AI" cards, Meta AI prompt suggestions, posts labeled with Facebook's "AI info" marker, and AI side-panel distractions before they take over your feed. The "AI info" filter relies on Facebook's label and does not detect every AI-generated post.
  • Tame the Layout: Hide Reels, "Short Videos," and those massive "Stories" shelves that eat up your screen. You can even toggle off entire sections like Marketplace if you never use them.
  • Filter the Noise: Create custom blocklists for specific words or phrases (with regex support!). You can also cap viral posts by "Like" count to keep your feed personal.
  • Quiet Down: We strip out "People You May Know," "Follow" suggestions, survey promos, and other engagement traps. Plus, you can pause autoplaying GIFs and videos so you're not ambushed by motion.
  • Easy Controls: Enjoy a refined, dark-mode friendly settings menu with translated labels. Just click the mop icon, flip a switch, and see the results instantly.

options Using the Control Panel

  • Click the Clean My Feeds mop icon (or open it from your userscript manager menu) to bring up the settings dialog.
  • Options are grouped by feed (News, Groups, Watch, Marketplace, Profiles, Search, Reels). Flip the switches you want, save, and the script immediately re-sweeps the page.
  • Toggle Debug to reveal hidden posts with dotted outlines so you can verify what's being filtered.
  • Use Export / Import to back up your settings. The script stores preferences locally; incognito/private browsing wipes them when the session ends.

Language Support

The control panel ships with many UI languages so the settings, labels, and hidden-post reasons stay clear on localized Facebook installs.

Supported languages
  • English
  • Português (Portugal & Brazil)
  • Deutsch
  • Français
  • Español
  • Čeština
  • Tiếng Việt
  • Italiano
  • Latviešu
  • Polski
  • Nederlands
  • עברית
  • العربية
  • Bahasa Indonesia
  • 中文(简体)
  • 中文(繁體)
  • 日本語
  • Suomi
  • Türkçe
  • Ελληνικά
  • Русский
  • Українська
  • Български

If you spot gaps or mistranslations, open an issue. I'd love to make the UI feel smoother and clearer for non-English users too.

bugs Contributing & Support

  • Issues & Features: Open an issue if something breaks or Facebook changes the markup again. I read them.
  • Pull Requests: Yes please. Keep them focused and describe what you touched.
  • Translations: If you can help keep the UI text sharp across languages, I'm all ears.

license License & Credits

about From the Maintainer

I hope this script helps you reclaim your feed. I promise to be your ally in the fight against stuff you don't wanna see online.

  • My Website & Socials: See my art, poetry, and other dev updates at artificialsweetener.ai.
  • If you like this project, it would mean a lot to me if you gave me a star here on Github!! ⭐

Contributors

zbluebugz

279 commits

Crapy

4 commits

Artificial-Sweetener/facebook-clean-my-feeds

Clean up Facebook feeds by hiding sponsored, suggestions and other posts.

123

stars

335

commits

JavaScript

primary language

Jul 5, 2026

updated

facebook
filter
social-media
userscript

README

mop FB - Clean My Feeds

License: GPL v3 GreasyFork GreasyFork installs Linted with ESLint Tested with Jest Built with esbuild semantic-release

English | Tiếng Việt

You should be in control of what you see online, but Facebook throws all kinds of garbage at you making it practically impossible to see updates from your friends and pages you care about. "FB - Clean My Feeds" is the mop bucket you roll in when you want control back.

Originally built by zbluebugz and battle-tested since 2021.

Thanks to trinhquocviet for helping maintain filters in 2025.

install Installation

  1. Install a userscript manager such as Violentmonkey, Tampermonkey, or FireMonkey.
  2. Add the script (your preference of method):
  3. Reload Facebook. You can set the mop icon to appear in the bottom-left, top-right, or hide it completely.

features Features

"FB - Clean My Feeds" is designed to make your browsing experience calm, clean, and completely under your control.

  • Nuke the Ads: We automatically scrub "Sponsored" posts, "Paid Partnership" labels, and "Suggested for you" sections across News, Groups, Watch, Marketplace, Search, and Reels.
  • Built for Any Locale: The core filters are designed to work across Facebook languages without depending on translation dictionaries, so they keep doing their job even when your Facebook isn't in English.
  • Cut the AI Clutter: Hide "Try Meta AI" cards, Meta AI prompt suggestions, posts labeled with Facebook's "AI info" marker, and AI side-panel distractions before they take over your feed. The "AI info" filter relies on Facebook's label and does not detect every AI-generated post.
  • Tame the Layout: Hide Reels, "Short Videos," and those massive "Stories" shelves that eat up your screen. You can even toggle off entire sections like Marketplace if you never use them.
  • Filter the Noise: Create custom blocklists for specific words or phrases (with regex support!). You can also cap viral posts by "Like" count to keep your feed personal.
  • Quiet Down: We strip out "People You May Know," "Follow" suggestions, survey promos, and other engagement traps. Plus, you can pause autoplaying GIFs and videos so you're not ambushed by motion.
  • Easy Controls: Enjoy a refined, dark-mode friendly settings menu with translated labels. Just click the mop icon, flip a switch, and see the results instantly.

options Using the Control Panel

  • Click the Clean My Feeds mop icon (or open it from your userscript manager menu) to bring up the settings dialog.
  • Options are grouped by feed (News, Groups, Watch, Marketplace, Profiles, Search, Reels). Flip the switches you want, save, and the script immediately re-sweeps the page.
  • Toggle Debug to reveal hidden posts with dotted outlines so you can verify what's being filtered.
  • Use Export / Import to back up your settings. The script stores preferences locally; incognito/private browsing wipes them when the session ends.

Language Support

The control panel ships with many UI languages so the settings, labels, and hidden-post reasons stay clear on localized Facebook installs.

Supported languages
  • English
  • Português (Portugal & Brazil)
  • Deutsch
  • Français
  • Español
  • Čeština
  • Tiếng Việt
  • Italiano
  • Latviešu
  • Polski
  • Nederlands
  • עברית
  • العربية
  • Bahasa Indonesia
  • 中文(简体)
  • 中文(繁體)
  • 日本語
  • Suomi
  • Türkçe
  • Ελληνικά
  • Русский
  • Українська
  • Български

If you spot gaps or mistranslations, open an issue. I'd love to make the UI feel smoother and clearer for non-English users too.

bugs Contributing & Support

  • Issues & Features: Open an issue if something breaks or Facebook changes the markup again. I read them.
  • Pull Requests: Yes please. Keep them focused and describe what you touched.
  • Translations: If you can help keep the UI text sharp across languages, I'm all ears.

license License & Credits

about From the Maintainer

I hope this script helps you reclaim your feed. I promise to be your ally in the fight against stuff you don't wanna see online.

  • My Website & Socials: See my art, poetry, and other dev updates at artificialsweetener.ai.
  • If you like this project, it would mean a lot to me if you gave me a star here on Github!! ⭐

Contributors

zbluebugz

279 commits

Crapy

4 commits

Languages

JavaScript

99.9%