安装
有关更多详细信息,请参阅我们的安装指南。
Python(推荐方法)
- 可以通过运行
pip install spotdl
来安装 spotDL。 - 要更新 spotDL,请运行
pip install --upgrade spotdl
在某些系统上,您可能需要将
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/
中创建。
安装 FFmpeg
spotDL 需要 FFmpeg。如果仅为 spotDL 使用 FFmpeg,您可以简单地将 FFmpeg 安装到 spotDL 的安装目录:
spotdl --download-ffmpeg
我们推荐上述选项,但如果您想在系统范围内安装 FFmpeg,请按照以下说明操作
- Windows 教程
- OSX -
brew install ffmpeg
- Linux -
sudo apt install ffmpeg
或使用您发行版的包管理器
使用方法
不带选项使用 SpotDL:
spotdl [urls]
如果将其作为脚本运行不起作用,您可以将 spotDL 作为包运行:
python -m spotdl [urls]
常规用法:
spotdl [操作] [选项] 查询
spotDL 可以执行不同的操作。默认操作是 download
,它只是从 YouTube 下载歌曲并嵌入元数据。
spotDL 的查询通常是 Spotify URL 列表,但对于某些操作(如同步),只需要一个链接或文件。
要查看所有选项的列表,请使用 spotdl -h
支持的操作
-
save
:仅保存来自 Spotify 的元数据,不下载任何内容。- 用法:
spotdl save [查询] --save-file {文件名}.spotdl
- 用法:
-
web
:启动 Web 界面而不使用命令行。但功能有限,只支持下载单首歌曲。 -
url
:获取查询中每首歌曲的直接下载链接。- 用法:
spotdl url [查询]
- 用法:
-
sync
:更新目录。将目录与播放列表的当前状态进行比较。新添加的歌曲将被下载,删除的歌曲将被删除。不会下载其他歌曲,也不会删除其他文件。-
用法:
spotdl sync [查询] --save-file {文件名}.spotdl
这将创建一个新的同步文件,未来要更新目录,请使用:
spotdl sync {文件名}.spotdl
-
-
meta
:更新提供的歌曲文件的元数据。
音乐来源和音频质量
spotDL 使用 YouTube 作为音乐下载的来源。这种方法用于避免与从 Spotify 下载音乐相关的任何问题。
注意 用户对自己的行为及潜在的法律后果负责。我们不支持未经授权下载受版权保护的材料,也不对用户的行为承担任何责任。
音频质量
spotDL 从 YouTube 下载音乐,并设计为始终下载最高可能的比特率;对普通用户来说是 128 kbps,对 YouTube Music 高级用户来说是 256 kbps。
查看音频格式页面了解更多信息。
贡献
有兴趣贡献吗?查看我们的 CONTRIBUTING.md 以找到有关贡献的资源以及如何设置开发环境的指南。
加入我们出色的社区成为代码贡献者,帮助加速发展
捐赠
帮助支持软件的开发和维护 ❤️
许可证
本项目基于 MIT 许可证授权。