https://github.com/7x11x13/free-bandcamp-downloader
Get free/name your price music from Bandcamp in lossless quality
https://github.com/7x11x13/free-bandcamp-downloader
Last synced: about 1 month ago
JSON representation
Get free/name your price music from Bandcamp in lossless quality
- Host: GitHub
- URL: https://github.com/7x11x13/free-bandcamp-downloader
- Owner: 7x11x13
- Created: 2021-04-27T18:36:31.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2025-03-21T18:13:39.000Z (2 months ago)
- Last Synced: 2025-03-30T11:33:22.053Z (2 months ago)
- Language: Python
- Homepage: https://pypi.org/project/free-bandcamp-downloader/
- Size: 72.3 KB
- Stars: 27
- Watchers: 3
- Forks: 5
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# free-bandcamp-downloader
Download free and $0 minimum name-your-price albums and tracks from Bandcamp (including ones that are sent to email),
and tag them with data from the Bandcamp page. Also able to download items in your collection, if login cookies are
supplied using the `--cookies` or `--identity` argument.
## Installation
With pip:
```
$ pip install free-bandcamp-downloader
$ bcdl-free
```
With [uv](https://docs.astral.sh/uv/getting-started/installation/):
```
$ uvx --from free-bandcamp-downloader bcdl-free
```
## Note on passing cookies
Only one cookie is needed to login, which has the name "identity". You can pass this cookie to `bcdl-free` using the
`--cookies` argument which you must supply a path to a Netscape cookies.txt formatted file, or using the `--identity`
argument which you must supply the value of your "identity" cookie.
## Usage
```
Usage:
bcdl-free setdefault [-d ] [-e ] [-z ]
[-c ] [-f ]
bcdl-free defaults
bcdl-free clear
bcdl-free -h | --help | --version
bcdl-free [--debug] [--force] [--no-unzip] [-al]
[-d ] [-e ] [-z ] [-c ] [-f ]
[--cookies ] [--identity ] [--download-history-file ]
URL...
Arguments:
URL URL to download. Can be a link to a label or release page
Subcommands:
setdefaults set default configuration options
defaults list default configuration options
clear clear default configuration options
Options:
-h --help Show this screen
--version Show version
--force Download even if album has been downloaded before
--no-unzip Don't unzip downloaded albums
--debug Set loglevel to debug
-a -l Dummy options, for backwards compatibility
-d --dir Set download directory
-c --country Set country
-z --zipcode Set zipcode
-e --email Set email (set to 'auto' to automatically download from a disposable email)
-f --format Set format
--cookies Path to cookies.txt file so albums in your collection can be downloaded
--identity Value of identity cookie so albums in your collection can be downloaded
--download-history-file Path to history file containing downloaded albums
Formats:
- FLAC
- V0MP3
- 320MP3
- AAC
- Ogg
- ALAC
- WAV
- AIFF
```