# bandripper
Rip albums from bandcamp using the command line.<br>
Only works for public tracks.<br>
Quality is limited to mp3 at 128 kbps.
## Installation
Install with:
<pre>
pip install bandripper
</pre>
## Usage
##### Options
<pre>
>bandripper -h
usage: bandripper [-h] [-n] [-o] [urls ...]
positional arguments:
urls 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.
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.
-o, --overwrite Pass this flag to overwrite existing files. Otherwise don't download tracks that already exist locally.
</pre>
e.g.
<pre>
>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
</pre>
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/b1/75/a59e915d20aae7310b00d98c0cc92f143b4e73a7741f41c4bc6a349b4afd/bandripper-0.2.0.tar.gz",
"platform": null,
"description": "# bandripper\n\nRip albums from bandcamp using the command line.<br>\nOnly works for public tracks.<br>\nQuality is limited to mp3 at 128 kbps.\n\n## Installation\n\nInstall with:\n\n<pre>\npip install bandripper\n</pre>\n\n\n\n## Usage\n\n##### Options\n<pre>\n>bandripper -h\nusage: bandripper [-h] [-n] [-o] [urls ...]\n\npositional arguments:\n urls 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.\n Multiple urls can be passed.\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. Pass this switch to disable the behavior.\n -o, --overwrite Pass this flag to overwrite existing files. Otherwise don't download tracks that already exist locally.\n</pre>\ne.g.\n<pre>\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</pre>\n",
"bugtrack_url": null,
"license": null,
"summary": "Rip mp3s from bandcamp.",
"version": "0.2.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": "e761f54b3dc9d137fa98a9fb34a170ab39d90f55ff82b9a5a81c08853c83fdb0",
"md5": "d8fc6771bfcd065f70d0a8487e5f2e7c",
"sha256": "3b1d5c410b31086d3b5169273f378ef2e90fc516e2083751bab8cb7c20dc248d"
},
"downloads": -1,
"filename": "bandripper-0.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d8fc6771bfcd065f70d0a8487e5f2e7c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.12,>=3.10",
"size": 7408,
"upload_time": "2024-03-20T20:35:34",
"upload_time_iso_8601": "2024-03-20T20:35:34.739939Z",
"url": "https://files.pythonhosted.org/packages/e7/61/f54b3dc9d137fa98a9fb34a170ab39d90f55ff82b9a5a81c08853c83fdb0/bandripper-0.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "b175a59e915d20aae7310b00d98c0cc92f143b4e73a7741f41c4bc6a349b4afd",
"md5": "352ef1774063781067ebd8c307cc19a1",
"sha256": "03fa67a94e1886e66b23d68f81a65cb01d37bd439aefce3dccb0d6fda299d0f4"
},
"downloads": -1,
"filename": "bandripper-0.2.0.tar.gz",
"has_sig": false,
"md5_digest": "352ef1774063781067ebd8c307cc19a1",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.12,>=3.10",
"size": 6243,
"upload_time": "2024-03-20T20:35:36",
"upload_time_iso_8601": "2024-03-20T20:35:36.217846Z",
"url": "https://files.pythonhosted.org/packages/b1/75/a59e915d20aae7310b00d98c0cc92f143b4e73a7741f41c4bc6a349b4afd/bandripper-0.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-20 20:35:36",
"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"
}