Installing Supysonic on Elementary OS

Supysonic is a modern, easy-to-use web-based music player and streamer. This tutorial will guide you through the installation process of Supysonic on Elementary OS.


Before you begin, make sure that you have the following prerequisites installed on your system:

If any of these tools are not installed on your system, install them using the following commands:

sudo apt-get update
sudo apt-get install python3 python3-pip git

Installing Supysonic

Follow the following steps to properly install Supysonic on your system:

  1. Open up the Terminal by pressing CTRL + ALT + T on your keyboard.

  2. Clone the Supysonic project from Github using the following command:

    git clone
  3. Navigate to the supysonic directory using the following command:

    cd supysonic
  4. Install the required Python packages using the following command:

    pip3 install -r requirements.txt
  5. Run the following command to create a config file:

    cp supysonic.conf.sample supysonic.conf
  6. Open the supysonic.conf file in a text editor using the following command:

    nano supysonic.conf
  7. Edit the following values in the supysonic.conf file:

    • ldap_url : Enter your LDAP server URL (If you do not use LDAP, remove the entire ldap section)

    • bind_address : Enter to bind Supysonic to all available network interfaces

    • media_dir: Enter the absolute path to the directory where your music is stored

    • media_url: Enter a URL that will be used to access your music from the outside (You can use your external IP, your domain name or a subdomain)

    • server_type: Change to cherrypy

    Save the changes and close the file.

  8. Start the Supysonic server by entering the following command:


Now you will be able to access Supysonic from a web browser by visiting http://<your-external-ip>:8000. You can use Supysonic to stream your music from your server to any device with a web browser.

If you want to self-host in an easy, hands free way, need an external IP address, or simply want your data in your own hands, give a try!