spotdl

点-dl

下载 Spotify 播放列表和歌曲以及专辑封面和元数据

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

SpotDL 是做什么的

1. 从 YouTube 下载音乐 MP3 文件

2. 应用从 Spotify 收集的基本元数据，例如：

• 曲目名称

• 曲目编号

• 专辑

• 专辑封面

• 类型

• 还有更多！

重新设计

SpotDL 正在重新设计！这意味着我们目前不接受新功能请求。如果有任何进一步的问题，您可以在我们的 Discord 上与我们联系。

先决条件

• Python 3.6.1 或更高版本（添加到 PATH）

• FFmpeg 4.2 或更高版本（添加到 PATH）

YouTube Music 必须在您所在的国家/地区可用，spotDL 才能正常运行。这是因为我们使用 YouTube Music 来过滤搜索结果。您可以通过访问 YouTube Music 来检查您所在的国家/地区是否可以使用 YouTube Music。

安装

安装 FFmpeg

• Windows 教程

• OSX- brew install ffmpeg

• Linux - sudo apt install ffmpeg

安装spotDL

• 推荐稳定版本：

   pip 安装spotdl

• 开发版本：（不稳定）

   pip 安装 https://codeload.github.com/spotDL/spotify-downloader/zip/dev

如果您在安装 Spotdl 时遇到问题，请查看此处的扩展安装指南或在我们的 Discord 服务器中寻求帮助

在 Termux 上

卷曲 -L https://raw.githubusercontent.com/spotDL/spotify-downloader/master/termux/setup_spotdl.sh |嘘

拱

SpotDL 有一个 Arch 用户存储库 (AUR) 包。

用法

• 要下载歌曲，请运行

  Spotdl [trackUrl]

  例子：

   Spotdl https://open.spotify.com/track/0VjIjW4GlUZAMYd2vXMi3b

• 要下载专辑，请运行

  Spotdl [专辑网址]

  例子：

   Spotdl https://open.spotify.com/album/4yP0hdKOZPNshxUOjY0cZj

• 要下载播放列表，请运行

  Spotdl [播放列表网址]

  例子：

   Spotdl https://open.spotify.com/playlist/37i9dQZF1E8UXBoz02kGID

• 要下载艺术家运行的所有歌曲

  Spotdl [艺术家网址]

  例子：

   Spotdl https://open.spotify.com/artist/1fZAAHNWdSM5gqbi9o5iEA

• 要搜索并下载歌曲，请运行（带引号）

   Spotdl '[songQuery]'

  例子：

   Spotdl 'The Weeknd - 炫目的灯光'

  注意：这并不准确，并且经常会导致错误。

• 要恢复失败/不完整的下载，请运行

  Spotdl [跟踪文件路径]

  例子：

   Spotdl 'The Weeknd - 致盲灯光.spotdlTrackingFile'

  注意： .spotdlTrackingFile在下载开始时自动创建，并在下载完成后删除

• 您可以通过用空格分隔参数来对多个下载任务进行排队

  Spotdl [songQuery1] [albumUrl] [songQuery2] ...（顺序无关紧要）

  例子：

   Spotdl 'The Weeknd - 致盲灯光' https://open.spotify.com/playlist/37i9dQZF1E8UXBoz02kGID ...

  注意：spotDL 最多并行下载 4 首歌曲，因此为了获得更快的体验，请下载专辑和播放列表，而不是曲目。

• 要从 Spotify 下载带有元数据的 YouTube 视频，请运行：

   Spotdl“YouTubeURL|SpotifyURL”

  例子：

   Spotdl“https://www.youtube.com/watch?v=EO7XnC1YpVo|https://open.spotify.com/track/4fzsfWzRhPawzqhX8Qt9F3”

  注意：URL 必须用|分隔并正确引用前。 “YouTubeURL|SpotifyUrl”

• 要下载具有不同输出格式的歌曲，请运行

  Spotdl [songUrl] --输出格式 mp3/m4a/flac/opus/ogg/wav

  例子：

   Spotdl [songUrl] --输出格式作品

• 使用不在 PATH 运行路径上的 ffmpeg 二进制文件

  Spotdl [songUrl] --ffmpeg 路径/to/your/ffmpeg.exe

  例子：

   Spotdl [songUrl] --ffmpeg C:ffmpegbinffmpeg.exe

• 为每个播放列表运行生成 .m3u 文件

  Spotdl [播放列表网址] --m3u

  例子：

    Spotdl https://open.spotify.com/playlist/37i9dQZF1E8UXBoz02kGID --m3u

• 要使用 YouTube 而不是 YouTube Music 运行

  Spotdl [songUrl] --use-youtube

  例子：

    Spotdl https://open.spotify.com/track/4fzsfWzRhPawzqhX8Qt9F3 --use-youtube

• 更改下载歌曲运行时使用的线程数

  Spotdl [songUrl] --dt [数字]

  例子：

   Spotdl https://open.spotify.com/track/4fzsfWzRhPawzqhX8Qt9F3 --dt 8

• 更改搜索歌曲时使用的线程数运行

  Spotdl [songUrl] --st [数字]

  例子：

   Spotdl https://open.spotify.com/track/4fzsfWzRhPawzqhX8Qt9F3 --st 8

• 忽略您的 ffmpeg 版本运行

  Spotdl [songUrl] --ignore-ffmpeg-版本

pipx隔离环境替代方案

对于不熟悉pipx的用户，可以使用它来运行脚本，而无需使用 pip 全局安装 SpotDL 包和所有依赖项。 （有效地跳过了spotDL安装步骤）

首先，您需要通过运行以下命令来安装pipx ：

 python3 -m pip install --用户 pipx
python3 -m pipx 确保路径

接下来，您可以使用以下命令直接跳转到运行 SpotDL：

 pipx 运行 Spotdl ...