🎬 Clipr

Grab any video. Instantly.

A powerful YouTube video downloader with CLI and beautiful web interface.
Download videos in up to 4K, extract audio as MP3, grab entire playlists.

Installation • Usage • Features • Screenshots • API • Contributing

---

⚡ Quick Start

pip install clipr-yt

# Download a video
clipr https://youtube.com/watch?v=dQw4w9WgXcQ

# Download audio only (MP3)
clipr https://youtube.com/watch?v=dQw4w9WgXcQ -a

# Download in specific quality
clipr https://youtube.com/watch?v=dQw4w9WgXcQ -q 1080p

# Download entire playlist
clipr https://youtube.com/playlist?list=PLxxxxxx

---

✨ Features

Feature	Description
🎬 4K Video Downloads	Download videos up to 2160p quality
🎵 Audio Extraction	Extract audio as high-quality MP3
📋 Playlist Support	Download entire playlists in one command
🌐 Web Interface	Beautiful, responsive dark-themed UI
💻 CLI Interface	Full-featured command-line tool
📊 Progress Tracking	Real-time download progress with ETA
🔀 Auto-Merge	Automatically merges video + audio streams
🚀 Fast Downloads	Optimized for speed

---

📦 Installation

Via pip (Recommended)

pip install clipr-yt

From Source

git clone https://github.com/NiksheyYadav/Clipr.git
cd Clipr
pip install -r requirements.txt

Requirements

• Python 3.8+
• FFmpeg (for merging video + audio)

# Install FFmpeg
# Windows
winget install FFmpeg

# macOS
brew install ffmpeg

# Linux (Ubuntu/Debian)
sudo apt install ffmpeg

---

🚀 Usage

Command Line Interface

# Basic download (best quality)
clipr https://youtube.com/watch?v=VIDEO_ID

# Specify quality
clipr https://youtube.com/watch?v=VIDEO_ID -q 720p

# Audio only (MP3)
clipr https://youtube.com/watch?v=VIDEO_ID -a

# Custom output directory
clipr https://youtube.com/watch?v=VIDEO_ID -o ~/Downloads/Videos

# Download playlist
clipr https://youtube.com/playlist?list=PLAYLIST_ID

CLI Options

Option	Description
-q, --quality	Video quality (2160p, 1440p, 1080p, 720p, 480p, 360p)
-a, --audio-only	Download audio only as MP3
-o, --output	Output directory
-p, --playlist	Force playlist mode
--server	Start web interface
--port	Server port (default: 3000)
--help	Show help message

Web Interface

clipr --server
# Open http://localhost:3000

Or run directly:

python app.py

---

📸 Screenshots

🌙 Beautiful dark-themed web interface with glassmorphism design

Run clipr --server and open http://localhost:3000 to see!

Features:

• 🎨 Premium glassmorphism UI
• 🌓 Dark theme
• 📱 Fully responsive
• ⚡ Real-time progress tracking
• 🎬 Video preview with quality selection

---

🔌 API Reference

Clipr also provides a REST API when running the web server:

Endpoint	Method	Description
/api/info	POST	Get video metadata
/api/download	POST	Start download
/api/progress/:id	GET	Get download progress
/api/downloads	GET	List active downloads
/api/formats	GET	Get available formats

Example API Usage

import requests

# Get video info
response = requests.post('http://localhost:3000/api/info', json={
    'url': 'https://youtube.com/watch?v=VIDEO_ID'
})
print(response.json())

---

🛠️ Tech Stack

• Python - Core language
• Flask - Web framework
• pytubefix - YouTube extraction
• FFmpeg - Video/audio processing
• tqdm - Progress bars

---

📝 Changelog

v2.0.0 (2024-12-21)

• 🎨 Complete UI redesign with glassmorphism
• 🔧 Rebranded from YTSave to Clipr
• 📱 Mobile-responsive design
• 📦 Published to PyPI
• 📖 Added in-app documentation

v1.0.0

• Initial release
• CLI and web interface
• Video/audio downloads
• Playlist support

---

🤝 Contributing

Contributions are welcome! Feel free to:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing)
3. Commit changes (git commit -m 'Add amazing feature')
4. Push to branch (git push origin feature/amazing)
5. Open a Pull Request

---

📄 License

MIT © Nikshey Yadav

---

If you find Clipr useful, please ⭐ star the repo!

Made with ❤️ by Nikshey Yadav