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):

# First, export your YouTube cookies to cookies.txt
yt-playlist-dl -c cookies.txt "https://www.youtube.com/playlist?list=LL"

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 (needed 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.1.tar.gz (5.2 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.1-py3-none-any.whl (6.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: ytplaylist_downloader-0.1.1.tar.gz
  • Upload date:
  • Size: 5.2 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.1.tar.gz
Algorithm Hash digest
SHA256 ec1159e34d5ac34c67af06cac750dd2c0526073f97608412aa94da72c72b4f8a
MD5 c594cf0208f778cb0513f7bb4b2372a7
BLAKE2b-256 94987b24f724cfd2d63d1722f92013286c5d111d8fbcf04b2d9a475a660e87c6

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for ytplaylist_downloader-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 e1816bf5278015ac4827dd5912e58a11137dfd547ff1797f403df1642411a4e3
MD5 b797e3d4536b0dc7530bff51c84d1be4
BLAKE2b-256 b07a6e35d60fe2a27768b3dc1927e13639f22f44f75c7434db1acdf01e525765

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