X Video Download Button

WHAT IT DOES

X Video Download Button is a browser extension that automatically scans the current X (Twitter) page for video players, video elements, and tweet media containers. It detects video elements by examining class names, IDs, and data attributes for patterns like "video", "[data-testid='videoPlayer']", "[data-testid='videoComponent']", and video container selectors. The extension adds a floating download button (⬇️) on each detected video element, providing quick access to video downloading. Clicking the button extracts the video URL and downloads it with a descriptive filename (x_video_[tweet_id]_[date].mp4). The extension also provides a main panel where you can view download history, manage preferences, and add notes about video content. The panel displays all downloaded videos with tweet IDs, filenames, and timestamps, and allows re-downloading from the history. The extension maintains a video download database with download history, notes, and tags. All data is stored locally in your browser using GM_setValue, ensuring your download history persists across page reloads and browser sessions. This helps X (Twitter) users who want to save videos from posts for offline viewing, reference, or content collection.

WHERE IT RUNS

This extension runs on any X (Twitter) page that displays video players, video elements, or tweet media containers – including X (Twitter) tweet pages, video posts, and any page with video 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 video elements using a flexible pattern matching system. This makes it ideal for X users who want to download videos from posts.

HOW TO USE

Simply install the extension and navigate to any X (Twitter) page with a video. The extension automatically detects video elements and shows a download button (⬇️) on each video. Click the button to download the video – the file is saved with a descriptive name based on the tweet ID and date. A floating button (🎬) appears in the bottom-right corner of the page – click this to open the main panel. The panel shows all your downloaded videos with tweet IDs, filenames, and timestamps. You can re-download any video from the history by clicking the "Re-download" button. Use the settings section to set your default quality preference and enable or disable auto-detection. Use the notes section to add notes about video content or collections. The "Clear All Data" button removes all tracking data when needed.

ONE TECHNICAL SECTION – WHY IT WORKS

The extension uses DOM traversal and video source extraction to enable video downloading. The detection system uses a comprehensive set of CSS selectors targeting video elements including "video" tags, "[data-testid='videoPlayer']", "[data-testid='videoComponent']", and related patterns. For each video element, the extension extracts the video source URL from source tags, src attributes, data-src attributes, or parent data attributes. The tweet ID is extracted from the page URL or data attributes. When the download button is clicked, the extension uses GM_xmlhttpRequest with blob response type to fetch the video, then creates a downloadable object URL. The extension includes a fallback that opens the video in a new tab if the download request fails. Download history is stored with the tweet ID, video URL, filename, and timestamp. A MutationObserver detects dynamic content updates and re-scans only when new video elements appear, balancing real-time accuracy with system performance.

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

The video download panel includes a draggable title bar, allowing you to position it anywhere on screen for convenient access during 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 download history and settings 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 video detection to break temporarily – we actively maintain the matching patterns and release updates regularly. The extension stores all video download data, notes, and history exclusively in your local browser storage (GM_setValue); no data is ever transmitted to any external server or third party. Downloaded videos are saved through the browser's download mechanism and are subject to your browser's download settings. The extension does not read, modify, or interfere with any X (Twitter) content or functionality beyond the video display – it operates on the page content and stores only metadata (tweet IDs, video URLs, filenames, timestamps, and notes) that you explicitly create. You are responsible for backing up your download history data if you switch browsers or clear your storage. Use this tool responsibly and in accordance with X's Terms of Service and the rights of content creators.