EMPEZAR

Elige tu instalación.

Ejecuta Soundsible en tu ordenador o en un servidor. Después, conecta los dispositivos donde escuchas música.

Última versión estable v0.14.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+.

Comandos rápidos por sistema operativo

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

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

cd ui_web && npm ci && cd ..

python3 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

Linux · Windows

BETA

Una aplicación empaquetada para un solo ordenador, sin necesidad de terminal. Incluye el reproductor web. Busca en los archivos de la versión el instalador correspondiente a tu sistema.

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.

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/a80b0bdd25b71fca5b91eadd9fee6f2f8b86e9e3/compose.yaml -o compose.yaml &&
printf 'SOUNDSIBLE_TAG=0.14.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.

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.

Buscar documentación