pyutube

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #claude-code #codex #cli #developer-tools #react #windows

★ 81 Open GitHub ↗

A simple user friendly command line tool to download YouTube videos and playlists with fewer steps.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 📹 Pyutube - The Simplest YouTube Downloader CLI

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

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

> [!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).

pyutube

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README