Bandcamp收藏下载器使用手册

Bandcamp收藏下载器使用手册

bandcamp-collection-downloaderA command-line tool to automatically download all releases purchased with a Bandcamp account. The official page of the project is https://framagit.org/Ezwen/bandcamp-collection-downloader, while here this is just a mirror hosted on Github.项目地址:https://gitcode.com/gh_mirrors/ba/bandcamp-collection-downloader

本手册旨在指导用户了解并使用从GitHub获取的Bandcamp收藏下载器。此工具是一个命令行界面（CLI）应用，用于自动下载Bandcamp账户购买的所有发布。以下是其核心组件和操作指南：

1. 项目目录结构及介绍

项目克隆到本地后的基础目录结构大致如下:

bandcamp-collection-downloader/
│
├── src/main/kotlin           # 主要的Kotlin源代码所在目录
│   └── main.kt               # 应用入口点
├── build.gradle              # Gradle构建脚本
├── settings.gradle           # Gradle设置文件
├── build/libs                # 编译后的可执行jar文件存放目录
│   └── bandcamp-collection-downloader.jar
└── README.md                 # 项目说明文档

• src/main/kotlin 包含所有业务逻辑和应用程序的主要代码。
• build.gradle 和 settings.gradle 是Gradle构建系统的关键配置文件，用于编译和打包项目。
• build/libs 目录在构建后将包含最终的、可直接运行的jar文件。
• README.md 提供基本的使用说明和快速入门指南。

2. 项目的启动文件介绍

启动该应用程序不需要直接编辑或接触特定的“启动文件”。用户通过命令行来运行程序。主要的执行命令如下：

java -jar build/libs/bandcamp-collection-downloader.jar [选项] <bandcampUser>

其中，build/libs/bandcamp-collection-downloader.jar 是关键的可执行文件，而 <bandcampUser> 是用户的Bandcamp用户名。各项选项允许用户定制下载路径、音乐格式、并发任务数等参数，具体可见下文配置部分或项目中的文档。

3. 项目的配置文件介绍

此项目与众不同之处在于它不依赖于外部配置文件进行常规运行。所有的配置均是命令行参数的形式提供。这意味着用户每次执行命令时直接指定所需的参数。例如：

• -d=myMusicFolder: 指定下载目录为myMusicFolder。
• -f=audioFormat: 选择音频格式，如mp3, flac等。
• -c=pathToCookiesFile: 如果需要，可通过此选项指定包含有效Bandcamp凭证cookie的文件路径。

尽管没有传统的配置文件，但通过.gitignore排除的潜在缓存文件或者由程序自动生成的下载状态记录文件，间接地构成了运行环境的一部分。首次下载后，会在下载目录创建一个缓存文件，以跟踪已成功下载的专辑，避免重复下载。

总之，Bandcamp收藏下载器通过简洁的命令行交互提供了高度定制化的下载体验，无需复杂的配置管理。用户只需根据实际需求调整命令参数即可轻松管理和下载其Bandcamp音乐收藏。

bandcamp-collection-downloaderA command-line tool to automatically download all releases purchased with a Bandcamp account. The official page of the project is https://framagit.org/Ezwen/bandcamp-collection-downloader, while here this is just a mirror hosted on Github.项目地址:https://gitcode.com/gh_mirrors/ba/bandcamp-collection-downloader