ReClip

ReClip

すっきりとしたウェブ UI を備えた、セルフホスト可能なオープンソースの動画・音声ダウンローダーです。YouTube、TikTok、Instagram、Twitter/X、その他 1000 以上のサイトのリンクを貼り付けて、MP4 または MP3 でダウンロードできます。

https://github.com/user-attachments/assets/419d3e50-c933-444b-8cab-a9724986ba05

機能

• yt-dlp を利用して、対応する 1000 以上のサイトから動画をダウンロード
• MP4 動画または MP3 音声の抽出
• 品質・解像度の選択
• 元のコンテンツ全体を先に保存せず、開始・終了時刻を指定して正確な範囲をダウンロード
• 一括ダウンロード — 複数の URL を一度に貼り付け
• URL の自動重複排除
• すっきりとしたレスポンシブ UI — フレームワーク不要、ビルド手順不要
• ネイティブデスクトップアプリ — Windows、macOS、Linux 向けのインストール不要なスタンドアロン実行ファイルです。
• インテリジェントなファイル名生成 — メタデータを適切に抽出し、形式を整えます（Artist - Track.mp3 または Channel - Title.mp4）。
• ローカル優先の動作 — ダウンロードはユーザー自身のマシンとネットワーク接続で実行されます。
• 自動ビルドパイプライン — GitHub Actions がバージョンタグのプッシュごとに実行ファイルを自動でコンパイルして公開します。

🚀 ReClip アプリをダウンロード

Python をインストールしたり、ターミナルを使ったりする必要はありません。お使いの OS 向けのビルド済みスタンドアロン実行ファイルをダウンロードしてください。

• 🪟 Windows: ReClip.exe
• 🍎 macOS: ReClip-macos.dmg
• 🐧 Linux: ReClip

注：ネイティブアプリにはサーバーと PyWebView ブラウザーが同梱されています。アプリを開くだけで、専用のネイティブウィンドウで起動します。

YouTube の変更後も動作し続けます。 アプリには yt-dlp が同梱されていますが、常に最新の状態である必要はありません。1 日に 1 回、また新しい yt-dlp で通常解決するダウンロードエラー（HTTP 403、「確認のためログインしてください」、プレーヤーの変更など）が発生した場合、ReClip は最新の yt-dlp を PyPI からユーザープロファイルに取得し、チェックサムを検証してから再試行します。ウィンドウ下部の 更新を確認 をクリックして確認することもできます。それ以外に何かがダウンロードされたり、どこかに送信されたりすることはありません。

YouTube の利用には JavaScript ランタイムが必要です。 yt-dlp は Deno（推奨）または Node.js を使って YouTube のプレーヤーチャレンジを解決します。「YouTube needs a JavaScript runtime」と表示された場合は、いずれかをインストールして ReClip を再起動してください。

🔏 コード署名ポリシー

SignPath.io が無料でコード署名を提供し、SignPath Foundation が証明書を提供しています。

ReClip.exe の Windows 版は GitHub Actions でビルドされ、SignPath Foundation の証明書で Authenticode 署名されています。Windows に表示される発行元は SignPath Foundation です。署名はタグ付きリリースでのみ実行されます。パイプライン全体は .github/workflows/build.yml に、成果物の設定は .signpath/artifact-configuration.xml にあります。

チームの役割

役割	メンバー
コミッターとレビュー担当者	@yagyaanshK
承認者	@yagyaanshK

プライバシーポリシー

ユーザー、またはインストールもしくは運用する人が明示的に要求しない限り、このプログラムがネットワーク接続された他のシステムに情報を転送することはありません。自動的に行われるネットワークアクセスは、pypi.org に新しい yt-dlp のリリースがあるかを 1 日に 1 回確認することだけです（上記の「YouTube の変更後も動作し続けます」を参照）。このリクエストにユーザーデータは含まれません。ReClip が接続するのは、URL を貼り付けたメディアサイトのみです。デスクトップアプリはすべてユーザー自身のコンピューター上で動作します。

