Skip to content

Browser extension that blocks algorithmic 'home' feeds, while preserving unique pages/links, DMs, search, and subscriptions

License

Notifications You must be signed in to change notification settings

altock/IntentionalBrowsing

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

28 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Intentional Browsing

Block the feed. Keep the signal. Visit on purpose.

A browser extension that blocks algorithmic feeds while preserving the features you actually use—DMs, search, subscriptions, and direct links.

What it does

Platform Blocked Allowed
X/Twitter Home feed, For You Messages, notifications, profiles, individual tweets
Reddit Home, Popular, r/all Subreddits, comments, search, user profiles
YouTube Home, Shorts, Trending Subscriptions, watch pages, search, channels
Instagram Feed, Explore, Reels DMs, profiles, individual posts
Facebook Feed, Watch, Reels Messages, groups, events, marketplace
LinkedIn Feed Messages, jobs, profiles
TikTok Everything

Install

Or load unpacked from dist/chrome or dist/firefox after building.

Build

npm install
npm run build        # Build both Chrome and Firefox
npm run build:watch  # Watch mode

Output:

  • dist/chrome/ — Manifest V3 (Chrome, Edge)
  • dist/firefox/ — Manifest V2 (Firefox)

Test

npm test             # Unit tests (Vitest)
npm run test:e2e     # E2E tests (Playwright)

How it works

Hard blocks: Navigation-level blocking via declarativeNetRequest (Chrome) or webNavigation (Firefox). Redirects to a blocked page or safe destination (e.g., YouTube → Subscriptions).

Soft blocks: DOM hiding via content scripts with MutationObserver for dynamic content.

SPA detection: Content scripts patch history.pushState/replaceState to catch in-app route changes.

Privacy

No data collection. No analytics. Everything stays local. See Privacy Policy.

License

MIT

About

Browser extension that blocks algorithmic 'home' feeds, while preserving unique pages/links, DMs, search, and subscriptions

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages