FB Mobile - Clean my feeds (Browser Extension)

Table of contents

• FB Mobile - Clean my feeds (Browser Extension)
  • Features
  • How to use
    • Install it as a web app (Recommended)
    • Browser/Extension Alternatives
  • Changelog
  • Known issues
• How to build
  • Prerequisites
  • Install dependencies
  • Start development server
  • Create a production build
  • Create a production zip
• Desclaimer
• License

Hides unwanted posts from Facebook feed on mobile. Get a clean Newsfeed with posts only from friends, pages and groups you follow.

This extension is a continuation and improvement of the FB Mobile – Clean my feeds userscript on GreasyFork, but without the bloat, installation hassle, or compatibility issues of userscript managers. It does the same job, with added benefits on top.

An added benefit of converting it into an extension is that the website can now be installed as a standalone PWA app, giving you a smoother, app-like experience.

Features

• 🚫 Sponsored posts – remove annoying ads
• 📌 Suggested posts – hide algorithm-recommended content
• 🎥 Reels – block distracting short videos
• 👥 People You May Know – remove friend suggestions
• 📄 Suggested pages (join/follow) – hide irrelevant recommendations
• ⚙️ Customizable filters – choose what to hide from the Settings page (gear icon in the top right)
• 📲 Installable app (Extension exclusive) – install the website as an app by adding it to the home screen

How to use

1. Install a browser that supports Extensions, such as Quetta Browser on Android or IOS, Mises or Lemur. Kiwi Browser is not recommended as it's abandoned and out of date.
2. Launch your preferred browser then head to Chrome Web Store and search for "FB Mobile - Clean my feeds". Alternatively, you can follow this link: https://chromewebstore.google.com/detail/fb-mobile-clean-my-feeds/oipbhmdodiafhpfglkeomlldnbahdlfd
3. (Optional) Install uBlock Origin extension.
   • Not required for this extension but will improve your overall browsing experience by a mile.installation: GreasyFork
4. Browse https://m.facebook.com/ without all the trash.

Install it as a web app (Recommended)

1. Open https://m.facebook.com/
2. Tap on your browser's 3 dot menu
3. Tap on Add to Homescreen

Browser/Extension Alternatives

Please refer to this link to find other alternatives if my suggested combination doesn't work for you: https://github.com/KudoAI/googlegpt#-compatibility

Changelog

• v1.03
  • Converted to browser extension
  • PWA implementation
  • Settings overlay can now be closed by tapping on empty area
  • Improved Style injection logic
  • Disabled running on "Videos/Watch" page as it has been overhauled.
  • Fixed Post comment box height issue as a bonus.
• You can refer to the past logs from here: FB Mobile - Clean my feeds (Userscript)

Known issues

Facebook has an enhanced Mobile version of facebook which only works on Chromium browsers. The browsing experience is not as good as the App you are used to. It shows low quality photos and videos. But this is all we got that we can inject a script into.

ℹ️ So keep the original App installed and use it only for leisure browsing.

Other issues

• Jitters on prolonged scrolling
  • Facebook keeps removing seen posts at a random and adjusts filler height accordingly. I still haven't found a good way to tackle this. Pull requests are welcome.
• Api rate limit ⚠️Please scroll slowly
  • After a while they keep pushing hundreds of Suggested posts in a row. As you keep scrolling faster than usual, it is possible to hit Api rate limit. Or in general term: they put a timer between each post requests and you asked for posts before the timer ended

⭐ If you like this project a Star would be nice.

⭐ You can request for new filters or submit issues here: Github/issues

⭐ Want to contribute? Refer to the Contribution page.

⭐ Buy me a coffee

• 

How to build

Prerequisites

• Node.js 22+ or Bun 1.2+

Install dependencies

bun install

Start development server

• Chrome

bun dev

• Firefox

bun dev:firefox

This will:

1. Start the development server
2. Watch for file changes and automatically reload the extension
3. Open your browser with the extension loaded in development mode

• If you don't want this automatic behavior, create this file at the root directory

# web-ext.config.ts
import { defineWebExtConfig } from "wxt"
export default defineWebExtConfig({
  disabled: true,
})

Create a production build

Chrome

bun run build

Firefox

bun run build:firefox

Create a production zip

Chrome

bun run zip

Firefox

bun run zip:firefox

This will create a production-ready build in the .output/ directory.

Desclaimer

• This project is not affiliated with, sponsored by, or endorsed by Facebook, Meta, or any related entity. It is an independent tool created solely to improve user experience.

• Facebook™ is a trademark of Meta Platforms, Inc. This extension is an independent project and uses the Facebook site only to provide filtering functionality.

License

MIT