Twatter Feed Doctor: A Customizable Content Filtering Script for X
Twatter Feed Doctor is a Tampermonkey userscript designed to enhance your experience on X by providing fine-grained control over the content displayed in your feeds.
Liberal Content Detection
Displays a notification at the top of content templates when a user's display name, bio, or location contains specific indicators often associated with liberal ideologies. These indicators include:
- Emojis (🏳️⚧️, 🏳️🌈, 🍉)
- Hashtags (#FreePalestine, #BlackLivesMatter, #IStandWithUkraine)
- Buzzwords or phrases (e.g., preferred pronoun patterns, vote blue)
Hide Non-English Content
This feature filters out posts in foreign languages (e.g., Chinese, Japanese, Spanish) from trends and search feeds. Due to a known issue on X where content is sometimes mislabeled with incorrect language codes (e.g., English content flagged as German), the script uses simple language detection to verify the content's actual language before hiding it. This ensures legitimate English content is preserved, even if mislabeled. Non-English content from accounts set to English will still appear. Future updates will support non-English users by allowing them to filter out English content.
Hide Subscriber-Only Content
Removes subscriber-only posts from accounts you follow across all feeds.
Hide Business Account Content
Filters out posts from verified business accounts (marked with a yellow check).
Hide Crypto/Stock-Related Content
Eliminates posts containing stock or cryptocurrency symbols (e.g., $BTC) to reduce spam.
Hide Search Feed Content Matching Author Usernames
Keyword of searches and trends also include irrelevant search results where the search query matches the author's username or display name even if the post text itself does not contain the text. This features improves the relevance of trends and searches by removing these items. In this example where "Kiefer" was trending, a good portion of the feed results were accounts with "kiefer" in the authors' name fields.
Hide Content from Muted or Blocking Users
Ensures posts from accounts you've muted or that have blocked you are removed from all feeds, addressing a recent X behavior where such content may still appear.
Hide Repeated Posts (SeenPosts)
X is notorious for repeatedly showing you posts that you've already seen multiple times for up to two whole days. This feature tracks posts you've viewed using your browser's local storage and hides them after a set number of appearances in your For You or trends feeds. Local storage is automatically cleaned once daily to optimize performance.
Hide Self-Promotional Content
Filters out repetitive or self-promotional posts, including:
- Reposts
- Self-reposts
- Reposts of self-quotes
- Self-quotes
Future Development
Twatter Feed Doctor is actively being improved to provide a more user-friendly and customizable experience. Key upcoming features include:
- A settings UI to enable and configure all features
- Enhanced language filtering for non-English users
- Bug fixes for language detection inaccuracies
- Refined filtering algorithms to minimize false positives
I encourage users to provide feedback to help shape the script's development.
Notes
- Twatter Feed Doctor is designed to work with Tampermonkey and requires a compatible browser (e.g., Chrome, Firefox).
- For optimal performance, ensure your browser's local storage is not disabled, as it is used for tracking seen posts.
- If full-feature mode is enabled, non-Premium users may experience frequent rate limitings due to the large quantity of content that can be removed in a short span of time. This results in rapid page loading from X's API which can place your account in a cool-down period of roughly 10 minutes.
Thank you for using Twatter Feed Doctor! Stay tuned for updates as I continue to enhance the script.
