Metadata-Version: 2.4
Name: FREE--BUFF
Version: 1.1.15
Summary: A feature-rich command-line audio/video downloader
Project-URL: Documentation, https://github.com/rahulae1616-rgb/FREE-STUFF#readme
Project-URL: Repository, https://github.com/rahulae1616-rgb/FREE-STUFF
Project-URL: Tracker, https://github.com/rahulae1616-rgb/FREE-STUFF/issues
Author: RAHUL CHANDRA
Maintainer: RAHUL CHANDRA
License-Expression: Unlicense
License-File: LICENSE
Keywords: cli,downloader,free-stuff,video-downloader
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: Implementation
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Topic :: Multimedia :: Video
Requires-Python: >=3.11
Provides-Extra: curl-cffi
Requires-Dist: curl-cffi!=0.6.*,!=0.7.*,!=0.8.*,!=0.9.*,<0.16,>=0.5.10; (implementation_name == 'cpython') and extra == 'curl-cffi'
Provides-Extra: default
Requires-Dist: brotli; (implementation_name == 'cpython' and sys_platform != 'ios') and extra == 'default'
Requires-Dist: brotlicffi; (implementation_name != 'cpython') and extra == 'default'
Requires-Dist: certifi; extra == 'default'
Requires-Dist: freestuff-ejs==0.8.0; extra == 'default'
Requires-Dist: mutagen; extra == 'default'
Requires-Dist: pycryptodomex; extra == 'default'
Requires-Dist: requests<3,>=2.32.2; extra == 'default'
Requires-Dist: urllib3<3,>=2.0.2; extra == 'default'
Requires-Dist: websockets>=13.0; extra == 'default'
Provides-Extra: deno
Requires-Dist: deno>=2.6.6; extra == 'deno'
Provides-Extra: pin
Requires-Dist: brotli==1.2.0; (implementation_name == 'cpython' and sys_platform != 'ios') and extra == 'pin'
Requires-Dist: brotlicffi==1.2.0.1; (implementation_name != 'cpython') and extra == 'pin'
Requires-Dist: certifi==2026.6.17; extra == 'pin'
Requires-Dist: charset-normalizer==3.4.7; extra == 'pin'
Requires-Dist: freestuff-ejs==0.8.0; extra == 'pin'
Requires-Dist: idna==3.18; extra == 'pin'
Requires-Dist: mutagen==1.48.1; extra == 'pin'
Requires-Dist: pycryptodomex==3.23.0; extra == 'pin'
Requires-Dist: requests==2.34.2; extra == 'pin'
Requires-Dist: urllib3==2.7.0; extra == 'pin'
Requires-Dist: websockets==16.0; extra == 'pin'
Provides-Extra: pin-curl-cffi
Requires-Dist: certifi==2026.6.17; (implementation_name == 'cpython') and extra == 'pin-curl-cffi'
Requires-Dist: cffi==2.0.0; (implementation_name == 'cpython') and extra == 'pin-curl-cffi'
Requires-Dist: curl-cffi==0.15.0; (implementation_name == 'cpython') and extra == 'pin-curl-cffi'
Requires-Dist: markdown-it-py==4.2.0; (implementation_name == 'cpython') and extra == 'pin-curl-cffi'
Requires-Dist: mdurl==0.1.2; (implementation_name == 'cpython') and extra == 'pin-curl-cffi'
Requires-Dist: pycparser==3.0; (implementation_name == 'cpython') and extra == 'pin-curl-cffi'
Requires-Dist: pygments==2.20.0; (implementation_name == 'cpython') and extra == 'pin-curl-cffi'
Requires-Dist: rich==15.0.0; (implementation_name == 'cpython') and extra == 'pin-curl-cffi'
Provides-Extra: pin-deno
Requires-Dist: deno==2.8.3; extra == 'pin-deno'
Provides-Extra: pin-secretstorage
Requires-Dist: cffi==2.0.0; (platform_python_implementation != 'PyPy') and extra == 'pin-secretstorage'
Requires-Dist: cryptography==49.0.0; extra == 'pin-secretstorage'
Requires-Dist: jeepney==0.9.0; extra == 'pin-secretstorage'
Requires-Dist: pycparser==3.0; (implementation_name != 'PyPy' and platform_python_implementation != 'PyPy') and extra == 'pin-secretstorage'
Requires-Dist: secretstorage==3.5.0; extra == 'pin-secretstorage'
Requires-Dist: typing-extensions==4.15.0; (python_full_version < '3.11') and extra == 'pin-secretstorage'
Provides-Extra: secretstorage
Requires-Dist: secretstorage; extra == 'secretstorage'
Description-Content-Type: text/markdown

