Metadata-Version: 2.4
Name: download-any-video
Version: 0.1.0
Summary: A versatile, easy-to-use Python script to download videos from thousands of websites.
Home-page: https://github.com/Hejarshahabi/Download-Any-Video
Author: Hejar Shahabi
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Requires-Dist: yt-dlp
Requires-Dist: curl-cffi
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# 🌍 Download Any Video

[![PyPI version](https://img.shields.io/badge/PyPi%20Package-0.1.0-green)](https://pypi.org/project/download-any-video/) [![Downloads](https://pepy.tech/badge/download-any-video)](https://pepy.tech/project/download-any-video) [![Github](https://img.shields.io/badge/Github-Download--Any--Video-blueviolet)](https://github.com/Hejarshahabi/Download-Any-Video) [![LinkedIn](https://img.shields.io/badge/LinkedIn-Hejar%20Shahabi-blue)](https://www.linkedin.com/in/hejarshahabi/) [![Twitter URL](https://img.shields.io/twitter/url?color=blue&label=Hejar%20Shahabi&style=social&url=https%3A%2F%2Ftwitter.com%2Fhejarshahabi)](https://twitter.com/hejarshahabi)

A versatile, easy-to-use Python package to download videos from thousands of websites including YouTube, Twitter, Reddit, Vimeo, and more. This project is powered by [yt-dlp](https://github.com/yt-dlp/yt-dlp).

## Features
- **Wide Compatibility:** Supports extraction from almost any site that hosts videos.
- **High Quality:** Automatically downloads the best available video and audio qualities and merges them.
- **Bypass Blocks:** Configured to impersonate a real web browser (using `curl-cffi`) to bypass website blocks and prevent HTTP 410/403 errors.

## Prerequisites

- **Python 3.7+**
- **FFmpeg:** Highly recommended. `yt-dlp` uses FFmpeg to merge the highest quality video and audio streams together. If FFmpeg is not installed, you might get lower quality videos or separated audio/video files. 
  - *Windows:* Install via winget: `winget install ffmpeg`

## Installation

Install directly from PyPI:
```bash
pip install download-any-video
```

## Usage

Once installed, you can run the script from anywhere in your terminal:

```bash
download-any-video "YOUR_VIDEO_URL_HERE"
```

**Example:**
```bash
download-any-video "https://www.youtube.com/watch?v=dZDj2CnG5dE"
```

### Specify an Output Directory

If you want to save the video to a specific folder instead of the current directory, add the path as a second argument:

```bash
download-any-video "YOUR_VIDEO_URL_HERE" "./my_videos_folder"
```
