Metadata-Version: 2.4
Name: pyutube
Version: 1.6.21
Summary: Awesome CLI to download YouTube videos (as video or audio)/shorts/playlists from the terminal
Author: Ebraheem Alhetari
Author-email: hetari4all@gmail.com
License: MIT
Project-URL: Author, https://github.com/Hetari
Project-URL: Homepage, https://github.com/Hetari/pyutube
Project-URL: Bug Tracker, https://github.com/Hetari/pyutube/issues
Project-URL: Source Code, https://github.com/Hetari/pyutube
Project-URL: Documentation, https://github.com/Hetari/pyutube
Keywords: youtube,download,cli,pyutube,yt-dlp,youtube-dl
Platform: Linux
Platform: Windows
Platform: MacOS
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: yt-dlp==2026.03.17
Requires-Dist: inquirer
Requires-Dist: yaspin
Requires-Dist: typer
Requires-Dist: requests
Requires-Dist: rich
Requires-Dist: termcolor
Provides-Extra: dev
Requires-Dist: mypy<2.0,>=1.8; extra == "dev"
Requires-Dist: types-requests<3.0,>=2.32.0; extra == "dev"
Requires-Dist: ruff<1.0,>=0.9; extra == "dev"
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: keywords
Dynamic: license
Dynamic: license-file
Dynamic: platform
Dynamic: project-url
Dynamic: provides-extra
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# 📹 Pyutube - The Simplest YouTube Downloader CLI

### Enjoying my project? Please show your appreciation by starring it on GitHub! ⭐

<a href="https://deepwiki.com/Hetari/pyutube">
    <img src="https://deepwiki.com/badge.svg" alt="Ask in DeepWiki" />
</a>
<a href="https://github.com/Hetari/pyutube">
  <img src="https://img.shields.io/pypi/v/pyutube.svg?style=flat&label=Version" alt="Version">
</a>
<a href="https://pepy.tech/projects/pyutube">
  <img src="https://static.pepy.tech/badge/pyutube" alt="Downloads">
</a>
<a href="https://pepy.tech/projects/pyutube">
  <img src="https://static.pepy.tech/badge/pyutube/month" alt="Downloads per Month">
</a>
<a href="https://pepy.tech/projects/pyutube">
  <img src="https://static.pepy.tech/badge/pyutube/week" alt="Downloads per Week">
</a>

Pyutube is a small CLI for downloading YouTube videos, shorts, audio, and playlists.

<a href="https://ibb.co/27wcFYN">
   <img src="https://i.ibb.co/MDbPg56/Screenshot-from-2024-04-08-21-38-02-transformed.png" alt="Pyutube" style="width: 100%;">
</a>

> [!NOTE]
> Have a feature request or bug report? [tell me](https://github.com/Hetari/pyutube/issues/new)

## Install

```bash
pip install pyutube
```

For local development:

```bash
pip install -e ".[dev]"
```

## Use

```bash
pyutube "<youtube-url>"
pyutube "<youtube-url>" "/path/to/save"
pyutube "<youtube-url>" -a
pyutube "<youtube-url>" -f
pyutube "<playlist-url>"
pyutube "<youtube-url>" -- --ignore-errors --write-info-json
```

Short version:

- `URL` is required.
- `PATH` is optional and defaults to the current directory.
- `-a` downloads audio only (as MP3).
- `-f` downloads video only.
- Playlist URLs first show a selection menu so you can choose specific items or download all.
- Anything after `--` is forwarded to `yt-dlp`.

Check the CLI help:

```bash
pyutube --help
python -m pyutube --help
```

## Docs

- [EXAMPLES.md](EXAMPLES.md) for quick command examples.
- [QUALITY.md](QUALITY.md) for local checks.
- [CONTRIBUTING.md](CONTRIBUTING.md) for contribution rules.

## License

MIT. See [LICENSE](LICENSE).
