| --- |
| title: ReClip |
| emoji: 🎬 |
| colorFrom: yellow |
| colorTo: red |
| sdk: docker |
| app_port: 7860 |
| pinned: false |
| license: mit |
| short_description: Download video & audio from YouTube, TikTok & more |
| --- |
| |
| # ReClip |
|
|
| 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 |
|
|
|  |
|
|
| ## Features |
|
|
| - Download videos from 1000+ supported sites (via [yt-dlp](https://github.com/yt-dlp/yt-dlp)) |
| - MP4 video or MP3 audio extraction |
| - Quality/resolution picker |
| - Bulk downloads — paste multiple URLs at once |
| - Automatic URL deduplication |
| - Clean, responsive UI — no frameworks, no build step |
| - Single Python file backend (~150 lines) |
| - Intelligent Filename Generation — extracts and formats metadata gracefully (`Artist - Track.mp3` or `Channel - Title.mp4`). |
| - Anti-Bot Bypassing — utilizes `yt-dlp-ejs` and `pycryptodomex` to natively solve JavaScript challenges (e.g., YouTube's "Sign in to confirm you're not a bot"). |
|
|
| ## Quick Start |
|
|
| ```bash |
| brew install yt-dlp ffmpeg # or apt install ffmpeg && pip install yt-dlp |
| git clone https://github.com/averygan/reclip.git |
| cd reclip |
| ./reclip.sh |
| ``` |
|
|
| Open **http://localhost:8899**. |
|
|
| Or with Docker: |
|
|
| ```bash |
| docker build -t reclip . && docker run -p 8899:8899 reclip |
| ``` |
|
|
| ## Usage |
|
|
| 1. Paste one or more video URLs into the input box |
| 2. Choose **MP4** (video) or **MP3** (audio) |
| 3. Click **Fetch** to load video info and thumbnails |
| 4. Select quality/resolution if available |
| 5. Click **Download** on individual videos, or **Download All** |
|
|
| ## Supported Sites |
|
|
| Anything [yt-dlp supports](https://github.com/yt-dlp/yt-dlp/blob/master/supportedsites.md), 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 (~150 lines) |
| - **Frontend:** Vanilla HTML/CSS/JS (single file, no build step) |
| - **Download engine:** [yt-dlp](https://github.com/yt-dlp/yt-dlp) + [ffmpeg](https://ffmpeg.org/) |
| - **Dependencies:** `flask`, `yt-dlp`, `yt-dlp-ejs`, `pycryptodomex` |
|
|
| ## 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. |
|
|
| ## License |
|
|
| [MIT](LICENSE) |
|
|
