Jukebox mode¶
The jukebox mode allow playing audio files on the hardware of the machine running Supysonic, using regular clients that support it as a remote control.
The daemon must be running in order to be able to use the jukebox mode. So be sure to start the supysonic-daemon command and keep it running.
Setting the player program¶
Jukebox mode in Supysonic works through the use of third-party command-line programs. Supysonic isn’t bundled with such programs, and you are left to choose which one you want to use. The chosen program should be able to play a single audio file from a path specified on its command-line.
The configuration is done in the [daemon] section of the configuration file,
with the jukebox_command
variable. This variable should include the
following fields:
%path
absolute path of the file to be played
%offset
time in seconds where to start playing (used for seeking)
Here’s an example using mplayer
:
jukebox_command = mplayer -ss %offset %path
Or using mpv
:
jukebox_command = mpv --start=%offset %path
Setting the output volume isn’t currently supported.
Allowing users to act on the jukebox¶
The jukebox mode is only accessible to chosen users. Granting (or revoking) jukebox usage rights to a specific user is done with the command line interface:
$ supysonic-cli user setroles --jukebox <username>