Skip to main content

webinterface to control a snapcast server

Project description



Snapcastr is a webinterface to control a snapcast server.

It is written in python with flask, wtforms and python-snapcast

install from source or from pypi

install from source


use your package manager, e.g. apt or pacman and install

  • python3
  • poetry

get source

$ git clone

install locally

$ cd snapcastr
$ poetry install

install system-wide

$ cd snapcastr
$ poetry build
$ sudo pip3 install dist/snapcastr-0.1.0.tar.gz

install from pypi

install locally

$ pip install snapcastr

install system-wide

$ sudo pip install snapcastr


show help

$ snapcastrd -h

usage: snapcastrd [-h] [--host host] [--port port] [--sc_host sc_host] [-c CONFIG] [-d]


optional arguments:
  -h, --help            show this help message and exit
  --host host           webinterface host
  --port port, -p port  webinterface port
  --sc_host sc_host, -s sc_host
                        snapcast host
  -c CONFIG, --config CONFIG
                        config file
  -d, --debug           debug mode

run the application

  • when installed locally
$ cd snapcastr
$ poetry run snapcastrd --sc_host=address_of_your_snapserver
  • when installed system-wide
$ snapcastrd --sc_host=address_of_your_snapserver

The address_of_your_snapserver might be or localhost, if you are running snapcastr on the same machine as your snapserver. Snapcastr doesn't need to run with super user privileges (so you don't need to run it with sudo).


The last used configuration is saved in $HOME/.config/snapcastr.json and can also be edited.

access webinterface

When the application is running, open http://localhost:5000 in your browser.


main screen

  • View general status, number of clients, streams, groups of clients main


  • View connected clients and change their volume clients


  • View the groups and the stream being played by each group groups


  • View the status of the various streams available streams

roadmap, in no particular order


  • rename
  • remove old


  • rename
  • remove
  • add


  • rename

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

snapcastr-0.2.1.tar.gz (12.3 kB view hashes)

Uploaded source

Built Distribution

snapcastr-0.2.1-py3-none-any.whl (12.6 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page