Story Downloader - Facebook & Instagram (Overlay + Toast)

fd2013
2025-10-04T15:42:40Z

One-click downloader for Facebook & Instagram stories (video & image).

📥 Story Downloader – Facebook & Instagram

Authors:

oscar370 – original creator

fd2013 – improvements (overlay button, toast notifications, GM_download integration)

License: GPL-3.0
Version: 2.2.0

🔎 About

This userscript adds a Download button to Facebook and Instagram stories.
You can instantly save both videos (MP4) and images (JPG) with a single click.

✅ Works on:

facebook.com/stories/...

instagram.com/stories/...

✅ Features:

Floating overlay button (bottom-right).

Robust media detection for videos/images.

Cross-origin safe downloads via GM_download.

Fallback to native <a download> and fetch → blob.

Toast notifications for success/error.

Keyboard shortcut: Alt+D to save the current story.

📷 Preview

[ ⬇ Download ]

When clicked, it saves the story file with this format:

username-2025-10-04T15-22-05Z.mp4

🛠 Installation

1. Install a userscript manager:

Tampermonkey (recommended)

Violentmonkey, Greasemonkey (limited support)

2. Install this script

3. Open any Facebook/Instagram story, click the Download button, or press Alt+D.

⚠️ Notes & Limitations

Facebook/Instagram frequently change their DOM structure; this script includes multiple fallbacks, but occasional breakage is possible.

If GM_download is not available, the fallback download method may fail for some CDN endpoints due to CORS restrictions.

The script is for personal use only. Redistribution or commercial use of downloaded media may violate platform ToS.

📜 Changelog

2.2.0 – Overlay button, toast notifications, Alt+D shortcut (improved by fd2013).

2.1.0 – Hardened media detection, filename sanitization, GM_download support.

2.0.6 – Initial GreasyFork release by oscar370.