Soundsible guides

Install and set up

Guide	Use it to…
Install & deployment	Install on your computer or server, choose between the menu, `--daemon` and a systemd service, set up remote access, storage and a reverse proxy, and update.
Docker	Run with Compose, mount an existing library, back up and upgrade.
Desktop beta	Download the Windows or Debian/Ubuntu app and check what has been verified.
Settings & sources	Settings, environment variables, accounts, downloads, YouTube cookies and where files live.
Bring your music	Import Spotify and Apple Music exports.

Guide	What’s inside
DJ	Start a set, choose influences, request songs and edit transitions.
Live	Broadcast, share a room and understand the relay and browser requirements.
OpenSubsonic	Connect other apps to your saved music library.
iOS status	Build and installation instructions, with device behaviour still unverified.
Car integration	Web media controls and the unverified native car path.
Roadmap	Current capabilities, priorities and planned device support.
Privacy	What listening data stays on your server and how to turn learning off.
Legal & acceptable use	Responsibilities when downloading and sharing music.

Some working notes are kept in the repository but go stale and are not maintained for readers — read the roadmap instead of these: appliance rework · premium quality contract · layer contracts · playback queue contract · mobile lists · UI rebuild plan

FFmpeg is installed on the host; Python dependencies come from pip, and the player is built with npm in ui_web/.

Project	License	Role
SolidJS + Vite	MIT	The web player (`ui_web/`)
Flask + Socket.IO	BSD / MIT	Station Engine API and real-time events
yt-dlp	Unlicense (public domain)	YouTube and YouTube Music search and download
LRCLIB	Public API	Synced and plain lyrics
Deezer public API	Public API	Discovery metadata only — no audio comes from Deezer
MusicBrainz	Public API	Recording and release identification
FFmpeg	LGPL / GPL	Audio conversion and extraction
ffmpeg-python	Apache 2.0	Python bindings for FFmpeg