← Back to tools
View AGENTS.md for bandcamp-dl
bandcamp-dl
Download audio from Bandcamp via the command line
Description
bandcamp-dl is a small command-line application to download audio from bandcamp.com. It supports downloading individual tracks, full albums, or complete artist discographies. Features include embedded album artwork and lyrics, ID3 tag management via Mutagen, customizable output filename templates, and configurable audio quality settings. Requires Python 3.4+.
Install
pip
pip install bandcamp-downloaderhomebrew
brew install bandcamp-dlAI Summary
A command-line tool to download tracks, albums, and discographies from Bandcamp with metadata embedding.
Capabilities
- + Download individual tracks, full albums, or complete artist discographies
- + Embed album artwork and track lyrics into downloaded files
- + Manage ID3 tags via Mutagen
- + Customize output filenames with template tokens like %{artist}, %{album}, %{track}
- + Select album art quality and audio format
Use When
- → You want to download music you have purchased or is freely available on Bandcamp
- → You need batch downloading of entire albums or discographies
- → You want properly tagged audio files with embedded artwork
Avoid When
- x You need to download from streaming services like Spotify or Apple Music
- x You want a GUI-based download manager
Usage Patterns
Download an album
bandcamp-dl https://artist.bandcamp.com/album/album-nameDownloads all tracks from the specified Bandcamp album URL
Download with custom output template
bandcamp-dl --template '%{artist}/%{album}/%{track} - %{title}' URLDownloads using a custom directory and filename structure