yt-playlist-dl

Small utility to download a YouTube playlist using the YouTube Data API v3 (to enumerate playlist items) and yt-dlp for downloads.

Requirements

• Python 3.13+
• A Google API key with YouTube Data API v3 enabled

Install

1. Create a virtual environment and install dependencies:

python -m venv .venv
source .venv/bin/activate.fish
pip install -r requirements.txt  # or use pip install -e .

Usage

Set your API key in .env or pass --api-key:

cp .env.example .env
# edit .env and set YT_API_KEY
python -m yt_playlist_dl.cli --playlist-url "https://www.youtube.com/playlist?list=PL..." --out-dir downloads

Notes

• This project uses the YouTube Data API v3 to list videos in a playlist, then calls yt-dlp to download them.