Skip to content

bandcamp dl.1

Jump to bottom
Ronald Record edited this page Aug 29, 2022 · 1 revision

NAME

bandcamp-dl - Download tracks and albums in a Bandcamp collection

SYNOPSIS

bandcamp-dl [options] [URL ...]

ARGUMENTS

  • URL Bandcamp album/track URL

OPTIONS

  • -h --help Show this screen.
  • -v --version Show version.
  • -d --debug Verbose logging.
  • --artist= The artist's slug (from the URL, --track or --album is required)
  • --track= The track's slug (from the URL, for use with --artist)
  • --album= The album's slug (from the URL, for use with --artist)
  • --template= Output filename template. [default: %{artist}/%{album}/%{track} - %{title}]
  • --base-dir= Base location of which all files are downloaded.
  • -f --full-album Download only if all tracks are available.
  • -o --overwrite Overwrite tracks that already exist. Default is False.
  • -n --no-art Skip grabbing album art.
  • -e --embed-lyrics Embed track lyrics (If available)
  • -g --group Use album/track Label as iTunes grouping.
  • -r --embed-art Embed album art (If available)
  • -y --no-slugify Disable slugification of track, album, and artist names.
  • -c --ok-chars= Specify allowed chars in slugify. [default: - ~]
  • -s --space-char= Specify the char to use in place of spaces. [default: -]
  • -a --ascii-only Only allow ASCII chars (北京 (capital of china) -> bei-jing-capital-of-china)
  • -k --keep-spaces Retain whitespace in filenames
  • -u --keep-upper Retain uppercase letters in filenames

DESCRIPTION

The bandcamp-dl command can be used to download tracks and albums from a Bandcamp collections. MusicPlayerPlus provides a convenience wrapper for bandcamp-dl, /usr/share/musicplayerplus/calliope/bandcamp-download.

AUTHORS

bandcamp-dl is written and maintained by:

  • Iheanyi Ekechukwu
  • Anthony Forsberg
  • John Titor
  • Alex Bouffard
  • Pedro Lopes
  • Bendito999
  • Gabor Szabo
  • Vladde Nordholm
  • Simon W. Jackson
  • Yo'av Moshe
  • Mitchell Barron
  • Seppi
  • Andrew Sampson
  • Joseph Kahn
  • Diego Costa
  • Gal Schlezinger

bandcamp-download is written by Ronald Record github@ronrecord.com

LICENSING

BANDCAMP-DL is distributed under an Open Source license. See the file LICENSE in the BANDCAMP-DL source distribution for information on terms & conditions for accessing and otherwise using BANDCAMP-DL and for a DISCLAIMER OF ALL WARRANTIES.

BUGS

Submit bug reports online at:

https://github.com/doctorfree/MusicPlayerPlus/issues

SEE ALSO

beet(1), mpplus(1)

Full documentation and sources at:

https://github.com/doctorfree/MusicPlayerPlus

Clone this wiki locally