Downloads music files using pluggable backends. The default backend uses yt-dlp with YouTube Music search, rate limiting, and configurable output format.

Prerequisites

yt-dlp must be installed and on PATH
ffmpeg for audio conversion

Usage

# Download a single song
shanty-dl download "Pink Floyd Time"

# Download from a direct URL
shanty-dl download "https://www.youtube.com/watch?v=..."

# Add to download queue
shanty-dl queue add "Radiohead Creep"

# Process the queue
shanty-dl queue process

# List queue status
shanty-dl queue list

# Retry failed downloads
shanty-dl queue retry

YouTube Authentication

For higher rate limits (2000/hr vs 500/hr), export cookies:

yt-dlp --cookies-from-browser firefox --cookies ~/.config/shanty/cookies.txt

Then pass via --cookies ~/.config/shanty/cookies.txt or set SHANTY_COOKIES.