GET STARTED

Choose your setup.

Latest stable release v0.33.0 ↗·Guides match this release.

Native installation

Linux · macOS · Windows

PRIMARY METHOD

Run directly on your machine with the launcher and full access to configuration. Requires Python 3.10+, Git, FFmpeg and Node.js 22+.

Installation guide →Server deployment

Quick commands by operating system


                      sudo apt install -y git ffmpeg python3 python3-venv python3-pip nodejs npm

git clone --branch v0.33.0 --single-branch https://github.com/Arzuparreta/soundsible.git
cd soundsible

cd ui_web && npm ci && cd ..

python3 run.py


                      brew install git ffmpeg python node

git clone --branch v0.33.0 --single-branch https://github.com/Arzuparreta/soundsible.git
cd soundsible

cd ui_web && npm ci && cd ..

python3 run.py


                      winget install Git.Git Python.Python.3.12 Gyan.FFmpeg OpenJS.NodeJS.LTS

git clone --branch v0.33.0 --single-branch https://github.com/Arzuparreta/soundsible.git
cd soundsible

cd ui_web; npm ci; cd ..

python run.py

Commands select the documented release. Linux commands use Debian/Ubuntu packages; verify Node.js is 22 or newer. macOS requires Homebrew. On Windows, reopen PowerShell after installing prerequisites.

First launch: complete setup at localhost:5099/setup, then launch the engine. Keep the terminal open while listening.

Desktop app

Windows

BETA

One Windows installer runs a server on this PC and its player, with no terminal required. Check the release assets for the installer that matches your processor. On Linux, run the server natively or with Docker and open the player in your browser.

Download from GitHub ↗Read the beta guide

Android

ALPHA

Connect to your Soundsible server with native audio, DJ, Live, Android Auto and explicit offline copies.

Download Android APK ↗ Installation and release notes ↗ SHA256SUMS ↗

Allow installation from your browser, then install over an earlier alpha to keep your data. Updates are manual. Technical minimum: API 24 / WebView 120; automated evidence: API 36. Physical Bluetooth and car acceptance is pending for beta.

Docker

Linux amd64 · arm64

Run a containerized server on a NAS, Raspberry Pi or Linux host. The image includes the player and audio dependencies. Read the deployment guide for persistent storage, backups and upgrades.

Docker deployment guide →

Install the published release

Requires Docker with Compose. Creates a new soundsible folder and stores the release tag in .env. If that folder already exists, the commands stop without replacing it.

mkdir soundsible && cd soundsible &&
curl --fail --location https://raw.githubusercontent.com/Arzuparreta/soundsible/cd443d6ff92f5763447bb0a5b031862bcd77d9cb/compose.yaml -o compose.yaml &&
printf 'SOUNDSIBLE_TAG=0.33.0\n' > .env &&
docker compose up -d

Wait for the container to report healthy, then open http://localhost:5005/player/. Keep .env for later restarts and deliberate upgrades.

Phones and other clients

Web · iOS · OpenSubsonic

Already have a Soundsible server? Open its player in your browser, install the native iOS app or connect a compatible OpenSubsonic client. These connect to your server; they do not replace it.

iPhone / iPad →Other clients →

iOS installation is through sideloading, not the App Store. See the guide for requirements and availability.

Need help connecting from another device or outside your home? Read the server and remote access guide.