Twatter Feed Doctor

Cleans up the Twatter feeds. View this script to see detailed screenshots.

作者
deeeeeerp
日安装量
0
总安装量
1
评分
0 0 0
版本
2025-07-03
创建于
2025-05-20
更新于
2025-07-03
大小
135.9 KB
许可证
暂无
适用于

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.

How It Works

The script monkey wraps the XHR object to intercept X's API responses in order to modify the raw JSON data before it's passed to the native client framework. This method provides access to a vast treasure trove of content and user data, far more than what's available in the HTML content templates alone. The steps are as follows:

  • Content data from API response is intercepted, modified per user configuration settings, and added to a global dictionary for later retrieval
  • An HTML observer monitors for new content templates, from which the content ID is acquired
  • The content ID is then used to look up the raw content data from the global dictionary
  • Content data is then used to modify the template according to user config specifications

Features

Below is the documentation for most features. This documentation is still a WIP. I recommend just installing this script for now and not tweaking any of the settings until I address some minor usability issues.

Note: This script has semi-support for auto-muting accounts that meet a certain score threshold. It currently only works if you have Twitter One Click Mute / Block installed:

https://chromewebstore.google.com/detail/gccnajdgjdianjclpcbpibilgkppeoko?utm_source=item-share-cb

It adds a one-click mute button that is clicked by this userscript, though I am working on incorporating my own one-click mute function so that this extension is no longer required. For now, I recommend keeping auto-muting disabled even if you have the one-click extension installed.

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

In some feeds -- especially user profiles and community feeds -- Twatter will still show you content from accounts you've muted and/or blocked. This feature proactively removes such content from all feeds.

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 Posts with Unavailable Quotes

When users quote content that X declines to display (original content was deleted, author blocked quoter, etc), the quote will show as "This post is unavailable". Use this feature to remove such posts from your feed entirely.

Hide Self-Promotional Content

Filters out repetitive or self-promotional posts, including:

  • Reposts
  • Self-reposts
  • Reposts of self-quotes
  • Self-quotes

Configurable UI

A robust configuration panel that allows you to enable/disable features at a granular level can be accessed by clicking the settings button on the bottom of the left nav bar shown below. For now, I've set up basic defaults which only detects lib content without removing it from feeds. I recommend not editing the config for now as I am still working on some usability issues.

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.

QingJ © 2025

镜像随时可能失效,请加Q群300939539或关注我们的公众号极客氢云获取最新地址