CLI : command line client

Volumio has a command line client which can be invoked with the command


By invoking it, you'll see the help output with a list of the available commands:

Usage : volumio <argument1> <argument2>


status                             Gives Playback status information
volume                             Gives Current Volume Information
volume <desired volume>            Sets Volume at desired level 0-100
volume mute                        Mutes
volume unmute                      Unmutes
volume plus                        Increases Volume of one step
volume minus                       Decreases Volume of one step
volume toggle                      Toggles between mute and unmute
seek plus                          Forwards 10 seconds in the song
seek minus                         Backwards 10 seconds in the song
seek <seconds>                     Plays song from selected time
repeat                             Toggles repetition of queue
random                             Toggles randomization of queue


play                               Play
pause                              Pause
next                               Next track
previous                           Previous track
stop                               Stop
clear                              Clear current queue
toggle                             Toggles between play and pause


vstart                             Starts Volumio Service
vstop                              Stops Volumio Service
vrestart                           Restarts Volumio Service


pull                               Pulls latest github status on master from
pull -b <branch>                   Pulls branch <branch> from
pull -b <branch> <repository>      Pulls branch <branch> from git repository <repository>
dev                                Start Volumio in develpment mode, with Nodemon and Remote Debugger
kernelsource                       Gets Current Kernel source (Raspberry PI only)
plugin init                        Creates a new plugin
plugin refresh                     updates plugin in the system
plugin package                     compresses the plugin
plugin publish                     publishes the plugin on git
plugin install                     installs the plugin locally
plugin update                      updates the plugin
logdump <description>              dump logs to $LOGDUMP instead of uploading


updater forceupdate                Updates to latest version
updater factory                    Restores factory version and wipes all user data
updater userdata                   Wipes all user data
updater testmode                   Enables or disables Test mode, allowing to receive beta builds
updater cleanupdate                Updates to latest version and cleans user data, allowing a start like a newly flashed image
updater restorevolumio             Delete all manually edited files from /volumio folder, restoring a pristine volumio core system

Command Line Client Development

The command line client is located at


While some dynamic commands (like volume controls) are located at