reclip / README.md
Khaneja
docs: sync hf-deploy docs to accurately reflect new app logic and web dependencies
7267f0e
|
Raw
History Blame Contribute Delete
2.65 kB
metadata
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.

Python License

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
  • 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

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:

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, 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 + ffmpeg
  • 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