Bandcamp收藏下载器使用手册
本手册旨在指导用户了解并使用从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音乐收藏。