X-Recommender

Smart tweet scoring tool that dynamically adjusts tweet transparency based on LLM scores

## What is X‑Recommender? Tired of your X/Twitter feed being flooded with low-quality content? Want to focus on valuable tweets while hiding the noise? X-Recommender uses AI to automatically analyze and score every tweet, makes low-quality content transparent or hidden, provides one-click translation from the score menu, and now supports Chrome built-in Gemini as a filtering engine with automatic fallback.. The extension analyzes publicly available, user‑generated content on X and helps you personalize your browsing experience. --- ## Why You Need This Tired of your X feed being flooded with: - 🗣️ Low-value drama and gossip - 📢 Spam and excessive self-promotion - 💰 Crypto scams and clickbait - 🤬 Toxic or unproductive content **X‑Recommender filters out the noise so you can focus on meaningful content.** --- ## Key Features ✔ **AI-Powered Scoring** - Uses large language models (LLM) to analyze every tweet - Scores range from 0-100 based on information value, originality, clarity, and engagement potential - Works with popular LLM provider - New in v2.1.0: optionally prefer Chrome built-in Gemini (Prompt API) for filtering scores ✔ **Inline Translation from Score Menu** - Click the score badge to open a quick action menu near each tweet - Translate both tweet text and quoted tweet text while keeping the original content visible - Default translation targets: English and Simplified Chinese ✔ **Smart Transparency** - Low-quality tweets automatically become transparent - High-quality content remains fully visible - Adjust the threshold to control filtering strictness - Keep per-tweet filter toggle and score detail actions in the score menu ✔ **Fully Customizable** - Create custom scoring prompts tailored to your preferences - Fine-tune minimum score threshold and opacity level - Configurable cache duration (1-30 days) - Translation settings are now in a dedicated tab - Select translation target languages in Settings (multi-select) - Choose translation engine strategy: Ask on first use / Chrome Translator / LLM - In Filter settings, detect whether Chrome built-in Gemini is available and choose whether to prefer it ✔ **Privacy-Focused** - All processing happens locally or through your configured API - No data collected by us - Tweet scores cached locally only - Chrome Translator API support can be checked in Settings before choosing engine strategy - When Gemini preference is enabled, filtering first tries Chrome built-in model; if unavailable/failed, it falls back to your configured external model automatically --- ## How It Works 1. Install the extension 2. Configure your preferred LLM provider (local or cloud) 3. Browse X as usual 4. Tweets are analyzed automatically in the background 5. Low-quality tweets fade out while valuable content remains clear 6. Hover over a tweet to view its AI score and evaluation --- ## Important Notes - This extension analyzes publicly available user-generated content on X. - X and Twitter are trademarks of X Corp. - This extension is not affiliated with, endorsed by, or sponsored by X Corp. ## 1.5 Updates ### New Features - **ID Whitelist**: Add trusted users to a whitelist - their tweets will not be filtered and display as ∞ - **Filter Mode**: Choose between opacity (fade) or hide completely - **No-Text Tweet Scoring**: Option to score tweets with only images/videos - **Feedback Link**: Added feedback and follow link in the footer - **Three-Tab Settings**: Reorganized settings into API, Filter, and Whitelist tabs ### Improvements - Adjusted retweet badge position ## Version 1.5.1 ### Fixes - Fixed hide mode filtering to only use the hide threshold, preventing overlap with opacity behavior - Improved tweet text fallback extraction (`innerText || textContent`) to reduce unstable hide/show flicker ## Version 1.6.0 ### New Features - Added support for multiple models - you can now configure and switch between multiple LLM APIs - Automatically disable thinking mode with model that support thinking ### Fixes - Fixed issue where adding a second model would not display in the list (race condition and storage sync delay) ## Version 1.6.1 ### Improvements - Pre-hide unscored tweets: New tweets stay hidden until scored, then are shown or hidden by score (reduces timeline jumps) - Changed batch size from 5 to 1 to lower timeline jump probability - Changed temperature from 0.1 to 0 for more stable scoring - Added cache check before scoring to avoid duplicate requests - Added viewport detection to prevent large-scale node removal outside viewport causing scroll anchor jumps - Optimized tweet ID extraction logic ## Version 1.6.2 ### Improvements - Thread pass-through optimization: tweets in the same conversation now reuse the first scored result, avoiding repeated scoring for follow-up tweets - Improved conversation detection by prioritizing `conversation_id` grouping (with safe fallback logic), covering mixed-author thread cases like repost + comment chains - Reduced scroll flicker by disabling opacity transition on cached re-apply paths during timeline refresh/scroll - Moved adaptive viewport timeout controls under hide mode only; these options are now shown only when filter mode is set to hide ## Version 1.6.3 ### Fix - Fix issue where preset APIs like Ollama couldn't be added after changing URL to LAN IP (preset values overriding user input) ### Improvements - Preset API name and URL now prioritize user input ## Version 1.6.4 ### Fixes - Improved LM Studio compatibility for Qwen-style models by making the no-thinking fallback path more robust - Prevented score parsing from accidentally reading reasoning step numbers as final scores ### Improvements - Added an LM Studio setup hint recommending non-thinking models first - Added guidance for advanced users to disable thinking via LM Studio Prompt Template settings ## Version 1.7.0 ### New Features - Added "Clear Cache" button to manually clear all cached scores ## Version 2.0.0 ### New Features - Added a score-badge action menu: clicking the top-right score now opens a menu with quick translation targets (English and Simplified Chinese by default) - Added tweet translation for both main tweet text and quoted tweet text, while preserving original content and rendering translation blocks below - Added translation settings in popup: target languages are now multi-select and persisted ### Improvements - Added translation engine strategy options: Ask on first use, Force Chrome, or Force LLM - Added Chrome Translator API detection and status display in settings, with engine options enabled/disabled by availability - Changed single-click score behavior from direct toggle to menu entry, while keeping "Toggle Filter" and preserving double-click score details ### Fixes - Improved repeated translation behavior by reusing existing translation blocks for the same language, preventing duplicate stacking - Added complete i18n keys for translation UI and status/error messaging in both languages ## Version 2.1.0 ### New Features - Added Chrome built-in Gemini (Prompt API) support check in Filter settings - Added a new toggle to prefer Chrome built-in Gemini for tweet filtering scores ### Improvements - Added automatic fallback to the configured external LLM when Chrome Gemini is unavailable or scoring fails - Kept existing filter behavior unchanged when the Gemini toggle is off - Added full i18n text coverage for the new Gemini filter settings and status labels ## Version 2.2.0 ### New Features - Added Chrome built-in Gemini (Prompt API) support check in Filter settings - Added a new toggle to prefer Chrome built-in Gemini for tweet filtering scores - Added reputation-based score badges that accumulate scoring history per account - Added a reputation summary entry in the score menu so you can view scored count, average score, and current badge status for a user - Added a quick profile shortcut from the score menu and reputation modal to open the user's X profile ### Improvements - Added automatic fallback to the configured external LLM when Chrome Gemini is unavailable or scoring fails - Kept existing filter behavior unchanged when the Gemini toggle is off - Added full i18n text coverage for the new Gemini filter settings and status labels - Badge colors now automatically follow a user's accumulated average score after enough history is collected - Whitelisted accounts now use a dedicated reputation state so the shield-style badge and menu messaging stay consistent ### Fixes - Fixed whitelist reputation handling so whitelisted accounts are excluded from reputation statistics and no longer show misleading reputation data - Improved compatibility for old cached score data by rebuilding reputation summaries from stored detail records when needed