Story Downloader - Facebook and Instagram

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

スクリプトをインストールするには、Tampermonkey, GreasemonkeyViolentmonkey のような拡張機能のインストールが必要です。

You will need to install an extension such as Tampermonkey to install this script.

スクリプトをインストールするには、TampermonkeyViolentmonkey のような拡張機能のインストールが必要です。

スクリプトをインストールするには、TampermonkeyUserscripts のような拡張機能のインストールが必要です。

このスクリプトをインストールするには、Tampermonkeyなどの拡張機能をインストールする必要があります。

このスクリプトをインストールするには、ユーザースクリプト管理ツールの拡張機能をインストールする必要があります。

(ユーザースクリプト管理ツールは設定済みなのでインストール!)

このスタイルをインストールするには、Stylusなどの拡張機能をインストールする必要があります。

このスタイルをインストールするには、Stylus などの拡張機能をインストールする必要があります。

このスタイルをインストールするには、Stylus tなどの拡張機能をインストールする必要があります。

このスタイルをインストールするには、ユーザースタイル管理用の拡張機能をインストールする必要があります。

このスタイルをインストールするには、ユーザースタイル管理用の拡張機能をインストールする必要があります。

このスタイルをインストールするには、ユーザースタイル管理用の拡張機能をインストールする必要があります。

(ユーザースタイル管理ツールは設定済みなのでインストール!)

このスクリプトの質問や評価の投稿はこちら通報はこちらへお寄せください
作者
oscar370
1日のインストール数
3
累計インストール数
1,598
評価
7 1 2
バージョン
2.0.6
作成日
2024/09/08
更新日
2025/05/20
大きさ
7.43KB
ライセンス
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! 🎉