dzr's Introduction

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

Recommend Projects