EMPEZAR

Elige tu instalación.

Última versión estable v0.33.0 ↗·Las guías corresponden a esta versión.

Instalación nativa

Linux · macOS · Windows

MÉTODO PRINCIPAL

Ejecución directa en tu equipo, con el lanzador y acceso completo a la configuración. Requiere Python 3.10+, Git, FFmpeg y Node.js 22+.

Guía de instalación →Instalación en servidor

Comandos rápidos por sistema operativo


                      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

Los comandos seleccionan la versión documentada. En Linux usan paquetes de Debian/Ubuntu; comprueba que Node.js sea 22 o posterior. macOS requiere Homebrew. En Windows, vuelve a abrir PowerShell tras instalar los requisitos.

Primer inicio: completa la configuración en localhost:5099/setup e inicia el motor. Mantén la terminal abierta mientras escuchas.

Aplicación de escritorio

Windows

BETA

Un instalador para Windows ejecuta un servidor en este PC y su reproductor, sin necesidad de terminal. Busca en los archivos de la versión el instalador de tu procesador. En Linux, ejecuta el servidor de forma nativa o con Docker y abre el reproductor en tu navegador.

Descargar desde GitHub ↗Consultar la guía de la beta

Android

ALPHA

Conecta a tu servidor Soundsible con audio nativo, DJ, Live, Android Auto y copias explícitas sin conexión.

Descargar APK Android ↗ Instalación y notas de la alpha ↗ SHA256SUMS ↗

Autoriza la instalación desde tu navegador e instala sobre una alpha anterior para conservar tus datos. Actualizaciones manuales. Mínimo técnico: API 24 / WebView 120; evidencia automatizada: API 36. La aceptación física de Bluetooth y coche queda pendiente para beta.

Docker

Linux amd64 · arm64

Ejecuta un servidor en contenedores en un NAS, Raspberry Pi o equipo Linux. La imagen incluye el reproductor y las dependencias de audio. Consulta la guía para configurar almacenamiento persistente, copias y actualizaciones.

Guía de instalación con Docker →

Instalar la versión publicada

Requiere Docker con Compose. Crea una carpeta soundsible y guarda la versión en .env. Si la carpeta ya existe, los comandos se detienen sin sustituirla.

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

Espera a que el contenedor indique healthy y abre http://localhost:5005/player/. Conserva .env para los siguientes inicios y para actualizar de forma deliberada.

Móviles y otros clientes

Web · iOS · OpenSubsonic

¿Ya tienes un servidor Soundsible? Abre su reproductor en el navegador, instala la aplicación nativa de iOS o conecta un cliente OpenSubsonic compatible. Estos clientes se conectan a tu servidor; no lo sustituyen.

iPhone / iPad →Otros clientes →

La aplicación iOS se instala mediante sideloading, fuera de la App Store. Consulta los requisitos y la disponibilidad en la guía.

¿Necesitas conectarte desde otro dispositivo o desde fuera de casa? Consulta la guía de servidor y acceso remoto.