Zotify开源项目最佳实践教程

1. 项目介绍

Zotify是一个基于Librespot的音乐和播客下载器。本项目是Zotify官方dev分支的一个活跃分叉，旨在添加缺失的未实现功能，并保持更新，直到原开发者恢复维护。Zotify支持高至320kbps的音轨保存，多种音频格式输出，内嵌搜索功能，批量下载，同步歌词和嵌入式元数据等功能。

2. 项目快速启动

环境要求

• Python 3.11 或更高版本
• FFmpeg（非必需，但用于保存非Ogg Vorbis格式的音轨）

安装步骤

Windows

1. 使用PowerShell安装Scoop：

   Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
   irm get.scoop.sh | iex
   

2. 通过Scoop安装依赖：

   scoop install python ffmpeg-shared git
   

3. 安装pipx：

   python3 -m pip install --user pipx
   python3 -m pipx ensurepath
   

4. 安装Zotify：

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

   或者

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

macOS

1. 打开Terminal，安装Homebrew：

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
   

2. 通过Homebrew安装依赖：

   brew install python@3.11 pipx ffmpeg git
   

3. 设置pipx：

   pipx ensurepath
   

4. 安装Zotify：

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

   或者

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

Linux

1. 从软件包管理器安装python3、pip（如为独立包）、ffmpeg和git。
2. 安装pipx：

   python3 -m pip install --user pipx
   

3. 安装Zotify：

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

   或者

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

3. 应用案例和最佳实践

基础用法

下载指定的曲目、专辑、播放列表、播客集或艺术家：

zotify <items to download>

常用选项

• -p, --playlist：下载用户的保存播放列表
• -lt, --liked-tracks：下载用户喜欢的曲目
• -le, --liked-episodes：下载用户喜欢的播客集
• -f, --followed：下载用户关注的艺术家
• -s, --search <search>：搜索下载项

配置选项

Zotify提供了多种配置选项，如：

• --credentials：指定凭证文件路径
• --music-library：指定音乐库根目录
• --output-album：设置保存专辑的文件布局

更多配置选项，请参考项目官方文档。

4. 典型生态项目

Zotify作为音乐和播客下载器，可以与其他开源项目配合使用，例如：

• 与音乐播放器如VLC或Audacity集成，实现下载后自动播放。
• 结合自动化工具如Make或Automator，创建自动化的音乐下载和整理流程。

通过以上最佳实践，您可以更高效地使用Zotify项目，并融入您的个人工作流中。