Skip to main content

A lightweight CLI tool to download audio from YouTube playlists

Project description

yt-playlist-dl

A lightweight CLI tool to download audio from YouTube playlists and videos. Perfect for Termux on Android!

Features

  • 🎵 Download audio-only from YouTube playlists and individual videos
  • 📦 Lightweight with minimal dependencies (just yt-dlp)
  • 🚀 Simple command-line interface
  • 📱 Works great on Android via Termux
  • 🎚️ Customizable audio format and quality

Installation

From PyPI (once published)

pip install yt-playlist-dl

From source

git clone https://github.com/yourusername/yt-playlist-dl.git
cd yt-playlist-dl
pip install .

On Termux (Android)

pkg install python ffmpeg
pip install yt-playlist-dl

Usage

Download a playlist to the current directory:

yt-playlist-dl "https://www.youtube.com/playlist?list=..."

Download to a specific directory:

yt-playlist-dl -o ~/Music "https://www.youtube.com/playlist?list=..."

Download in different format with custom quality:

yt-playlist-dl -f m4a -q 256 "https://www.youtube.com/playlist?list=..."

Download a single video:

yt-playlist-dl "https://youtu.be/dQw4w9WgXcQ"

Download private playlists (like Liked videos) - extract cookies from browser:

# Make sure you're logged into YouTube in your browser first!
yt-playlist-dl --cookies-from-browser chrome "https://www.youtube.com/playlist?list=LL"
# Works with: chrome, firefox, brave, edge, opera, safari, chromium, vivaldi

Options

positional arguments:
  url                   YouTube playlist or video URL

optional arguments:
  -h, --help            show this help message and exit
  -o OUTPUT, --output OUTPUT
                        Output directory (default: current directory)
  -f {mp3,m4a,opus,wav,flac}, --format {mp3,m4a,opus,wav,flac}
                        Audio format (default: mp3)
  -q QUALITY, --quality QUALITY
                        Audio quality in kbps (default: 192)
  -c COOKIES, --cookies COOKIES
                        Path to cookies.txt file for authentication
  --cookies-from-browser {chrome,firefox,brave,edge,opera,safari,chromium,vivaldi}
                        Extract cookies from browser (easiest way for private playlists!)
  -v, --version         show program's version number and exit

Requirements

  • Python 3.7+
  • yt-dlp
  • FFmpeg (for audio conversion)

On Termux, install FFmpeg with:

pkg install ffmpeg

License

MIT License - feel free to use and modify!

Contributing

Pull requests welcome! For major changes, please open an issue first.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ytplaylist_downloader-0.1.3.tar.gz (5.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ytplaylist_downloader-0.1.3-py3-none-any.whl (6.6 kB view details)

Uploaded Python 3

File details

Details for the file ytplaylist_downloader-0.1.3.tar.gz.

File metadata

  • Download URL: ytplaylist_downloader-0.1.3.tar.gz
  • Upload date:
  • Size: 5.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for ytplaylist_downloader-0.1.3.tar.gz
Algorithm Hash digest
SHA256 5ecc1459056e9c12e844168d7a3a8724542d230c7fcca3d8ca35d3c2af83d0ce
MD5 9e4eda11210b484f9a1112e934f2431d
BLAKE2b-256 1bfbe7232999a3de620c0ec0485cef1362073cc123bee968143c443f49713e80

See more details on using hashes here.

File details

Details for the file ytplaylist_downloader-0.1.3-py3-none-any.whl.

File metadata

File hashes

Hashes for ytplaylist_downloader-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 4fc70e0a6d176dc193ec2b0012fafa9a2d6a19ddc266248812f13b8ce47db902
MD5 77d54eb2cd79cdb0abc27a31ed7866a1
BLAKE2b-256 d3558ae308005ade2dfc16c84289c5103a06a3a6f38a96dcd5603bd990704363

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page