Zotify 项目启动与配置教程

1. 项目目录结构及介绍

Zotify 项目目录结构如下：

• assets/：包含项目所需的各种资源文件。
• .gitignore：指定 Git 忽略的文件和目录。
• CHANGELOG.md：记录项目的更新历史。
• LICENCE：项目的许可协议文件。
• Pipfile：Python 的依赖管理文件，用于定义项目依赖。
• Pipfile.lock：Pipfile 的锁定文件，确保依赖的一致性。
• README.md：项目说明文件。
• pyproject.toml：Python 项目配置文件。
• requirements.txt：项目的 Python 依赖列表。
• requirements_dev.txt：项目的开发环境依赖列表。
• setup.cfg：项目设置配置文件。
• zotify/：项目的核心代码目录。

2. 项目的启动文件介绍

项目的启动主要依赖于 zotify 目录中的 Python 脚本。通常情况下，可以通过以下命令安装并启动项目：

python -m pip install git+https://github.com/DraftKinner/zotify.git@v1.0.1

或者使用 pipx 工具：

pipx install git+https://github.com/DraftKinner/zotify.git@v1.0.1

启动文件位于 zotify/ 目录中，主要包含以下部分：

• main.py：项目的入口文件，负责初始化和运行程序。
• commands.py：包含项目支持的命令和参数处理逻辑。
• config.py：项目的配置处理逻辑。
• downloader.py：下载音乐和播客的核心逻辑。

3. 项目的配置文件介绍

项目的配置主要通过 config.py 文件进行。以下是配置文件的一些主要配置项：

• path_credentials：指定登录凭据文件的路径。
• music_library：指定音乐库的根目录。
• podcast_library：指定播客库的根目录。
• mixed_playlist_library：指定混合内容播放列表库的根目录。
• output_album：设置保存专辑的文件布局。
• output_playlist_track：设置保存播放列表中的音轨的文件布局。
• output_playlist_episode：设置保存播放列表中的播客集的文件布局。
• output_podcast：设置保存播客的文件布局。
• download_quality：设置音频下载质量。
• download_real_time：设置是否以实时速度下载歌曲。
• audio_format：设置最终音轨输出的音频格式。
• transcode_bitrate：设置转码比特率。
• ffmpeg_path：设置 ffmpeg 可执行文件的路径。
• ffmpeg_args：设置额外的 ffmpeg 转码参数。
• save_credentials：设置是否保存登录凭据到文件。
• replace_existing：设置是否重新下载并替换已存在的歌曲。
• skip_previous：设置是否跳过播放列表中之前已下载的歌曲。
• skip_duplicates：设置是否跳过重复下载到不同专辑的音轨。
• save_genre：设置是否将流派添加到元数据。

通过编辑 config.py 文件，可以根据自己的需求调整上述配置项，以达到个性化的项目配置。