# bandripper
Download albums from bandcamp using the command line.
Only works for public tracks.
Quality is limited to mp3 at 128 kbps.
## Installation
Install with:
```console
pip install bandripper
```
## Usage
##### Options
```console
> bandripper -h
Usage: bandripper [-h] [-n] [-o] [-nr] [str ...]
Positional Arguments:
str The bandcamp url(s) for the album or artist. If the url is to an artists
main page, all albums will be downloaded. The tracks will be saved to a
subdirectory of your current directory. If a track can't be streamed (i.e.
private) it won't be downloaded. Multiple urls can be passed. (default: None)
Options:
-h, --help show this help message and exit
-n, --no_track_number
By default the track number will be added to the front of the track title.
Pass this switch to disable the behavior. (default: False)
-o, --overwrite Pass this flag to overwrite existing files. Otherwise tracks that already
exist locally will not be downloaded. (default: False)
-nr, --new_releases Check urls in `discography_urls.txt` for new releases and download them. A
discography url is automatically added to the file when bandripper is used
on it. (default: False)
```
e.g.
```console
>bandripper https://blacklungwinter.bandcamp.com/releases
Downloading 5 tracks from Bodies of EarthHearts of Space by Blacklung Winter... ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 100.00% 0s
>dir "./Blacklung Winter/Bodies of EarthHearts of Space"
03/22/2023 01:46 PM 228,335 Bodies of EarthHearts of Space.jpg
03/22/2023 01:46 PM 3,008,887 01 - Bodies of EarthHearts of Space.mp3
03/22/2023 01:46 PM 3,441,057 02 - Dead in the Water.mp3
03/22/2023 01:46 PM 2,792,802 03 - Yin and Yang.mp3
03/22/2023 01:46 PM 3,326,954 04 - Neurotoxin.mp3
03/22/2023 01:46 PM 3,836,446 05 - Uproot.mp3
```
Raw data
{
"_id": null,
"home_page": null,
"name": "bandripper",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.12,>=3.10",
"maintainer_email": null,
"keywords": "audio, bandcamp, download, downloader, music",
"author": null,
"author_email": "Matt Manes <mattmanes@pm.me>",
"download_url": "https://files.pythonhosted.org/packages/86/07/43b92c4ba4ba47c434e25bfe496236a4953fe76bcc4b242bf6a6e5325687/bandripper-0.3.0.tar.gz",
"platform": null,
"description": "# bandripper\n\nDownload albums from bandcamp using the command line. \nOnly works for public tracks. \nQuality is limited to mp3 at 128 kbps.\n\n## Installation\n\nInstall with:\n\n```console\npip install bandripper\n```\n\n## Usage\n\n##### Options\n\n```console\n> bandripper -h\nUsage: bandripper [-h] [-n] [-o] [-nr] [str ...]\n\nPositional Arguments:\n str The bandcamp url(s) for the album or artist. If the url is to an artists\n main page, all albums will be downloaded. The tracks will be saved to a\n subdirectory of your current directory. If a track can't be streamed (i.e.\n private) it won't be downloaded. Multiple urls can be passed. (default: None)\n\nOptions:\n -h, --help show this help message and exit\n -n, --no_track_number\n By default the track number will be added to the front of the track title.\n Pass this switch to disable the behavior. (default: False)\n -o, --overwrite Pass this flag to overwrite existing files. Otherwise tracks that already\n exist locally will not be downloaded. (default: False)\n -nr, --new_releases Check urls in `discography_urls.txt` for new releases and download them. A\n discography url is automatically added to the file when bandripper is used\n on it. (default: False)\n```\n\ne.g.\n\n```console\n>bandripper https://blacklungwinter.bandcamp.com/releases\nDownloading 5 tracks from Bodies of EarthHearts of Space by Blacklung Winter... \u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501 100.00% 0s\n>dir \"./Blacklung Winter/Bodies of EarthHearts of Space\"\n03/22/2023 01:46 PM 228,335 Bodies of EarthHearts of Space.jpg\n03/22/2023 01:46 PM 3,008,887 01 - Bodies of EarthHearts of Space.mp3\n03/22/2023 01:46 PM 3,441,057 02 - Dead in the Water.mp3\n03/22/2023 01:46 PM 2,792,802 03 - Yin and Yang.mp3\n03/22/2023 01:46 PM 3,326,954 04 - Neurotoxin.mp3\n03/22/2023 01:46 PM 3,836,446 05 - Uproot.mp3\n```\n",
"bugtrack_url": null,
"license": null,
"summary": "Rip mp3s from bandcamp.",
"version": "0.3.0",
"project_urls": {
"Documentation": "https://github.com/matt-manes/bandripper/tree/main/docs",
"Homepage": "https://github.com/matt-manes/bandripper",
"Source code": "https://github.com/matt-manes/bandripper/tree/main/src/bandripper"
},
"split_keywords": [
"audio",
" bandcamp",
" download",
" downloader",
" music"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "576ad5bbc8100ca401f78d0861cba0fac4635e07e5417f04aa1b8a03f58ac5fe",
"md5": "738261945814bb5300029ea97e12bc14",
"sha256": "e578381b583244383d3e5e1269ba29c1f5d5652f14cff5a3ad2cc10733ccf70a"
},
"downloads": -1,
"filename": "bandripper-0.3.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "738261945814bb5300029ea97e12bc14",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.12,>=3.10",
"size": 8343,
"upload_time": "2024-10-06T19:37:33",
"upload_time_iso_8601": "2024-10-06T19:37:33.805594Z",
"url": "https://files.pythonhosted.org/packages/57/6a/d5bbc8100ca401f78d0861cba0fac4635e07e5417f04aa1b8a03f58ac5fe/bandripper-0.3.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "860743b92c4ba4ba47c434e25bfe496236a4953fe76bcc4b242bf6a6e5325687",
"md5": "d477b348b879308567c1689064dacd44",
"sha256": "1dc204b0417699c199c23141cd88eea7432b2408cc1d251fee2e267914a77803"
},
"downloads": -1,
"filename": "bandripper-0.3.0.tar.gz",
"has_sig": false,
"md5_digest": "d477b348b879308567c1689064dacd44",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.12,>=3.10",
"size": 7170,
"upload_time": "2024-10-06T19:37:34",
"upload_time_iso_8601": "2024-10-06T19:37:34.898376Z",
"url": "https://files.pythonhosted.org/packages/86/07/43b92c4ba4ba47c434e25bfe496236a4953fe76bcc4b242bf6a6e5325687/bandripper-0.3.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-06 19:37:34",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "matt-manes",
"github_project": "bandripper",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "bandripper"
}
JSON
