Documentation Index
Fetch the complete documentation index at: https://mintlify.com/chefnaphtha/xBlockOrigin/llms.txt
Use this file to discover all available pages before exploring further.
Welcome to xBlockOrigin
xBlockOrigin is a powerful browser extension that automatically mutes X.com (Twitter) users from specified countries using X’s native country detection feature. Take control of your timeline with intelligent, automated filtering that works seamlessly across Chrome, Edge, and Firefox.Quick start
Get up and running in minutes with our step-by-step guide
Installation
Install the extension for Chrome, Edge, or Firefox
Key features
Instant post hiding
Posts from blacklisted users are hidden immediately with a 50% opacity overlay and 8px blur effect that adapts to your X.com theme
Automatic country detection
Uses X.com’s AboutAccountQuery API to detect users’ originating countries based on their IP geolocation
Customizable blacklist
Specify which countries to automatically mute with an easy-to-use interface
Whitelist support
Whitelist specific users to never mute them, regardless of their country
Following protection
Optional setting to skip muting users you follow (enabled by default)
Multi-page support
Works on timeline, profiles, search results, post detail pages with replies, and notifications
Persistent cache
Country and following status cached for 24 hours to reduce API calls and improve performance
Mute database
Tracks all automatically muted users with username, country, and timestamp for easy management
CSV export
Export your muted users list to CSV format for backup or analysis
Cross-browser
Supports Chrome/Edge (Manifest V3) and Firefox (Manifest V2)
How it works
When you browse X.com, xBlockOrigin works intelligently in the background:Scan pages
The extension scans pages for user profiles across timeline, search, profiles, post detail pages, and notifications
Fetch user data
Fetches user ID and following status from X.com’s UserByScreenName API in a single optimized call
Check following status
If “mute following” is disabled, skips users you follow to protect your connections
Query country
Queries X.com’s AboutAccountQuery API to get the user’s originating country (cached for 24 hours)
Hide posts instantly
Immediately overlays matching posts with a 50% opacity background and 8px blur, while preserving all post functionality
Mute via API
Automatically mutes the user via X.com’s API if this is the first time encountering them
The overlay approach preserves all post functionality - click handlers remain intact so you can interact with the post after unhiding it if needed.
Privacy first
xBlockOrigin respects your privacy:- All data is stored locally on your device
- No data is sent to external servers
- Only communicates with X.com’s official API
- Uses Chrome’s secure storage APIs for data persistence
Technical foundation
Chrome/Edge
Built with Manifest V3 using modern service workers for optimal performance
Firefox
Built with Manifest V2 using persistent background pages for reliable operation