# Install bandcamp-dl with Homebrew

Simple python script to download Bandcamp albums. Version 0.0.17 via Homebrew; verified 2026-05-20.

## Install

```sh
sudo av install brew:bandcamp-dl
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install bandcamp-dl
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:bandcamp-dl
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/bandcamp-dl>
- **Version:** 0.0.17
- **Source summary:** Simple python script to download Bandcamp albums
- **Homepage:** <https://github.com/evolution0/bandcamp-dl>
- **Repository:** <https://github.com/evolution0/bandcamp-dl>
- **Upstream docs:** <https://github.com/Evolution0/bandcamp-dl#readme>
- **License:** Unlicense
- **Source archive:** <https://files.pythonhosted.org/packages/78/c2/2c11878a494ceef38ed5ac51dede216547cb14ef40a30f8f009fca0ceab6/bandcamp_downloader-0.0.17.tar.gz>
- **Last updated:** 2026-05-20T10:37:28Z
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- bandcamp-dl (cli)
- bandcamp-dl (alias)

## Dependencies

- certifi
- python@3.14

## Install behavior

- Post-install hook: not defined
- Bottle: available on all

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 0.0.17
- Package-manager updated: 2026-05-20
- Local data: ok
- Upstream repository: https://github.com/evolution0/bandcamp-dl
- info: No cached GitHub release or tag data was available.
## Project history and usage

bandcamp-dl is a Python command-line downloader for Bandcamp albums and tracks. It follows the youtube-dl tradition of a small CLI that turns media-site pages into local files, but it is specialized for Bandcamp metadata, album art, lyrics, and filename templating.

### Project history

The public repository history begins in April 2013. The current project metadata names the PyPI package bandcamp-downloader and lists Iheanyi Ekechukwu and Anthony Forsberg as authors, with the GitHub repository as its source and tracker.

The changelog shows the project maturing through the 0.0.x releases with practical downloader concerns: safer interrupted downloads, album-art controls, individual-track support, ID3/tagging compatibility, dependency cleanup, and Python 3-focused maintenance.

### Adoption history

The official README documents installation from PyPI, wheels, source, Homebrew on macOS, and Arch AUR. The supplied package facts currently list Homebrew packaging, which is consistent with its role as a small end-user media utility rather than a foundational library.

### How it is used

The basic interface is bandcamp-dl URL, with options for artist, album, and track slugs, output templates, base directory, album-art embedding, lyrics embedding, filename normalization, and overwrite/resume behavior.

Its README explicitly frames bug reports around reproducible URLs and command options, which is typical for site-specific download tools that must adapt when the upstream website changes.

### Why package nerds care

bandcamp-dl is a small but recognizable example of the long tail of media downloaders that package managers carry for users who prefer scriptable local archives. The package is also a maintenance reminder: site scrapers are useful, but they depend on HTML and metadata behavior outside the package maintainer's control.

### Timeline

- 2013: Public Git history begins with the initial repository commits.
- 2016: v0.0.5 documents ID3, incomplete-download, and dependency improvements.
- 2017: v0.0.6 marks the last version to officially support Python 2.7.x.
- 2017: v0.0.7 adds safer resume behavior and cleaner CLI output.
- 2025: v0.0.17 is tagged with a lyrics-related fix.

### Related projects

- bandcamp-dl is related to youtube-dl and yt-dlp in package-manager culture, but it is narrower: it targets Bandcamp album and track pages rather than broad video-site extraction.

### Sources

- <https://github.com/Evolution0/bandcamp-dl>
- <https://github.com/Evolution0/bandcamp-dl/blob/master/CHANGELOG.rst>
- <https://github.com/Evolution0/bandcamp-dl/blob/master/README.rst>
- <https://github.com/Evolution0/bandcamp-dl/blob/master/pyproject.toml>
- <https://github.com/Evolution0/bandcamp-dl/commit/9a24e93ab968b5d566724fe5d1be3654a852dc23>
- input.source_facts.package-manager


## Security Notes

No matching local secret-handling manifest was found for bandcamp-dl. Nucleus package metadata is still published here so future coverage has a stable package URL.


## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** bandcamp-dl
- **Version Scheme:** 0
- **Revision:** 7
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Language runtime packages](https://www.automicvault.com/pkg/language-runtime-packages/) - Matched language runtime, compiler, or interpreter metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [python@3.14](https://www.automicvault.com/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew.
- [cmusfm](https://www.automicvault.com/pkg/brew/cmusfm/) - Shares av.db curated category or tags: audio, cli, media, music.
- [csound](https://www.automicvault.com/pkg/brew/csound/) - Shares av.db curated category or tags: audio, cli, media, music.
- [pocket-tts](https://www.automicvault.com/pkg/brew/pocket-tts/) - Shares av.db curated category or tags: audio, cli, media, python.
- [timidity](https://www.automicvault.com/pkg/brew/timidity/) - Shares av.db curated category or tags: audio, cli, media, music.
- [waon](https://www.automicvault.com/pkg/brew/waon/) - Shares av.db curated category or tags: audio, cli, media, music.
- [abcde](https://www.automicvault.com/pkg/brew/abcde/) - Shares av.db curated category or tags: audio, cli, media.
- [adplay](https://www.automicvault.com/pkg/brew/adplay/) - Shares av.db curated category or tags: audio, cli, media.
- [adplug](https://www.automicvault.com/pkg/brew/adplug/) - Shares av.db curated category or tags: audio, cli, media.
- [scdl](https://www.automicvault.com/pkg/brew/scdl/) - Both packages touch the same language runtime or ecosystem. Shared terms: certifi, cli, download, media, music.
- [bilix](https://www.automicvault.com/pkg/brew/bilix/) - Both packages touch the same language runtime or ecosystem. Shared terms: certifi, cli, download, media, python.

## Combined YAML source

View the package source record on GitHub. [combined/bandcamp-dl.yml](https://github.com/automic-vault/db/blob/main/combined/bandcamp-dl.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- cross-ecosystem install command graph
