X Chronological Feed Forcer

WHAT IT DOES

X Chronological Feed Forcer is a browser extension that automatically scans the current X (Twitter) page for feed elements, timeline controls, and sort/order indicators. It detects feed controls by examining class names, IDs, and data attributes for patterns like "[role='tablist']", "[data-testid='AppTabBar_Home_Link']", and timeline navigation elements. The extension adds a floating force button (⏳) next to the timeline, providing quick access to chronological feed controls with a status indicator. Clicking the button opens a panel where you can force chronological feed, toggle to algorithm feed, set default feed preference, and store preferences locally. The panel displays the current feed mode, user timeline, and provides actions to force chronological or switch to algorithm feed. You can set auto-switch on timeline load and choose your default feed mode. The extension maintains a feed preference database with settings history, notes, and tags. The main panel shows feed history with timestamps, modes, and actions. All data is stored locally in your browser using GM_setValue, ensuring your preferences persist across page reloads and browser sessions. This helps X (Twitter) users who want to view feeds in chronological order instead of the algorithm-driven "For You" feed, providing more control over their timeline experience.

WHERE IT RUNS

This extension runs on any X (Twitter) page that displays feed elements, timeline controls, or sort/order indicators – including X home page, following feed, and any page with timeline content. The extension intelligently adapts to different page structures and supports a wide range of common X display patterns. No manual configuration is required per site; the extension automatically detects feed controls using a flexible pattern matching system. This makes it ideal for X users who want to force chronological feed order.

HOW TO USE

Simply install the extension and navigate to any X (Twitter) timeline page. The extension automatically detects feed controls and shows a force button (⏳) next to the timeline with a status indicator showing the current feed mode. Click the button to open the feed control panel. The panel shows the current feed mode and user timeline. Click "Force Chronological Feed" to switch to the Following/chronological feed immediately. Click "Switch to Algorithm Feed" to go back to the For You feed. Toggle "Auto-switch on timeline load" to automatically switch to your preferred feed when the page loads. Select your default feed mode from the dropdown (Chronological or Algorithm). A floating button (🐦) appears in the bottom-right corner of the page – click this to open the panel from anywhere. Use the notes section to add notes about feed preferences or timeline content. The panel also shows your feed history with timestamps and actions. Use the "Clear All Data" button to remove all tracking data when needed.

ONE TECHNICAL SECTION – WHY IT WORKS

The extension uses DOM detection and event simulation to control X's feed mode. The feed selector is detected using a comprehensive set of CSS selectors targeting X's timeline controls including role="tablist", aria-label attributes, and data-testid attributes. The feed mode buttons ("For you" and "Following") are identified by text content and aria-selected state. The current feed mode is determined by checking aria-selected="true" on tab elements or active class states. When forcing chronological feed, the extension programmatically clicks the "Following" tab using the native click() method. The extension also detects the user timeline from profile elements. Feed preferences are stored with timestamps and actions. The auto-switch feature uses a delay to ensure the timeline is fully loaded before applying the feed preference. A MutationObserver detects dynamic content updates and re-scans only when new feed controls appear, balancing real-time accuracy with system performance.

THE PANEL – DRAG / PER-SITE POSITION / SNAP / COLLAPSE / RESIZE / ESCAPE

The feed control panel includes a draggable title bar, allowing you to position it anywhere on screen for convenient access during timeline browsing. The extension remembers your preferred position per website, so the panel opens in the same location each time you return to that domain. The panel supports snap-to-edge behavior – when dragged near screen edges, it gently snaps into place for a tidy workspace layout. You can collapse the panel down to just its title bar by clicking the collapse button, keeping it accessible without taking up screen space. The feed controls and history are contained within a scrollable body, ensuring all content remains accessible even on smaller screens. Pressing the Escape key closes the panel instantly, returning you to your timeline browsing workflow.

PLEASE NOTE

This extension requires the free BotGentz extension to be installed and enabled, as it relies on BotGentz's userscript injection and GM_* API shims for cross-browser compatibility. Websites frequently update their HTML structures and class names, which may cause feed detection to break temporarily – we actively maintain the matching patterns and release updates regularly. The extension stores all feed preferences, history, notes, and tags exclusively in your local browser storage (GM_setValue); no data is ever transmitted to any external server or third party. The extension does not read, modify, or interfere with any X (Twitter) content or functionality beyond the feed controls – it operates on the page content and stores only metadata (feed modes, timestamps, user info, and notes) that you explicitly create. You are responsible for backing up your preference data if you switch browsers or clear your storage. Use this tool responsibly and in accordance with X's Terms of Service.