ReClip

ReClip

一款可自托管的开源视频和音频下载器，配有简洁的 Web UI。粘贴来自 YouTube、TikTok、Instagram、Twitter/X 及其他 1000 多个网站的链接，即可下载为 MP4 或 MP3。

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

功能

• 下载来自 1000 多个受支持网站的视频（通过 yt-dlp）
• 提取 MP4 视频或 MP3 音频
• 选择画质／分辨率
• 按开始／结束时间下载指定片段，无需先保存完整源文件
• 批量下载——一次粘贴多个 URL
• 自动去重 URL
• 简洁、响应式的 UI——无需框架，无需构建步骤
• 原生桌面应用——适用于 Windows、macOS 和 Linux 的独立可执行文件，无需安装。
• 智能文件名生成——从元数据中提取信息并妥善格式化（Artist - Track.mp3 或 Channel - Title.mp4）。
• 本地优先运行——下载使用用户自己的设备和网络连接。
• 自动构建流程——GitHub Actions 会在每次推送版本标签时自动编译并发布新的可执行文件。

🚀 下载 ReClip 应用

无需安装 Python 或使用终端。下载适用于你操作系统的预构建独立可执行文件：

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

注意：原生应用内置了服务端和 PyWebView 浏览器。只需打开应用，它就会在自己的原生窗口中启动！

YouTube 更新时，应用会自动保持可用。 应用内附带一份 yt-dlp，但不依赖它始终保持最新：ReClip 每天会检查一次；如果下载因通常可通过新版 yt-dlp 修复的问题而失败（HTTP 403、“sign in to confirm”、播放器变更），也会检查更新。ReClip 会从 PyPI 获取最新版 yt-dlp 到你的用户配置文件中，验证其校验和，然后重试。你也可以点击窗口底部的 Check for updates。不会下载或发送其他任何内容。

YouTube 需要 JavaScript 运行时。 yt-dlp 使用 Deno（推荐）或 Node.js 应对 YouTube 播放器挑战。如果看到“YouTube needs a JavaScript runtime”，请安装其中一种并重启 ReClip。

🔏 代码签名政策

由 SignPath.io 免费提供代码签名，证书由 SignPath Foundation 提供。

Windows 版 ReClip.exe 通过 GitHub Actions 构建，并使用 SignPath Foundation 证书进行 Authenticode 签名。Windows 显示的发布者是 SignPath Foundation。签名仅用于带标签的版本；完整流水线位于 .github/workflows/build.yml，制品配置位于 .signpath/artifact-configuration.xml。

团队角色

角色	成员
提交者和审阅者	@yagyaanshK
批准者	@yagyaanshK

隐私政策

除非用户或安装、运行该程序的人员明确提出请求，否则本程序不会向其他联网系统传输任何信息。唯一的自动网络访问是每天检查 pypi.org 是否有更新版本的 yt-dlp（见上文“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. 在输入框中粘贴一个或多个视频 URL
2. 选择 MP4（视频）或 MP3（音频）
3. 点击 Fetch 以加载视频信息和缩略图
4. 如果有可用选项，选择质量／分辨率
5. 可选：启用 Clip，并以 SS、MM:SS 或 HH:MM:SS.000 格式输入开始／结束时间
6. 点击单个视频上的 Download，或点击 Download All

命令行界面

ReClip 还提供了结构化的本地 CLI，可用于 shell 脚本和 AI Agent。在 Python 3.10+ 环境中使用 uv 安装：

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 Agent 集成（MCP）

配置 MCP 主机，无需克隆代码库即可通过 stdio 安装并启动 ReClip：

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

如果 MCP 主机无法继承 shell 的 PATH，请使用 uvx 的绝对路径。服务提供 inspect_media、download_media、download_clip 和 list_supported_sites。下载工具需要用户明确授权，且只能写入 RECLIP_MCP_DOWNLOAD_DIR，其默认值为 ~/Downloads/ReClip。

• PyPI 软件包
• 官方 MCP 注册表记录

如需基于检出代码进行开发，请运行 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
• 前端： 原生 HTML/CSS/JS（单文件，无需构建步骤）
• 下载引擎： yt-dlp + ffmpeg
• 依赖项： flask、yt-dlp、yt-dlp-ejs、pycryptodomex、pywebview、pyinstaller、imageio-ffmpeg

免责声明

此工具仅供个人使用。请遵守版权法以及下载平台的服务条款。开发者不对任何滥用此工具的行为负责。

许可证

MIT