Universal Subtitle Downloader

WHAT IT DOES Universal Subtitle Downloader detects and extracts subtitle tracks from any webpage with embedded video content. The extension scans for `` elements with `kind="subtitles"` or `kind="captions"`, pulls the subtitle URL from the `src` attribute, and displays it alongside language labels and format information (VTT, SRT, TTML, DFXP, ASS). Each detected subtitle can be copied to your clipboard or opened directly in a new tab for viewing or downloading. The extension goes beyond standard track elements—it also searches data attributes, script tags, and player configuration objects for subtitle URLs and subtitle data payloads, making it effective on a wide range of video platforms. A language filter lets you focus on subtitles in your preferred language, and auto-open mode can instantly open the first detected subtitle when you scan. WHERE IT RUNS The extension works on every website with HTML5 video elements, including streaming platforms, online learning portals, video hosting services, news websites, and any other page with video content that includes subtitle tracks. It runs locally in your browser, scanning the page's DOM and extracting subtitle URLs without sending any data to external servers. The extension supports all major browsers and adapts to both desktop and mobile viewports seamlessly. HOW TO USE After installation, click the extension toolbar icon to open the Subtitle Downloader panel. Click "Scan for Subtitles" to scan the current page for subtitle tracks. The extension will display all detected subtitle tracks in a list, each showing its language, label, format, and source. To copy a subtitle URL to your clipboard, click the "Copy" button next to any track. To open the subtitle file directly in a new tab, click the "Download" button. Set a preferred language (e.g., "en", "fr", "es") in the settings to filter tracks—the extension will only show subtitles matching that language. Enable "Auto-open first subtitle on scan" to automatically open the first detected subtitle URL when you scan. For per-site settings, enable or disable the extension on specific websites. THE ACTUAL MECHANISM — MULTI-STRATEGY SUBTITLE DETECTION WITH DOM AND SCRIPT ANALYSIS The extension uses a comprehensive four-strategy detection pipeline. First, it queries all `` elements with `kind="subtitles"` or `kind="captions"` and extracts the `src` attribute, resolving relative URLs using `new URL(src, window.location.href)`. It also captures `srclang`, `lang`, and `label` attributes for display. Second, it searches for elements with subtitle-related data attributes (`data-subtitle`, `data-subtitles`, `data-caption`, `data-track`) and parses comma-separated URL lists. Third, it scans all `` tags for subtitle URLs using a regex pattern that matches `https?://[^\s"']+\.(vtt|srt|ttml|xml|dfxp|ass|ssa)` to find raw subtitle URLs embedded in JavaScript. Fourth, it searches script content for player configuration patterns using a more sophisticated regex that looks for `subtitle`, `track`, or `caption` combined with `url` patterns, extracting subtitle URLs from JSON-like configuration objects. All detected URLs are normalized, deduplicated using a `seen` object keyed by the resolved URL, and displayed with their format derived from the file extension. Language filtering is applied client-side by checking `srclang` and `lang` attributes against the user's preferred language string. THE PANEL The settings panel is a lightweight, draggable overlay that appears in the center of your screen. You can reposition it by clicking and dragging the title bar; release it near the screen edge and it will snap into place automatically. To collapse the panel into a compact title bar, click the minimize button, expanding it again with the same control. The panel is fully responsive, adapting to different screen resolutions with a minimum width of 300px and a maximum of 480px. Press the Escape key at any time to dismiss the panel without applying changes. All controls—the enable/disable toggle, scan button, auto-open toggle, language filter input, per-site settings, and the subtitle list itself—are accessible within a clean, high-contrast interface that respects your system's color scheme. PLEASE NOTE This extension requires the free BotGentz companion extension to be installed and active, which provides the underlying DOM access, clipboard, and tab opening functionality. The extension scans the visible DOM and may not detect subtitle URLs that are loaded dynamically via complex JavaScript after page load; clicking "Scan for Subtitles" will re-scan the current state. Some websites use encrypted or token-protected subtitle URLs that may not be directly accessible—in these cases, the URL may open but the file may not be downloadable. No personal data, browsing history, or video content is ever collected, stored, or transmitted. All settings are saved using the browser's storage API and remain solely on your device. The extension does not inject ads, trackers, or analytics of any kind.