Snapchat Web Story Downloader

WHAT IT DOES

Snapchat Web Story Downloader adds a download button directly to Snapchat stories on the web player, letting you save any story video or image with a single click. It detects the media source URL from video elements, image elements, or background images, then triggers a download using the browser's download API. The script automatically identifies whether the story is a video or image and handles both types seamlessly. You can customize the filename format with placeholders for timestamp and story title, choose whether to include a timestamp in the filename, and control the button position (inline next to the story or floating bottom-right). The script works on both single story views and story feeds, detecting multiple stories on the same page. Perfect for creators archiving their content, users saving memorable stories, or anyone who wants to keep Snapchat content offline.

WHERE IT RUNS

This script runs exclusively on Snapchat web pages (*.snapchat.com/*). It operates entirely within your browser tab, reading the page's video and image elements to locate story media. The script cannot access other tabs, your browsing history, bookmarks, downloads, or any data outside the current page. All settings—including filename format, timestamp 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 Snapchat stories on the page and injects a "📥 Download" button next to each story (if auto-detect is enabled). Click the button to download the story video or image 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}, {title}), toggle timestamp inclusion on or off, choose button position (inline or floating), and control auto-detect behavior. Click "Inject Download Buttons" to manually add buttons after dynamic page updates. Use "Download Current Story" to download the currently visible story, or "Download All Stories" to save every story on the page at once. The "Copy Media URLs" button lets you export all media URLs for use with external tools.

THE REAL MECHANISM

The script detects Snapchat stories by scanning the page for video elements, image elements with Snapchat-related URLs, and elements with background-image styles containing Snapchat CDN URLs. For each detected media element, it extracts the source URL from src attributes, data-src attributes, or CSS background-image URLs. The script then identifies whether the media is a video or image based on the element type. For video stories, the script also looks for source child elements as a fallback. When a download is triggered, the script generates a filename using the user's format string with placeholders replaced: {timestamp} with an ISO timestamp (if enabled) and {title} with an extracted story title or author name. For blob URLs, the script fetches the blob using GM_xmlhttpRequest and creates an object URL for download. For data URLs and direct URLs, it uses a temporary anchor element with the download attribute. The auto-detect system uses a MutationObserver to watch for dynamically added stories 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 Snapchat Story Downloader 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. Snapchat frequently updates its web interface, which may change how story media is structured—the script may require updates to maintain compatibility. Story downloads are subject to Snapchat's terms of service; only download content you have permission to save. Some stories may use DRM or blob URLs that limit download capability. The script attempts to detect story titles from nearby elements, but this may not always be accurate. The script never reads or writes password fields, hidden inputs, or file inputs. It stores only your filename format, timestamp preference, button position, and auto-detect preference locally. No story data, download history, or personal information is ever collected, transmitted, or shared.