Skip to content

Onzr

The one-hour-late Deezer 💜 CLI.

⚠️ This project is a work in progress. It works in its core parts, but will not meet standard requirements for a decent player.

Requirements

  • Python: 3.11+
  • VLC: we use VLC bindings to play tracks, so this is a strict requirement.

Quick start guide

Onzr is a python package, it can be installed using Pip (or any other package manager you may use):

pip install --user onzr

Once installed the onzr command should be available (if not check your PATH definition). Before using Onzr, you should configure it (once for all):

onzr init

This command will prompt for an ARL token. If you don't know how to find it, please follow this guide.

You may now explore commands and their usage:

onzr --help

Onzr is based on an HTTP client/server architecture, hence, once installed, you should run the server before starting to use it:

onzr serve --log-level error &

In this case, the server is ran as a background job; see the serve command documentation for details about running Onzr server.

Play your first album:

onzr search --artist "Billie Eilish" --ids | \ head -n 1 | \ onzr artist --albums --ids - | \ head -n 1 | \ onzr album --ids - | \ onzr add - && \ onzr play
➕ adding tracks to queue…
Added 10 tracks to queue

🎉 In this command, we look for the latest Billie Eilish album, add it to the queue and play it instantly!

Documentation

The complete documentation of the project is available at: https://jmaupetit.github.io/onzr/

License

This work is released under the MIT License.