Ir al contenido principal

WaveFlow Server

Establev2.2.1

Tu música, allá donde escuches.

Tus archivos. Tu servidor. Cualquier reproductor.

Indica a WaveFlow Server las carpetas donde está tu música. Crea tu biblioteca y la reproduce en un navegador, en el móvil o en el reproductor WaveFlow, en casa o fuera, y ajusta automáticamente la calidad cuando la conexión es débil.

Docker · Windows · macOS · Linux · Raspberry Pi 4 y 5

El reproductor web de WaveFlow Server: mezclas hechas a partir de lo que escuchas, sobre una cuadrícula de álbumes, con la navegación a la izquierda
El reproductor web. Carátulas de la biblioteca del propio mantenedor, solo a modo de ilustración.

Qué hace

  1. Un reproductor en tu navegador

    Nada que instalar: abre la dirección de tu servidor y escucha en un ordenador o en un móvil. Con HTTPS, guarda canciones para cuando estés sin conexión.

  2. Funciona con las apps que ya usas

    Las apps de música compatibles con Subsonic se conectan tal cual, y el reproductor de WaveFlow mantiene tu biblioteca y tus escuchas al día en todos tus ordenadores.

  3. Sabe lo que son de verdad tus archivos

    Cada archivo sin pérdida se mide, así que un FLAC que lleva las marcas de un archivo con pérdida se señala como tal.

  4. Todo sigue en su sitio

    Los álbumes y los artistas conservan la misma identidad cuando se vuelve a analizar la biblioteca, así que los enlaces guardados en tus apps siguen funcionando.

  5. Listo en un minuto

    Un programa y un archivo de base de datos. Ejecútalo en tu propio ordenador, o déjalo funcionando en un servidor doméstico con Docker.

  6. Tuyo, y solo tuyo

    Tus archivos de música nunca se modifican. Nada sale de tu servidor si no lo activas, y cada persona de la casa puede tener su propia cuenta.

En qué punto está

Estable desde la 2.0. La versión 2.2.1 es la más reciente, siguen llegando versiones nuevas, y el servidor puede avisarte cuando sale una, una vez que le permitas comprobarlo.

  • Docker Estable

    Una imagen para amd64 y arm64: un servidor, un NAS o una Raspberry Pi 4 o 5.

  • Windows · macOS · Linux Estable

    Un archivo comprimido para extraer y ejecutar en tu propio ordenador: FFmpeg incluido, sin instalación.

El reproductor web

Un reproductor en tu navegador

Nada que instalar: abre la dirección de tu servidor en un ordenador o en un móvil. Álbumes, artistas, carpetas y géneros, búsqueda mientras escribes, la cola de reproducción, letras sincronizadas a pantalla completa y mezclas hechas con lo que realmente escuchas.

Sin conexión
Guarda las canciones que elijas y escúchalas sin conexión, en ese navegador y solo para tu cuenta. Los navegadores lo permiten con HTTPS, o en el ordenador donde se ejecuta el servidor.
Instalable
Añádelo a tu móvil como una app, con controles en la pantalla de bloqueo, teclas multimedia y atajos de teclado.
14 temas
Claros y oscuros, según la estancia y la hora.
9 idiomas
Inglés, francés, alemán, español, italiano, japonés, coreano y chino simplificado y tradicional.
Reproduciendo ahora en el reproductor web: la carátula del álbum en grande, el título y el artista, y debajo la calidad de la transmisión
Reproduciendo ahora, con lo que realmente se está transmitiendo

Funciona con las apps que ya tienes

WaveFlow Server habla Subsonic y OpenSubsonic, el protocolo abierto que muchas apps de música ya conocen. Añade tu servidor en la app con su dirección, tu nombre de usuario y una contraseña de app: sin plugins, nada más que instalar.

