TikTok Web Download Button

WHAT IT DOES

TikTok Web Download Button adds a download button directly to the TikTok web player, letting you save any video with a single click. It detects the video source URL from the page's video element or player data, then triggers a download using the browser's download API—no third-party services or watermark removal tools required. The script works on both single video pages and the TikTok feed view, detecting multiple videos on the same page. You can customize the filename format with placeholders like {timestamp}, {id}, and {title}. Choose to include or exclude audio, and control the download quality. A "Download All Videos" button lets you save every video on the page in sequence. Perfect for content creators archiving their work, researchers collecting examples, or anyone who wants to save TikTok videos for offline viewing.

WHERE IT RUNS

This script runs exclusively on TikTok web pages (*.tiktok.com/*). It operates entirely within your browser tab, reading the page's video elements and player data. The script cannot access other tabs, your browsing history, bookmarks, downloads, or any data outside the current page. All settings—including filename format, audio inclusion, button position, and auto-detect preference—are stored locally using GM_setValue and never transmitted anywhere.

HOW TO USE

After installing with the BotGentz extension, the script automatically detects TikTok videos on the page and injects a "📥 Download" button next to each one (if auto-detect is enabled). Click the button to download the video with your current settings. The download starts automatically with a filename based on your chosen format. Use the panel to customize your experience: set a custom filename format using placeholders ({timestamp}, {id}, {title}), toggle audio inclusion on or off, choose button position (inline next to the video or floating bottom-right), and control download quality. Click "Inject Download Buttons" to manually add buttons after dynamic page updates. Use "Download All Videos" to save every video on the page at once. The "Copy Video URLs" button lets you export all video source URLs for use with external download tools.

THE REAL MECHANISM

The script detects TikTok videos by querying the page for video elements, extracting their source URLs from the src attribute or data-src/data-video attributes. For each detected video, it identifies a unique ID from the URL or page context, and attempts to extract a title from parent elements. The download is triggered by creating a temporary anchor element with the download attribute set to the desired filename. For blob URLs (which TikTok sometimes uses), the script fetches the blob using GM_xmlhttpRequest, downloads it as a Blob, and creates an object URL for download. The filename is generated using the user's format string with placeholders replaced: {timestamp} with an ISO timestamp, {id} with the video ID, and {title} with the extracted title. The auto-detect system uses a MutationObserver to watch for dynamically added videos in the feed, re-injecting buttons as new content loads. All DOM manipulation uses safe methods with no innerHTML from untrusted content.

THE PANEL

The TikTok Download panel is a BGPanel component that you can drag anywhere on your screen by its header. It snaps to the nearest edge when released, keeping your workspace organized. The panel collapses to a small bubble showing only the emoji icon when minimised—click to expand it again. You can resize the panel horizontally to see more of the settings. Press the Escape key to collapse the panel instantly. Your panel position and size are saved per-site.

PLEASE NOTE

This script requires the free BotGentz browser extension to function. TikTok frequently updates its page layout, which may change how video elements are structured—the script may require updates to maintain compatibility. Video downloads are subject to TikTok's terms of service; only download content you have permission to save. The script downloads videos at the quality available from the player source; quality may vary. Some videos may use DRM or blob URLs that limit download capability. The script never reads or writes password fields, hidden inputs, or file inputs. It stores only your filename format, audio preference, button position, and auto-detect preference locally. No video data, download history, or personal information is ever collected, transmitted, or shared.