A CLI tool to convert YouTube playlists into a single file
Project description
🎵 ytp-convert
ytp-convert is a Python-based command-line tool that downloads entire YouTube playlist and combines the content into a single media file.
Enjoy listening to your favorite playlists as one contiguous audio file, and skip advertisements.
🚀 Features
- Downloads entire YouTube playlists
- Merges all tracks into one file
- Cross-platform (Windows, macOS, Linux)
- Built with
yt-dlp,pydub, andffmpeg
📦 Installation
Installation of Python is required. You can install the tool from PyPI
pip install ytp-convert
⚠️ ffmpeg is required — see below.
Usage
| Option | Description |
|---|---|
url (positional) |
The YouTube playlist URL |
-o, --output |
Output filename (must end in .mp3) |
-f, --force |
Whether to skip or abort on failed video downloads |
ytp-convert "https://youtube.com/playlist?list=..." -o my_playlist.mp3
For more help, use
ytp-convert --help
🔧 System Requirement: ffmpeg
pydub requires ffmpeg to process audio streams.
macOS
brew install ffmpeg
Ubuntu / Debian
sudo apt install ffmpeg
Windows
Download from ffmpeg.org
Add the bin/ folder to your system PATH
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file ytp_convert-1.1.0.tar.gz.
File metadata
- Download URL: ytp_convert-1.1.0.tar.gz
- Upload date:
- Size: 5.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.12.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7d9e55bc758745163a3d05b81c27f8d620349b9be9aa1abcfa5e43eb490da63f
|
|
| MD5 |
63ea8cf5f36d9a78fe0738b103c9e9a2
|
|
| BLAKE2b-256 |
5761252016590f00dbaa2323b36894385cf58daeb6052669471531b79ac3fe05
|
File details
Details for the file ytp_convert-1.1.0-py3-none-any.whl.
File metadata
- Download URL: ytp_convert-1.1.0-py3-none-any.whl
- Upload date:
- Size: 6.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.12.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d6b94b9a88b2e5292d4bba7cde99b18166d3e40701c36b42d5bf537019ca1528
|
|
| MD5 |
85261a0d6a73eb4f8efbf6dfb8512ab1
|
|
| BLAKE2b-256 |
9d9214a6b766aa5184a80f84dcd1c5a21492089c98ca46899320011c6d30a5ab
|
