X Thread Unroller

WHAT IT DOES

X Thread Unroller is a browser extension that automatically scans the current X (Twitter) page for threads, reply chains, and tweet threads. It detects thread tweets by examining class names, IDs, and data attributes for patterns like "[data-testid='tweet']", "article[role='article']", and tweet container selectors. The extension adds a floating unroll button (🧵) next to the thread, providing quick access to thread unrolling controls with a tweet count indicator. Clicking the button opens a panel where you can unroll threads, view thread as continuous text, copy thread content, download as text file, and store thread history locally. The panel displays the number of tweets found in the thread, the unrolled content with author names and timestamps, and a preview of the first few tweets. You can copy the unrolled thread to your clipboard or download it as a text file. The extension maintains a thread unroll database with unroll history, notes, and tags. The main panel shows thread history with timestamps and tweet counts. All data is stored locally in your browser using GM_setValue, ensuring your thread history persists across page reloads and browser sessions. This helps X (Twitter) users who want to read threads as continuous text, save threads for reference, or share thread content in a readable format.

WHERE IT RUNS

This extension runs on any X (Twitter) page that displays threads, reply chains, or tweet threads – including X (Twitter) tweet pages, thread view pages, and any page with multiple tweets in a conversation. 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 thread elements using a flexible pattern matching system. This makes it ideal for X users who want to unroll and save threads.

HOW TO USE

Simply install the extension and navigate to any X (Twitter) thread page. The extension automatically detects thread tweets and shows an unroll button (🧵) next to the thread with a tweet count indicator. Click the button to open the thread unroller panel. The panel shows the number of tweets found in the thread and the unrolled content with author names and timestamps. Click "Copy Unrolled Thread" to copy the entire thread as continuous text to your clipboard. Click "Download as Text" to save the thread as a .txt file. 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 thread content or topics. The panel also shows your thread history with timestamps and tweet counts. Use the "Clear All Data" button to remove all tracking data when needed.

ONE TECHNICAL SECTION – WHY IT WORKS

The extension uses DOM traversal and text extraction to unroll threads. The detection system uses a comprehensive set of CSS selectors targeting tweet containers including "[data-testid='tweet']", "article[role='article']", and tweet-specific class patterns. For each tweet, the extension extracts the text content, author information (from User-Name elements), and timestamp (from time elements). The author is extracted using regex to find @username patterns or by taking the text content of user name elements. The thread is unrolled by concatenating each tweet's content with the author name and timestamp in a structured format. The unrolled content is displayed in a monospace font for readability, with each tweet separated by a blank line. The tweet count is displayed on the indicator button. Thread history is stored with the unrolled content, timestamp, and tweet count. A MutationObserver detects dynamic content updates and re-scans only when new tweets appear, balancing real-time accuracy with system performance.

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

The thread unroller panel includes a draggable title bar, allowing you to position it anywhere on screen for convenient access during thread reading. 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 unrolled content 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 X (Twitter) 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 thread detection to break temporarily – we actively maintain the matching patterns and release updates regularly. The extension stores all thread data, unrolled content, notes, and history exclusively in your local browser storage (GM_setValue); no data is ever transmitted to any external server or third party. The unrolled content is stored locally and may include substantial text – we recommend periodically clearing old threads. The extension does not read, modify, or interfere with any X (Twitter) content or functionality beyond the thread display – it operates on the page content and stores only metadata (tweet texts, author names, timestamps, and notes) that you explicitly create. You are responsible for backing up your thread data if you switch browsers or clear your storage. Use this tool responsibly and in accordance with X's Terms of Service.