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"

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)
  -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.0.tar.gz (5.0 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.0-py3-none-any.whl (6.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: ytplaylist_downloader-0.1.0.tar.gz
  • Upload date:
  • Size: 5.0 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.0.tar.gz
Algorithm Hash digest
SHA256 5cf23487b008e4a43dba9fcf79eff300676a452d94a421446f3e65fbd05a77ee
MD5 3ac0f6cf704738937bbf9a1852b97ece
BLAKE2b-256 19876394caabcfcbce4d84d96286799db2ef5c3ae77934f884782106edb000f6

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for ytplaylist_downloader-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 0afd4ca4aea48b83aebe49fa647813c0122876f67abdd9501bd44476edefbd38
MD5 02300d27db1223b6ac1a051cc72a4b81
BLAKE2b-256 5946f3d971cf1e4fe472d469d5c6d1726d2e222cbbf533eda5da3f362d211739

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