Scroll to navigation

SNAPSERVER(1) General Commands Manual SNAPSERVER(1)


snapserver - Snapcast server


snapserver [OPTION]...


Snapcast is a multi-room client-server audio player, where all clients are time synchronized with the server to play perfectly synced audio. It's not a standalone player, but an extension that turns your existing audio player into a Sonos-like multi-room solution.
The server's audio input is a named pipe `/tmp/snapfifo`. All data that is fed into this file will be send to the connected clients. One of the most generic ways to use Snapcast is in conjunction with the music player daemon or Mopidy, which can be configured to use a named pipe as audio output.


-h, --help
Produce help message
-v, --version
Show version number
-p, --port arg (=1704)
Server port
--controlPort arg (=1705)
Remote control port
-s, --stream arg (=pipe:///tmp/snapfifo?name=default)
URI of the PCM input stream. Format: TYPE://host/path?name=NAME [&codec=CODEC] [&sampleformat=SAMPLEFORMAT]
--sampleformat arg (=48000:16:2)
Default sample format
-c, --codec arg (=flac)
Default transport codec (flac|ogg|pcm)[:options] Type codec:? to get codec specific options
--streamBuffer arg (=20)
Default stream read buffer [ms]
-b, --buffer arg (=1000)
Buffer [ms]
Send audio to muted clients
-d, --daemon [=arg(=0)]
Daemonize optional process priority [-20..19]
--user arg
the user[:group] to run snapserver as when daemonized


PCM input fifo file
the daemon default configuration file
~/.config/snapcast/server.json or (if $HOME is not set) /var/lib/snapcast/server.json
persistent server data file


Copyright (C) 2014-2018 Johannes Pohl ( License GPLv3+: GNU GPL version 3 or later <>. This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.


July 2018