# bandcamp-dl
> Download audio from Bandcamp via the command line

## 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

## When to Use
- 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

## When NOT to Use
- You need to download from streaming services like Spotify or Apple Music
- You want a GUI-based download manager

## Usage Patterns
### Download an album
```
bandcamp-dl https://artist.bandcamp.com/album/album-name
```
Downloads all tracks from the specified Bandcamp album URL

### Download with custom output template
```
bandcamp-dl --template '%{artist}/%{album}/%{track} - %{title}' URL
```
Downloads using a custom directory and filename structure

## Installation
- **pip**: `pip install bandcamp-downloader`
- **homebrew**: `brew install bandcamp-dl`

## Related Tools
- [beets](/tools/beets) (complementary): beets can organize and tag the music library that bandcamp-dl downloads

---
Source: https://littlescripts.sh/tools/bandcamp-dl