Salta al contenuto principale
WaveFlow
it

WaveFlow Server

Stabilev2.2.1

La tua musica, ovunque tu ascolti.

I tuoi file. Il tuo server. Qualsiasi player.

Indica a WaveFlow Server le cartelle in cui si trova la tua musica. Costruisce la tua libreria e la riproduce in un browser, su un telefono o nel player WaveFlow, a casa o fuori, e abbassa da solo la qualità quando la connessione è debole.

Scarica WaveFlow ServerCome installarlo

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

Il player web di WaveFlow Server: mix creati da ciò che ascolti, sopra una griglia di album, con la navigazione a sinistra
Il player web. Copertine dalla libreria del maintainer, mostrate solo a scopo illustrativo.

Cosa fa

  1. Un player nel tuo browser

    Niente da installare: apri l'indirizzo del tuo server e ascolta su un computer o su un telefono. Con HTTPS, conserva i brani per quando sei offline.

  2. Funziona con le app che usi già

    Le app musicali compatibili con Subsonic si collegano così come sono, e il player WaveFlow tiene allineate la tua libreria e i tuoi ascolti sui tuoi computer.

  3. Sa cosa sono davvero i tuoi file

    Ogni file lossless viene misurato, così un FLAC che porta i segni di un file lossy viene segnalato come tale.

  4. I collegamenti restano validi

    Album e artisti mantengono la stessa identità quando la libreria viene scansionata di nuovo, così i collegamenti che le tue app conservano continuano a funzionare.

  5. Pronto in un minuto

    Un programma e un file di database. Avvialo sul tuo computer, oppure lascialo acceso su un server di casa con Docker.

  6. Tuo, e solo tuo

    I tuoi file musicali non vengono mai modificati. Niente lascia il tuo server se non lo attivi, e ognuno in casa può avere il proprio account.

A che punto è

Stabile dalla 2.0. La versione 2.2.1 è l'ultima, ne arrivano di nuove, e il server può avvisarti quando ne esce una, una volta che gli permetti di controllare.

  • Docker Stabile

    Un'immagine per amd64 e arm64: un server, un NAS o un Raspberry Pi 4 o 5.

  • Windows · macOS · Linux Stabile

    Un archivio da estrarre e avviare sul tuo computer: FFmpeg incluso, senza installazione.

Link

Il player web

Un player nel tuo browser

Niente da installare: apri l'indirizzo del tuo server su un computer o su un telefono. Album, artisti, cartelle e generi, ricerca mentre scrivi, la coda di riproduzione, testi sincronizzati a schermo intero e mix creati da ciò che ascolti davvero.

Offline
Conserva i brani che scegli e ascoltali senza connessione, in quel browser e solo per il tuo account. I browser lo consentono tramite HTTPS, oppure sul computer su cui gira il server.
Installabile
Aggiungilo al telefono come un'app, con i controlli nella schermata di blocco, i tasti multimediali e le scorciatoie da tastiera.
14 temi
Chiari e scuri, secondo la stanza e l'ora.
9 lingue
Inglese, francese, tedesco, spagnolo, italiano, giapponese, coreano e cinese semplificato e tradizionale.
In riproduzione nel player web: la copertina dell'album in grande, il titolo e l'artista, e sotto la qualità dello streaming
In riproduzione, con ciò che viene davvero trasmesso

Funziona con le app che hai già

WaveFlow Server parla Subsonic e OpenSubsonic, il protocollo aperto che molte app musicali già conoscono. Aggiungi il tuo server nell'app con il suo indirizzo, il tuo nome utente e una password per le app: nessun plugin, nient'altro da installare.

