如何高效下载你的 Bandcamp 音乐收藏：bandcamp-downloader 完整使用教程

如何高效下载你的 Bandcamp 音乐收藏bandcamp-downloader 完整使用教程【免费下载链接】bandcamp-downloaderDownload your bandcamp collection using this python script.项目地址: https://gitcode.com/gh_mirrors/ba/bandcamp-downloaderbandcamp-downloader 是一款 Python 命令行下载工具帮你把在 Bandcamp 购买的全部音乐收藏批量下载到本地按艺术家自动归类支持 FLAC 等无损格式还能按购买时间筛选一次把整个收藏搬回家。先说清楚它适合什么样的你买了很多但文件散在各处你在 Bandcamp 上攒了几年收藏想离线听、想换无损格式、想备份——手动一首首下载不现实。这个工具做的事很简单读取你浏览器里已登录的 Bandcamp 会话把整个收藏列表拉下来按「艺术家名」建目录专辑存成 zip 包单曲直接存音频文件。一条命令整库搬家你只需要告诉它两件事你的 Bandcamp 用户名、用哪个浏览器的 Cookie 登录。剩下的下载、归类、去重、重试全部自动完成还支持多线程并发几百首歌曲也能从容处理。3 分钟跑起来克隆、安装、第一次运行克隆仓库并安装git clone https://gitcode.com/gh_mirrors/ba/bandcamp-downloader cd bandcamp-downloader pip install .如果依赖安装遇到问题可以改用固定版本pip install -r requirements.txt。习惯 Poetry 的话poetry install之后用poetry run python bandcamp-downloader.py [参数]运行即可。先登录再跑脚本脚本靠浏览器 Cookie 完成认证所以运行前请确保你在浏览器里已经登录 Bandcamp。默认读取 Firefox 的 Cookie其他浏览器用--browser指定支持 Chrome、Chromium、Firefox、Brave、Opera、Edge。然后第一次运行长这样python bandcamp-downloader.py 你的bandcamp用户名 --directory ~/Music/bandcamp--directory决定文件落在哪里不指定就存在当前目录。下载过程长什么样文件如何归类专辑打包成 zip单曲直接落地专辑会以 zip 压缩包的形式保存在「艺术家名」目录里单曲则直接是音频文件。所有文件自动按艺术家整理不需要你手动建文件夹。重复文件自动跳过--force 强制覆盖脚本会对比已存在文件的大小和预期大小一致就跳过不一致就覆盖。所以中断后重跑不会白白重复下载。想无条件全部重新下载时加上--force。想直接听歌让 --extract 自动解压加--extract参数下载完的 zip 会被解压到{艺术家}/{专辑}子目录然后删除原始压缩包目录结构直接就能进音乐播放器。进阶玩法按购买时间筛选、换无损格式按购买时间圈定范围--download-since和--download-until接受YYYY-MM-DD日期分别表示只下载该日期当天及之后、该日期之前购买的条目。比如只搬最近一年的新入收藏python bandcamp-downloader.py 你的用户名 --download-since 2025-01-01挑选你喜欢的音频格式--format决定音质默认mp3-320可选项包括flac、wav、aac-hi、aiff-lossless、alac、mp3-v0、vorbis。想要无损存档就选flac。注意如果你要同时下载多种格式务必为每种格式指定不同的--directory因为脚本无法区分同名 zip 是否同一格式会直接覆盖。顺便说说文件名规则--filename-format自定义曲目文件名默认{artist}/{artist} - {title}可用占位符有item_id、artist、title三个喜欢自己组织方式的可以按需拼。另外默认只下载未隐藏条目想连标记为隐藏的收藏一起拿加--include-hidden。效率调优并行、重试与干跑并行线程默认 5按需增减下载默认用 5 个线程并行--parallel-downloads或-p可调整范围 1 到 32设为 1 即关闭并行。每完成一个下载线程会默认等 1 秒再取下一个避免把 Bandcamp 服务器打爆这个间隔用--wait-after-download控制。失败自动重试节奏可以自己定遇到网络错误不会立刻放弃每个文件默认最多尝试 5 次--max-download-attempts调整每次失败后等待 5 秒再试--retry-wait调整。网络不稳时把这两项调大一点更稳。先 --dry-run 看看会发生什么大动作之前先用--dry-run跑一遍不真正下载只解析网页数据并告诉你「将会做什么」。确认清单无误后再正式执行。想跑完看整体状况加--summary会在结束时汇总每一项的状态排查问题时可以加-v输出更详细的日志。常见坑与排查提示找不到 Cookie如果脚本说找不到浏览器 Cookie常见原因是浏览器以 Flatpak 或 Snap 安装Cookie 文件不在默认位置。最简单的办法是用--cookies直接指向 Cookie 存储文件通常叫Cookies或cookies.sqlite注意--browser仍需配对。也可以把浏览器目录软链到脚本预期的位置。另外你还可以提供 Netscape 格式的 Cookie 文件给--cookies完全不依赖浏览器。WSL 下的 DBUS 报错WSL 里运行可能报DBUS_SESSION_BUS_ADDRESS相关错误这是 WSL 的 dbus 环境不完整导致的。要么修复 WSL 的 dbus 配置要么直接在 Windows 原生环境运行脚本。Chrome 的密钥解密报错Chrome 下偶发 Unable to get key for cookie decryption 错误这是底层 Cookie 读取库的已知问题换 Firefox 等其他浏览器运行通常能绕过。核心源码见 bandcamp-downloader.py更多说明见 README.md。工具本身免费开源把收藏搬回家的这件事从今天一条命令开始就够了。【免费下载链接】bandcamp-downloaderDownload your bandcamp collection using this python script.项目地址: https://gitcode.com/gh_mirrors/ba/bandcamp-downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考