DZR: the command line deezer.com player
Features
- Cross-platform support: Linux, *BSD, MacOS, Android, Windows+WSL
- Little dependencies:
curl, jq, dialog, openssl (openssl-tool in Android)
- Real-time Lyrics display
- Web interface support (see dzr-tagged frontend)
- ID3v2 tag injector from Deezer metadata (cover, artist, ...)
- Play without storing/caching on your machine for legal reasons
- No private deezer key in the source (auto-extracted from web player, also for legal reasons)
- VSCode extension VSIX experimental port
Preview (CLI)
Preview (VSIX)
Install
| Platform |
command |
version |
| MacOS + brew |
brew install dzr |
 |
| Arch Linux + AUR |
yay -S dzr |
 |
| Gentoo + GURU |
emerge --ask dzr |
 |
| Ubuntu + Snap |
snap install --edge dzr |
Help Me |
| Linux + Flatpak |
flatpak install dzr |
Help Me |
| Nix + Flake |
nix run github.com/yne/dzr |
Help Me |
| 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 |
 |
Usage
# browse api.deezer.com
dzr
# browse a specific api.deezer.com url
dzr /artist/860
# play a specific track
dzr /track/1043317462
# use a custom PLAYER (mpg123 v1.31+ is a lightweight alternative)
PLAYER="mpg123 -" dzr
# inject deezer ID3v2 into MP3 (require eyeD3) and rename it as $ARTIST - $TITLE.mp3
dzr-id3 https://deezer.com/track/1043317462 tagme.mp3
# show track lyrics as srt
dzr-srt https://deezer.com/track/14408104
# play track with it lyrics
PLAYER='dzr-srt $id > .srt ; mpv --sub-file=.srt -' dzr /track/14408104
# play track with it srt (using non-POSIX compliant process substitution)
PLAYER='mpv --sub-file=<(dzr-srt $id) -' dzr /track/14408104
# install dzr into ./cgi-bin/. Then serve it
mkdir -p ./cgi-bin/ && install dzr* ./cgi-bin/
python3 -m http.server --cgi
open http://127.0.0.1:8000/cgi-bin/dzr?6113114