Country Filter for X

Product Introduction

1. Definition: Country Filter for X is an open-source Manifest V3 Chrome browser extension designed to filter and hide social media posts based on country and regional origins. Categorized under social media enhancement utilities, content filtering tools, and browser extensions, it specifically targets recommended feeds on x.com and X Pro (pro.x.com).
2. Core Value Proposition: The extension exists to give users granular control over their algorithmic Home feeds ("For You" and topic tabs like Software, Tech, and AI) by filtering out posts originating from specific countries or broad geographic regions. By utilizing a multi-layered confidence scoring system, it eliminates unwanted regional noise while maintaining strict privacy standards through local-only processing and zero developer servers.

Main Features

1. X Metadata and Profile Location Detection: The extension queries X's native AboutAccountQuery endpoints using the user's active session to retrieve verified "Account based in" data. As a fallback, it parses authors' public profile locations—mapping free-text fields and international scripts (such as Japanese or Korean) to ISO country codes—and caches results locally for up to 24 hours to ensure high-accuracy content filtering.
2. Multi-Tiered Confidence Scoring Engine: Combining account metadata, known tech-news author lists, keyword boundary matching, and single-country post language detection, the algorithm assigns a composite confidence score. A single keyword or localized term is never enough to hide a post independently, ensuring that uncertain content remains visible and false positives are minimized.
3. Robust Exemption and Override Framework: Users can configure custom exceptions via username whitelisting, maintain visibility for accounts they follow, and automatically protect their own signed-in profile and direct replies or mentions. These four overriding rules take absolute precedence over any active country or regional block.

Problems Solved

1. Pain Point: Algorithmic recommendation feeds on X frequently flood users with localized spam, region-specific discourse, or irrelevant geopolitical content from foreign markets that they have no interest in consuming. This degrades the user experience on the "For You" feed and topic tabs.
2. Target Audience: Power users, technical professionals, researchers, journalists, and everyday X (Twitter) users who consume high volumes of global content but want to curate and filter out noise from specific geographic regions without losing touch with their direct network.
3. Use Cases: Filtering out regional trending topics and viral posts from specific countries during major geopolitical events; curating technical feeds (like AI or Software tabs) to exclude low-quality geographic spam; maintaining a clean, focused reading experience on X Pro dashboards without relying on blunt muting tools.

Unique Advantages

1. Strengths & Limitations (Pros & Cons):
   • Strengths: Completely free, open-source under the MIT license, requires zero developer-controlled servers or external APIs, respects user privacy with no tracking, leverages X's native metadata for high accuracy, and supports both x.com and X Pro.
   • Limitations: Relies on an active logged-in X session to query account metadata (though heuristic fallbacks work when logged out); limited strictly to Chrome-compatible browsers supporting Manifest V3; cannot filter the reverse-chronological "Following" tab by design.
2. Key Alternatives & Differentiation: Unlike traditional keyword-muffling extensions or third-party Twitter clients that require paid API subscriptions or route data through external scraping servers, Country Filter for X operates entirely client-side. It differentiates itself by evaluating native "Account based in" platform metadata rather than relying solely on naive keyword blacklists or imprecise geo-IP estimations.

Frequently Asked Questions (FAQ)

1. Does Country Filter for X track my browsing history or personal data? No. The extension is open source (MIT), contains no tracking scripts, and does not use any developer-controlled servers. All API requests go directly to X's endpoints using your existing browser session, and cached location data is stored entirely locally on your machine.
2. Which feeds and pages on X are affected by the extension? The extension filters posts exclusively within the algorithmic Home feeds ("For You") and topic tabs (such as Tech, Software, and AI) on both x.com and X Pro (pro.x.com). Your chronological "Following" tab, direct notifications, search results, bookmarks, and opened conversation threads remain completely untouched.
3. How does the extension determine the country of a post's author? It uses a multi-layered detection system. The strongest signal is X's own verified "Account based in" metadata fetched via your active session. This is supplemented by public profile locations, known author databases, localized keywords, and single-country language indicators, all processed through a strict confidence-scoring model.
4. Can I prevent specific accounts or people I follow from being filtered out? Yes. The extension includes a robust exemption framework. Your own posts, direct mentions of your username, usernames explicitly added to your exception list in the popup, and posts from accounts you follow will always remain visible, overriding any active country or region filters.