Protocolo
Subsonic · OpenSubsonic
Dirección
/rest/*La mayoría de las apps la añaden solas: dales simplemente la dirección de tu servidor.
Contraseña
Las apps tienen su propia contraseña, aparte de la que usas en el navegador.
Apps probadas con WaveFlow Server, y lo que se vio hacer a cada una
AppLo que se le vio hacer
SymfoniumAndroidExplorar, avanzar en Opus, MP3 y FLAC, favoritos, valoraciones, marcadores, letras
FeishinWindowsExplorar, carpetas, letras sincronizadas, radio, listas de reproducción
DSubAndroidCarpetas, pódcast, cola de reproducción, listas de reproducción, compartir
JulietiPhoneExplorar, transcodificación, cola de reproducción, listas de reproducción

Cada app se probó a mano, y cada resultado se leyó en el servidor, no en la pantalla de la app. La última prueba completa terminó el 28 de octubre de 2026, antes de la 2.0.0, así que lo añadido desde entonces aún no se ha probado con estas apps.

Leer la matriz de compatibilidad

WaveFlow DesktopWindows · macOS · Linux

Mantiene tu biblioteca y tus escuchas al día en todos tus ordenadores, mediante la API nativa

Sabe lo que son de verdad tus archivos

Una biblioteca reunida a lo largo de los años guarda sorpresas. WaveFlow Server escucha los propios archivos y envía a cada app el sonido que puede recibir.

La página de calidad: archivos sin pérdida medidos a partir de su audio, con un recuento por veredicto y, para cada canción, el punto donde terminan sus agudos
Cada archivo sin pérdida, medido y no creído por su palabra
  • El falso lossless, descubierto

    Se mide el audio de cada archivo sin pérdida. Un FLAC que lleva las marcas de un archivo con pérdida se señala como tal, igual que los bits de relleno y el audio remuestreado a una frecuencia de muestreo más alta.

  • El original, o más ligero por el camino

    Escucha el archivo original, o deja que el servidor lo convierta al vuelo a MP3, Opus o AAC cuando la conexión va justa. Una app que avanza por rango de bytes puede fallar dentro de una conversión aún en curso: dale el archivo original.

  • Volumen uniforme

    ReplayGain llega a tus apps con cada canción, y el servidor puede nivelar por sí mismo una transmisión convertida para una app que no sabe hacerlo.

Tuyo, y solo tuyo

Un servidor en tu casa debería responder solo ante ti. WaveFlow Server está hecho así desde el primer arranque.

Todo lo que el servidor puede contactar
  • Tus archivos se quedan como están

    El escáner y cada edición de etiquetas dejan tus archivos de audio intactos. Un archivo que desaparece conserva sus favoritos, valoraciones y reproducciones hasta que vuelva.

  • Nada sale si no lo activas

    Con sus ajustes por defecto, el servidor no envía nada por su cuenta. Las letras, las imágenes de artistas, el scrobbling y la búsqueda de actualizaciones esperan cada uno tu sí.

  • Una cuenta para cada persona de la casa

    Cada cuenta ve solo las bibliotecas a las que pertenece. Las contraseñas se protegen con hash Argon2id, el inicio de sesión está limitado contra los intentos de adivinarlas, y un token de un solo uso impide que un desconocido se adueñe de un servidor recién instalado.

  • Copia de seguridad con un solo comando

    Un comando copia la base de datos y su clave juntas, y antes de una actualización que cambie la base de datos, el servidor hace por su cuenta una copia de ambas, salvo que lo desactives. Las imágenes de artistas, los canvases y los podcasts descargados están al lado, en la carpeta de datos: haz una copia de toda la carpeta para conservarlos también.

Listo en un minuto

Un contenedor, un archivo de base de datos, un archivo de clave. Sin servidor de base de datos, sin caché, nada más que ejecutar, y FFmpeg ya va incluido.

  1. Guarda esto como compose.yaml

    Sustituye /path/to/music por la carpeta donde está tu música. El servidor solo la lee.

    compose.yaml
    services:
      waveflow:
        image: ghcr.io/instazdll/waveflow-server:2.2.1
        restart: unless-stopped
        ports:
          - "4533:4533"
        environment:
          WAVEFLOW_DATA_DIR: /data
          WAVEFLOW_BIND: 0.0.0.0:4533
        volumes:
          - waveflow-data:/data
          - /path/to/music:/music:ro
    
    volumes:
      waveflow-data:
    
  2. Arráncalo

    Docker descarga la imagen y pone en marcha el servidor en segundo plano.

    Terminal
    docker compose up -d
  3. Crea tu cuenta

    Abre http://your-host:4533. La pantalla de configuración crea la cuenta de administrador y pide un token de un solo uso, que el servidor ha anotado para ti:

    Terminal
    docker compose exec waveflow cat /data/setup-token
  4. Añade tu música

    Indica el nombre de la cuenta que acabas de crear (aquí, admin). El primer análisis empieza solo.

    Terminal
    docker compose exec waveflow \
      waveflow-server library add --owner admin --name Music --path /music

La imagen

ghcr.io/instazdll/waveflow-server

Compilada para amd64 y arm64, así que funciona en una Raspberry Pi 4 o 5 con un sistema de 64 bits. Cada versión lleva su número, latest sigue a la última versión estable, y la misma imagen está en Docker Hub.

  • linux/amd64
  • linux/arm64

Escuchar desde fuera

El servidor habla HTTP sin cifrar, lo que va bien en una red de confianza. Para escuchar desde cualquier sitio, ponlo detrás de HTTPS: el repositorio incluye una configuración lista con Caddy, que obtiene y renueva el certificado por sí mismo.

La configuración de Caddy

Sin Docker

Cada versión también incluye un archivo comprimido que puedes extraer y ejecutar en tu propio ordenador: sin instalación, con FFmpeg incluido, y el reproductor web se abre solo. Windows y macOS avisan la primera vez; el README.txt de dentro explica dónde hacer clic.

  • Windows · x86_64.zip
  • macOS · Apple silicon.zip
  • macOS · Intel.zip
  • Linux · x86_64.tar.gz
  • Linux · arm64.tar.gz

Sus sumas de verificación están en SHA256SUMS, en la misma versión.

Descargar un archivo comprimido