🛠️ ソースから実行（ターミナル）

git clone https://github.com/yagyaanshK/reclip.git
cd reclip

Windows の場合： start_windows.bat をダブルクリックします。

Mac / Linux の場合：

./reclip.sh

ブラウザーで http://localhost:8899 を開きます。

実行ファイルをローカルでビルドする

ReClip をスタンドアロンの実行ファイルに手動でコンパイルするには：

• Windows： build_windows.bat を実行します -> 出力先は dist/ です
• Mac / Linux： ./build_unix.sh を実行します -> 出力先は dist/ です

または、Docker を使います：

docker build -t reclip . && docker run -p 8899:8899 reclip

使い方

1. 1 つ以上の動画 URL を入力欄に貼り付けます
2. MP4（動画）または MP3（音声）を選択します
3. Fetch をクリックして動画情報とサムネイルを読み込みます
4. 利用可能な場合は、画質／解像度を選択します
5. 必要に応じて Clip を有効にし、開始／終了時刻を SS、MM:SS、または HH:MM:SS.000 の形式で入力します
6. 個別の動画の Download、または Download All をクリックします

コマンドラインインターフェース

ReClip は、シェルスクリプトや AI エージェント向けの、構造化されたローカル CLI も提供しています。uv を使って Python 3.10 以降の環境にインストールします：

uv tool install reclip-mcp

次に、以下を実行します：

reclip inspect "https://example.com/media" --json
reclip download "https://example.com/media" --format mp4 --quality 1080p --output downloads --json
reclip clip "https://example.com/media" --start 01:20:15.500 --end 01:25:00 --format mp3 --output downloads --json
reclip sites --json

すべての JSON レスポンスには ok フィールドが含まれます。失敗時には、安定した機械可読のエラー code と、人間が読める message が含まれます。ダウンロードはローカルで行われ、絶対パス、ファイル名、バイトサイズ、形式、ソース URL、クリップ範囲が返されます。

AI エージェントとの連携（MCP）

リポジトリをクローンせずに、stdio 経由で ReClip をインストールして起動するよう、MCP ホストを設定します：

{
  "mcpServers": {
    "reclip": {
      "command": "uvx",
      "args": ["reclip-mcp"],
      "env": {
        "RECLIP_MCP_DOWNLOAD_DIR": "/absolute/path/to/downloads"
      }
    }
  }
}

MCP ホストがシェルの PATH を引き継がない場合は、uvx の絶対パスを使用します。サーバーは inspect_media、download_media、download_clip、list_supported_sites を公開します。ダウンロードツールには明示的なユーザー認可が必要で、書き込み先は RECLIP_MCP_DOWNLOAD_DIR のみです。既定値は ~/Downloads/ReClip です。

• PyPI パッケージ
• 公式 MCP Registry の登録情報

チェックアウトから開発する場合は、python -m pip install . を実行し、ホストが python -m reclip_mcp を実行するように設定します。

対応サイト

以下を含む、yt-dlp が対応するサイト：

YouTube、TikTok、Instagram、Twitter/X、Reddit、Facebook、Vimeo、Twitch、Dailymotion、SoundCloud、Loom、Streamable、Pinterest、Tumblr、Threads、LinkedIn など多数。

技術スタック

• バックエンド： Python + Flask
• フロントエンド： Vanilla HTML/CSS/JS（単一ファイル、ビルド工程なし）
• ダウンロードエンジン： yt-dlp + ffmpeg
• 依存関係： flask、yt-dlp、yt-dlp-ejs、pycryptodomex、pywebview、pyinstaller、imageio-ffmpeg

免責事項

このツールは個人利用のみを目的としています。ダウンロード元のプラットフォームの著作権法および利用規約を遵守してください。このツールの不正利用について、開発者は一切責任を負いません。

ライセンス

MIT