A self-hosted, open-source video and audio downloader with a clean web UI. Paste links from YouTube, TikTok, Instagram, Twitter/X, and 1000+ other sites — download as MP4 or MP3.

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

ReClip MP3 Mode

Features

Download videos from 1000+ supported sites (via yt-dlp)
MP4 video or MP3 audio extraction
Quality/resolution picker
Download precise clips by start/end time without first storing the full source
Bulk downloads — paste multiple URLs at once
Automatic URL deduplication
Clean, responsive UI — no frameworks, no build step
Native Desktop Apps — zero-install standalone executables for Windows, macOS, and Linux.
Intelligent Filename Generation — extracts and formats metadata gracefully (Artist - Track.mp3 or Channel - Title.mp4).
Local-first operation — downloads run on the user's own machine and network connection.
Automated Build Pipeline — GitHub Actions automatically compiles and publishes new executables upon every version tag push.

🚀 Download ReClip App

You don't need to install Python or use the terminal. Download the pre-built standalone executable for your operating system:

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

Note: The native apps contain a bundled server and PyWebView browser. Simply open the app and it will launch right in its own native window!

🛠️ Run from Source (Terminal)

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

On Windows: Double-click start_windows.bat.

On Mac / Linux:

./reclip.sh

Open http://localhost:8899 in your browser.

Build Executables Locally

To manually compile ReClip into a standalone executable:

Windows: Run build_windows.bat -> Output in dist/
Mac / Linux: Run ./build_unix.sh -> Output in dist/

Or with Docker:

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

Usage

Paste one or more video URLs into the input box
Choose MP4 (video) or MP3 (audio)
Click Fetch to load video info and thumbnails
Select quality/resolution if available
Optionally enable Clip and enter start/end times as SS, MM:SS, or HH:MM:SS.000
Click Download on individual videos, or Download All

Command-Line Interface

ReClip also exposes a structured local CLI for shell scripts and AI agents. Install it in a Python 3.10+ environment with uv:

uv tool install reclip-mcp

Then run:

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

All JSON responses contain an ok field. Failures include a stable machine-readable error code and a human-readable message. Downloads occur locally and return the absolute output path, filename, byte size, format, source URL, and clip range.

AI Agent Integration (MCP)

Configure an MCP host to install and start ReClip over stdio without cloning the repository:

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

Use the absolute path to uvx if the MCP host does not inherit your shell PATH. The server exposes inspect_media, download_media, download_clip, and list_supported_sites. Download tools require explicit user authorization and can write only to RECLIP_MCP_DOWNLOAD_DIR, which defaults to ~/Downloads/ReClip.

For development from a checkout, run python -m pip install . and configure the host to execute python -m reclip_mcp.

Supported Sites

Anything yt-dlp supports, including:

YouTube, TikTok, Instagram, Twitter/X, Reddit, Facebook, Vimeo, Twitch, Dailymotion, SoundCloud, Loom, Streamable, Pinterest, Tumblr, Threads, LinkedIn, and many more.

Stack

Backend: Python + Flask
Frontend: Vanilla HTML/CSS/JS (single file, no build step)
Download engine: yt-dlp + ffmpeg
Dependencies: flask, yt-dlp, yt-dlp-ejs, pycryptodomex, pywebview, pyinstaller, imageio-ffmpeg

Disclaimer

This tool is intended for personal use only. Please respect copyright laws and the terms of service of the platforms you download from. The developers are not responsible for any misuse of this tool.