How To Use "For Dummies"

Disclaimer: Please support Bandcamp artists; as they make their hard work available for reasonable prices! This program will only download 128kbps MP3's (good enough for a "preview"); purchase the artist's work for 320kbps and FLAC!

Setup:

Install Python 3.5+:

• Via the official installer:
  • Download and run the latest Python 3 installer.
  • Select "Add Python 3.x to PATH" at the bottom of the installer.

Versions of Bandcamp-dl prior to 0.0.7 supported Python > 3 however changes to Bandcamp itself cause them to no longer function.

Install Bandcamp-dl:

• Via PIP: pip3 install bandcamp-downloader
• From source:
  • Clone the project or download and extract the zip.
  • cd to the project directory containing the setup.py.
  • python setup.py install.
• From Release Wheel:
  • Download the appropriate .whl file from the releases page.
  • Navigate to the directory containing the .whl via cmd/terminal.
  • Execute: pip install FILENAME.whl

---

Examples:

Note: bandcamp-dl downloads to the current working directory, you can specify a download location with: --base-dir=/path/to/a/directory/

 
Standard album download:

bandcamp-dl https://sdoggingsworth.bandcamp.com/album/snacks-hugs-and-rock-n-roll

 
Single track download:

bandcamp-dl https://theenigmatng.bandcamp.com/track/the-glass-alice

Output: 01 - the-glass-alice

 
Change track naming scheme using --template:

bandcamp-dl https://theenigmatng.bandcamp.com/track/the-glass-alice --template="%{artist} %{album} - %{track} - %{title}"

Output: the-enigma-tng asia-deth 01 - the-glass-alice.mp3

 
For additional options see: https://github.com/iheanyi/bandcamp-dl#details