开源项目 dzr 使用教程

开源项目 dzr 使用教程

dzr Accountless deezer.com Player (CLI & VSCode) 项目地址: https://gitcode.com/gh_mirrors/dz/dzr

1. 项目介绍

dzr 是一个命令行 Deezer.com 播放器，它支持跨平台使用，包括 Linux、*BSD、MacOS、Android、Windows+WSL。该项目依赖较少，主要需要 curl、jq、dialog 和 openssl（在 Android 中为 openssl-tool）。dzr 提供实时歌词显示、Web 界面支持，并能从 Deezer 元数据中注入 ID3v2 标签（如封面、艺术家等）。该项目遵守法律要求，不会在您的机器上存储或缓存音乐，也不会在源代码中包含 Deezer 的私钥。

2. 项目快速启动

首先，您需要根据您的操作系统安装 dzr。以下是一些常见平台的安装命令：

• MacOS: brew install dzr
• Arch Linux: yay -S dzr
• Gentoo: emerge --ask dzr
• Ubuntu: snap install --edge dzr
• Linux (Flatpak): flatpak install dzr
• Nix: nix run github.com/yne/dzr
• Android (Termux): curl -sL github.com/yne/dzr/archive/master.tar.gz | tar xzf - 然后 mv dzr-master/dzr* $PREFIX/bin
• VSCode: code --install-extension ./path/to/dzr-*.vsix

安装完成后，您可以开始使用 dzr。以下是一些基本的使用示例：

• 浏览 api.deezer.com: dzr
• 播放特定曲目: dzr /track/1043317462
• 使用自定义播放器（例如 mpg123 v1.31+）: PLAYER="mpg123 -" dzr
• 将 Deezer ID3v2 标签注入 MP3 并重命名: dzr-id3 https://deezer.com/track/1043317462 tagme.mp3
• 显示曲目歌词: dzr-srt https://deezer.com/track/14408104
• 播放曲目并显示歌词: PLAYER='dzr-srt $id > .srt ; mpv --sub-file=.srt -' dzr /track/14408104

3. 应用案例和最佳实践

• 使用 dzr 作为 Web 服务: 您可以将 dzr 安装到 cgi-bin 目录，然后使用 Python 的 http.server 模块来提供 Web 服务。具体步骤如下：

  mkdir -p ./cgi-bin/
  && install dzr * ./cgi-bin/
  python3 -m http.server --cgi
  open http://127.0.0.1:8000/cgi-bin/dzr
  

• 将 dzr 集成到其他音乐应用中: 您可以使用 dzr 的命令行接口，将其集成到其他音乐播放器或自动化脚本中。

4. 典型生态项目

dzr 社区中还有一些相关的项目，例如：

• dzr-frontend: dzr 的 Web 界面版本，为用户提供了一个图形用户界面。
• dzr-extension: 用于集成到 VSCode 编辑器的扩展，提供了更加丰富的使用体验。

通过上述介绍和教程，您可以开始使用 dzr 享受音乐，并探索更多的可能性。

dzr Accountless deezer.com Player (CLI & VSCode) 项目地址: https://gitcode.com/gh_mirrors/dz/dzr