```
███████   ███████   ████████  ████████      ███████   ████████  █      █  ███████   ███████
█         █     ██  █         █             █            █      █      █  █         █
███████   ███████   ████████  ████████      ███████      █      █      █  ███████   ███████
█         █  ██     █         █                    █     █      █      █  █         █
█         █    ███  ████████  ████████      ███████      █       ██████   █         █
```

  **Developed by RAHUL CHANDRA**

  **Paste URL:** https://github.com/rahulae1616-rgb/FREE-STUFF

<div align="center">

# FREE STUFF

**A feature-rich command-line audio/video downloader for thousands of websites.**

[![PyPI](https://img.shields.io/badge/PyPI-FREE--BUFF-blue?logo=pypi&logoColor=white)](https://pypi.org/project/FREE-BUFF/)
[![Python](https://img.shields.io/badge/Python-%3E%3D3.10-blue?logo=python&logoColor=white)](pyproject.toml)
[![GitHub](https://img.shields.io/badge/GitHub-rahulae1616--rgb%2FFREE--STUFF-181717?logo=github)](https://github.com/rahulae1616-rgb/FREE-STUFF)
[![License](https://img.shields.io/badge/License-Unlicense-red)](LICENSE)

</div>

---

## What is FREE STUFF?

FREE STUFF lets you download videos and audio from **YouTube**, **Twitter**, **TikTok**, **Twitch**, **Instagram**, **Facebook**, and **thousands of other sites** — all from one command.

It is a fork of `yt-dlp` (which is itself a fork of `youtube-dl`).

---

## Installation

### Worldwide — one command

```bash
pip install FREE--BUFF
```

Then use it:

```bash
freestuff "https://www.youtube.com/watch?v=..."
```

### Windows (no Python needed)

Download and run `install_freestuff.bat` from the repo — it sets up FREE STUFF globally without needing Python installed.

### Upgrade

```bash
pip install --upgrade FREE--BUFF
```

---

## Quick Start

```bash
# Download a video (best quality)
freestuff "https://www.youtube.com/watch?v=dQw4w9WgXcQ"

# Download audio only (MP3)
freestuff -x --audio-format mp3 "https://www.youtube.com/watch?v=dQw4w9WgXcQ"

# List available formats
freestuff -F "https://www.youtube.com/watch?v=dQw4w9WgXcQ"

# Download a specific format
freestuff -f 137+140 "https://www.youtube.com/watch?v=dQw4w9WgXcQ"

# Download an entire playlist
freestuff "https://www.youtube.com/playlist?list=PL..."

# Download with custom filename
freestuff -o "%(title)s.%(ext)s" "https://www.youtube.com/watch?v=..."
```

---

## Supported Sites

FREE STUFF supports **thousands of websites**. See the full list in [`supportedsites.md`](supportedsites.md).

Major platforms include:
- YouTube, YouTube Music
- Twitter / X
- TikTok
- Twitch
- Instagram
- Facebook
- Vimeo
- SoundCloud
- Bandcamp
- Reddit
- And **1500+ more**

---

## Requirements

- **Python 3.10+** (for pip install)
- **ffmpeg** (recommended for merging audio/video and post-processing)

---

## Author

**RAHUL CHANDRA**

---

## License

[Unlicense](LICENSE) — public domain. Do whatever you want.
