Skip to content

hetari/pyutube

Repository files navigation

📹 Pyutube - The Simplest YouTube Downloader CLI

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

Ask in DeepWiki Version Downloads Downloads per Month Downloads per Week

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

Pyutube

Note

Have a feature request or bug report? tell me

Install

pip install pyutube

For local development:

pip install -e ".[dev]"

Use

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:

pyutube --help
python -m pyutube --help

Docs

License

MIT. See LICENSE.