Protocollo
Subsonic · OpenSubsonic
Indirizzo
/rest/*La maggior parte delle app lo aggiunge da sola: dai loro semplicemente l'indirizzo del tuo server.
Password
Le app hanno una password propria, separata da quella che usi nel browser.
App testate con WaveFlow Server e funzioni verificate
AppFunzioni verificate
SymfoniumAndroidNavigazione nella libreria, spostamento nel brano con Opus, MP3 e FLAC, preferiti, valutazioni, segnalibri, testi
FeishinWindowsSfogliare, cartelle, testi sincronizzati, radio, playlist
DSubAndroidCartelle, podcast, coda di riproduzione, playlist, condivisione
JulietiPhoneSfogliare, transcodifica, coda di riproduzione, playlist

Ogni app è stata testata manualmente e ogni risultato è stato verificato sul server, anziché basarsi sullo schermo dell’app. L’ultima sessione completa di test si è conclusa il 28 ottobre 2026, prima della 2.0.0: non tutte le funzioni aggiunte da allora sono state testate con queste app.

Leggi la matrice di compatibilità

WaveFlow DesktopWindows · macOS · Linux

Tiene allineate la tua libreria e i tuoi ascolti sui tuoi computer, tramite l'API nativa

Sa cosa sono davvero i tuoi file

Una libreria raccolta negli anni riserva sorprese. WaveFlow Server ascolta i file stessi e invia a ogni app il suono che può gestire.

La pagina Qualità: file lossless misurati dal loro audio, con il numero di file per ogni verdetto e, per ogni brano, il punto in cui finiscono gli acuti
La qualità di ogni file lossless viene misurata, non dedotta dalla sua etichetta

  • Il finto lossless, scoperto

    L'audio di ogni file lossless viene misurato. Un FLAC che porta i segni di un file lossy viene segnalato come tale, così come i bit di riempimento e l'audio convertito a una frequenza di campionamento più alta.

  • L'originale, o più leggero lungo la strada

    Ascolta il file originale oppure lascia che il server lo converta al volo in MP3, Opus o AAC quando la connessione è lenta. Un’app che usa richieste per intervalli di byte per spostarsi nel brano potrebbe non riuscirci durante una conversione ancora in corso: in quel caso, usa il file originale.

  • Volume uniforme

    ReplayGain arriva alle tue app con ogni brano, e il server può livellare da solo uno streaming convertito per un'app che non lo fa.

Tuo, e solo tuo

Un server in casa tua dovrebbe rispondere solo a te. WaveFlow Server è fatto così fin dal primo avvio.

Tutto ciò che il server può contattare

  • I tuoi file restano come sono

    La scansione e ogni modifica dei tag lasciano intatti i tuoi file audio. Un file che sparisce conserva preferiti, valutazioni e ascolti finché non torna.

  • Niente esce se non lo attivi

    Con le impostazioni predefinite, il server non invia nulla da solo. Testi, immagini degli artisti, scrobbling e controllo degli aggiornamenti aspettano ciascuno il tuo sì.

  • Un account per ognuno in casa

    Ogni account vede solo le librerie a cui appartiene. Le password sono protette con hash Argon2id, l'accesso è limitato contro i tentativi a ripetizione, e un token monouso impedisce a un estraneo di appropriarsi di un server appena installato.

  • Backup con un solo comando

    Un comando copia insieme il database e la sua chiave, e prima di un aggiornamento che modifica il database il server fa da sé una copia di entrambi, a meno che tu non lo disattivi. Immagini degli artisti, canvas e podcast scaricati stanno accanto, nella cartella dei dati: fai il backup dell'intera cartella per conservare anche questi.

Pronto in un minuto

Un container, un file di database, un file di chiave. Nessun server di database, nessuna cache, nient'altro da eseguire, e FFmpeg è già incluso.

  1. Salva questo come compose.yaml

    Sostituisci /path/to/music con la cartella in cui si trova la tua musica. Il server la legge soltanto.

    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. Avvialo

    Docker scarica l'immagine e avvia il server in background.

    Terminal
    docker compose up -d

  3. Crea il tuo account

    Apri http://your-host:4533. La schermata di configurazione crea l'account amministratore e chiede un token monouso, che il server ha annotato per te:

    Terminal
    docker compose exec waveflow cat /data/setup-token

  4. Aggiungi la tua musica

    Indica il nome dell'account che hai appena creato (qui admin). La prima scansione parte da sola.

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

L'immagine

ghcr.io/instazdll/waveflow-server

Costruita per amd64 e arm64, quindi funziona su un Raspberry Pi 4 o 5 con un sistema a 64 bit. Ogni versione porta il proprio numero, latest segue l'ultima versione stabile, e la stessa immagine è su Docker Hub.

  • linux/amd64
  • linux/arm64

Ascoltare da fuori

Il server parla HTTP non cifrato, adatto a una rete di cui ti fidi. Per ascoltare da ovunque, mettilo dietro HTTPS: il repository include una configurazione pronta con Caddy, che ottiene e rinnova da solo il certificato.

La configurazione di Caddy

Senza Docker

Ogni versione ha anche un archivio da estrarre e avviare sul tuo computer: senza installazione, con FFmpeg incluso, e il player web si apre da solo. Windows e macOS avvisano al primo avvio; il README.txt all'interno dice dove fare clic.

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

I checksum sono in SHA256SUMS, nella stessa versione.

Scarica un archivio

Per approfondire

La famiglia WaveFlow

Un solo modo di ascoltare, su ogni schermo.

Si parte dal player. Un server musicale, un'app per il telefono e un editor di testi sono costruiti allo stesso modo: i tuoi file, sui tuoi dispositivi, senza pagare nulla.