Metadata-Version: 2.4
Name: clipr-yt
Version: 2.0.0
Summary: Grab any video. Instantly. - YouTube video downloader with CLI and web interface
Author-email: Nikshey Yadav <niksheyyadav@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/NiksheyYadav/Clipr
Project-URL: Documentation, https://github.com/NiksheyYadav/Clipr#readme
Project-URL: Repository, https://github.com/NiksheyYadav/Clipr
Project-URL: Issues, https://github.com/NiksheyYadav/Clipr/issues
Keywords: youtube,downloader,video,audio,mp3,cli,clipr
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Multimedia :: Video
Classifier: Topic :: Internet :: WWW/HTTP :: Indexing/Search
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: pytubefix>=6.9.0
Requires-Dist: flask>=3.0.0
Requires-Dist: flask-cors>=4.0.0
Requires-Dist: tqdm>=4.66.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0.0; extra == "dev"

# Clipr 🎬

> Grab any video. Instantly.

A powerful YouTube video downloader with CLI and web interface.

[![PyPI version](https://badge.fury.io/py/clipr-yt.svg)](https://pypi.org/project/clipr-yt/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

## Features

- 🎬 **4K Video Downloads** - Up to 4K resolution
- 🎵 **Audio Extraction** - Download as MP3
- 📋 **Playlist Support** - Download entire playlists
- 🌐 **Web Interface** - Modern, responsive UI
- 💻 **CLI Interface** - Full command-line support
- 📊 **Progress Tracking** - Real-time progress

## Installation

```bash
pip install clipr-yt
```

### Requirements
- Python 3.8+
- FFmpeg (for merging video + audio)

```bash
# Install FFmpeg
# Windows
winget install FFmpeg

# macOS
brew install ffmpeg

# Linux
sudo apt install ffmpeg
```

## Usage

### Command Line

```bash
# Download video
clipr https://youtube.com/watch?v=VIDEO_ID

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

# Download audio only
clipr https://youtube.com/watch?v=VIDEO_ID -a

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

# Start web interface
clipr --server
```

### Web Interface

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

## CLI Options

| Option | Description |
|--------|-------------|
| `-q, --quality` | Video quality (2160p, 1080p, 720p...) |
| `-a, --audio-only` | Download audio as MP3 |
| `-o, --output` | Output directory |
| `-p, --playlist` | Force playlist mode |
| `--server` | Start web interface |
| `--port` | Server port (default: 3000) |

## License

MIT © Nikshey Yadav
