☰

Story Downloader - Facebook and Instagram

Download stories (videos and images) from Facebook and Instagram.

如何安装

您需要先安装一个扩展，例如 篡改猴、Greasemonkey 或 暴力猴，之后才能安装此脚本。

您需要先安装一个扩展，例如 篡改猴 或 暴力猴，之后才能安装此脚本。

您需要先安装一个扩展，例如 篡改猴 或 暴力猴，之后才能安装此脚本。

您需要先安装一个扩展，例如 篡改猴 或 Userscripts ，之后才能安装此脚本。

您需要先安装一款用户脚本管理器扩展，例如 Tampermonkey，才能安装此脚本。

您需要先安装用户脚本管理器扩展后才能安装此脚本。

（我已经安装了用户脚本管理器，让我安装！）

如何安装

您需要先安装一款用户样式管理器扩展，比如 Stylus，才能安装此样式。

您需要先安装一款用户样式管理器扩展，比如 Stylus，才能安装此样式。

您需要先安装一款用户样式管理器扩展，比如 Stylus，才能安装此样式。

您需要先安装一款用户样式管理器扩展后才能安装此样式。

您需要先安装一款用户样式管理器扩展后才能安装此样式。

您需要先安装一款用户样式管理器扩展后才能安装此样式。

（我已经安装了用户样式管理器，让我安装！）

作者
oscar370
日安装量
6
总安装量
1,508
评分
6 1 2
版本
2.0.6
创建于
2024-09-08
更新于
2025-05-20
大小
7.4 KB
许可证
GPL3
适用于

Story Downloader - Facebook & Instagram

A user script to download stories (videos & images) from Facebook and Instagram — supports both production and development modes!

For Users

Install directly from GreasyFork:
https://greasyfork.org/en/scripts/507431-story-downloader-facebook-and-instagram

Features:

  • Works on Facebook and Instagram web
  • Downloads stories in one click
  • Automatically detects videos and images
  • Lightweight and open-source

For Developers

If you want to contribute or run this script in development mode using TypeScript, follow these steps:

Requirements

  • Node.js & npm
  • Tampermonkey (or similar user script manager)
  • A Chromium-based browser (Chrome, Edge, Brave, etc.)
  • A text editor (e.g. VSCode)

Important Tampermonkey Setup

To use file:/// paths in development:

  1. Go to your browser's Extensions page.
  2. Enable Developer Mode.
  3. Open the Tampermonkey extension settings.
  4. Enable the option: "Allow access to file URLs."

This is required for Tampermonkey to load the script directly from your local machine.

Clone the repository

git clone https://github.com/oscar370/Story-Downloader---Facebook-and-Instagram.git
cd Story-Downloader---Facebook-and-Instagram

Install dependencies

npm install

Development Mode

  1. Set your desired output path in a .env file at the project root:
DEV_REQUIRE_PATH=file:///[your-path]/dist/script.dev.user.js

Use forward slashes / even on Windows.

  1. Run the development watcher:
npm run dev
  1. Create a dev userscript in Tampermonkey with the following header:
// ==UserScript==
// @name         Story Downloader - Facebook and Instagram - Dev
// @namespace    https://github.com/oscar370
// @version      0.0.0
// @description  Download stories (videos and images) from Facebook and Instagram.
// @author       oscar370
// @match        *.facebook.com/*
// @match        *.instagram.com/*
// @grant        none
// @license      GPL3
// @require      file:///[your-path]/dist/script.dev.user.js
// ==/UserScript==

Refresh your browser tab to reload changes after each build!

Production Build

To build the optimized userscript for sharing:

npm run build

This generates:

dist/script.prod.user.js

You can upload this file to GitHub and link it on GreasyFork.

Project Structure

.
├── dist/
│   ├── script.dev.user.js
│   └── script.prod.user.js
├── src/
│   └── main.ts
├── .env
├── build-dev-watch.js
├── build-prod.js
├── package.json
├── tsconfig.json
└── README.md

Contributing

Pull requests, issues, and suggestions are welcome! Just make sure to describe the change clearly and follow the coding style.

Happy downloading! 🎉