<div align="center">

spotDL v4

spotDL 从 Spotify 播放列表中找到歌曲，并在 YouTube 上下载它们 - 包括专辑封面、歌词和元数据。

贡献者

spotDL：最快、最简单、最准确的命令行音乐下载器。

</div>

安装

有关更多详细信息，请参阅我们的安装指南。

在某些系统上，您可能需要将 pip 更改为 pip3。

预构建可执行文件
- 您可以从发布页面下载最新版本
在 Termux 上
- curl -L https://raw.githubusercontent.com/spotDL/spotify-downloader/master/scripts/termux.sh | sh
Arch
- Arch 用户仓库 (AUR) 中有 spotDL 的软件包。
Docker
- 构建镜像：
```
docker build -t spotdl .
```
- 使用 spotDL 参数启动容器（见下一节）。您需要创建映射卷来访问歌曲文件
```
docker run --rm -v $(pwd):/music spotdl download [trackUrl]
```

从源代码构建

git clone https://github.com/spotDL/spotify-downloader && cd spotify-downloader
pip install poetry
poetry install
poetry run python3 scripts/build.py

可执行文件将在 spotify-downloader/dist/ 中创建。

</details>

spotDL 需要 FFmpeg。如果仅为 spotDL 使用 FFmpeg，您可以简单地将 FFmpeg 安装到 spotDL 的安装目录： spotdl --download-ffmpeg

我们推荐上述选项，但如果您想在系统范围内安装 FFmpeg，请按照以下说明操作

不带选项使用 SpotDL：

spotdl [urls]

如果将其作为脚本运行不起作用，您可以将 spotDL 作为包运行：

python -m spotdl [urls]

常规用法：

spotdl [操作] [选项] 查询

spotDL 可以执行不同的操作。默认操作是 download，它只是从 YouTube 下载歌曲并嵌入元数据。

spotDL 的查询通常是 Spotify URL 列表，但对于某些操作（如同步），只需要一个链接或文件。要查看所有选项的列表，请使用 spotdl -h

<details> <summary style="font-size:1em"><strong>支持的操作</strong></summary>

save：仅保存来自 Spotify 的元数据，不下载任何内容。
- 用法： spotdl save [查询] --save-file {文件名}.spotdl
web：启动 Web 界面而不使用命令行。但功能有限，只支持下载单首歌曲。
url：获取查询中每首歌曲的直接下载链接。
- 用法： spotdl url [查询]
sync：更新目录。将目录与播放列表的当前状态进行比较。新添加的歌曲将被下载，删除的歌曲将被删除。不会下载其他歌曲，也不会删除其他文件。
- 用法： spotdl sync [查询] --save-file {文件名}.spotdl
  
  这将创建一个新的同步文件，未来要更新目录，请使用：
  
  spotdl sync {文件名}.spotdl
meta：更新提供的歌曲文件的元数据。