WaveFlow Server
Stablev2.2.1Votre musique, partout où vous l’écoutez.
Vos fichiers. Votre serveur. Tous vos lecteurs.
Indiquez à WaveFlow Server les dossiers où vit votre musique. Il construit votre bibliothèque et la joue dans un navigateur, sur un téléphone ou dans le lecteur WaveFlow, chez vous comme ailleurs, et baisse la qualité tout seul quand la connexion faiblit.
Docker · Windows · macOS · Linux · Raspberry Pi 4 et 5

Ce qu’il fait
Un lecteur dans votre navigateur
Rien à installer : ouvrez l’adresse de votre serveur et écoutez sur un ordinateur ou un téléphone. En HTTPS, gardez des morceaux pour quand vous êtes hors ligne.
Compatible avec les applications que vous utilisez déjà
Les applications de musique compatibles Subsonic se connectent telles quelles, et le lecteur WaveFlow garde votre bibliothèque et vos écoutes synchronisées sur vos ordinateurs.
Sait ce que valent vraiment vos fichiers
Chaque fichier sans perte est mesuré : un FLAC qui porte les marques d’un fichier avec perte est signalé comme tel.
Des liens qui restent valides
Albums et artistes gardent la même identité quand la bibliothèque est analysée de nouveau, et les liens que gardent vos apps continuent de fonctionner.
Prêt en une minute
Un programme et un fichier de base de données. Lancez-le sur votre ordinateur, ou laissez-le tourner sur un serveur à la maison avec Docker.
À vous, et à vous seul
Vos fichiers de musique ne sont jamais modifiés. Rien ne quitte votre serveur sans votre accord, et chacun à la maison peut avoir son propre compte.
Où il en est
Stable depuis la 2.0. La version 2.2.1 est la plus récente. Si vous activez la recherche de mises à jour, le serveur peut vous prévenir lorsqu’une nouvelle version est disponible.
- Docker Stable
Une image pour amd64 et arm64 : un serveur, un NAS ou un Raspberry Pi 4 ou 5.
- Windows · macOS · Linux Stable
Une archive à extraire et lancer sur votre propre ordinateur : FFmpeg inclus, sans installation.
Le lecteur web
Un lecteur dans votre navigateur
Rien à installer : ouvrez l’adresse de votre serveur sur un ordinateur ou un téléphone. Albums, artistes, dossiers et genres, recherche à la frappe, file d’attente, paroles synchronisées en plein écran, et des mix tirés de ce que vous écoutez vraiment.
- Hors ligne
- Gardez les morceaux de votre choix et écoutez-les sans connexion, dans ce navigateur, pour votre compte seulement. Les navigateurs l’autorisent en HTTPS, ou sur l’ordinateur où tourne le serveur.
- Installable
- Ajoutez-le à votre téléphone comme une app, avec les commandes sur l’écran verrouillé, les touches multimédias et les raccourcis clavier.
- 14 thèmes
- Clairs et sombres, selon la pièce et l’heure.
- 9 langues
- Anglais, français, allemand, espagnol, italien, japonais, coréen, et chinois simplifié et traditionnel.

Compatible avec vos apps
WaveFlow Server parle Subsonic et OpenSubsonic, le protocole ouvert que beaucoup d’apps de musique connaissent déjà. Ajoutez votre serveur dans l’app avec son adresse, votre nom d’utilisateur et un mot de passe d’app : aucun plugin, rien d’autre à installer.
- Protocole
- Subsonic · OpenSubsonic
- Adresse
/rest/*La plupart des apps l’ajoutent d’elles-mêmes : donnez-leur simplement l’adresse de votre serveur.- Mot de passe
- Les apps ont leur propre mot de passe, distinct de celui que vous utilisez dans le navigateur.
| App | Fonctions vérifiées |
|---|---|
| SymfoniumAndroid | Navigation dans la bibliothèque, déplacement dans les morceaux Opus, MP3 et FLAC, favoris, notes, signets, paroles |
| FeishinWindows | Navigation dans la bibliothèque, dossiers, paroles synchronisées, radio, playlists |
| DSubAndroid | Dossiers, podcasts, file de lecture, playlists, partage |
| JulietiPhone | Navigation dans la bibliothèque, transcodage, file de lecture, playlists |
Chaque application a été testée à la main, et chaque résultat vérifié côté serveur plutôt que sur l’écran de l’application. La dernière campagne complète s’est terminée le 28 octobre 2026, avant la 2.0.0 : les fonctions ajoutées depuis n’ont pas toutes été testées avec ces applications.
Lire la matrice de compatibilitéWaveFlow DesktopWindows · macOS · Linux
Garde votre bibliothèque et vos écoutes en phase sur vos ordinateurs, par l’API native
Sait ce que valent vraiment vos fichiers
Une bibliothèque réunie au fil des années réserve des surprises. WaveFlow Server écoute les fichiers eux-mêmes, et envoie à chaque app le son qu’elle peut recevoir.

Les faux fichiers sans perte, repérés
L’audio de chaque fichier sans perte est mesuré. Un FLAC qui porte les marques d’un fichier avec perte est signalé comme tel, tout comme les bits de remplissage et l’audio suréchantillonné à une fréquence d’échantillonnage plus élevée.
L’original, ou plus léger en route
Écoutez le fichier d’origine, ou laissez le serveur le convertir à la volée en MP3, Opus ou AAC quand la connexion est lente. Une application qui utilise des requêtes par plages d’octets pour se déplacer dans le morceau peut ne pas y parvenir pendant une conversion en cours : utilisez alors le fichier d’origine.
Un volume égal
Le ReplayGain part vers vos apps avec chaque morceau, et le serveur peut niveler lui-même un flux converti pour une app qui ne le fait pas.
À vous, et à vous seul
Un serveur chez vous ne doit répondre qu’à vous. WaveFlow Server est construit ainsi dès le premier démarrage.
Tout ce que le serveur peut contacterVos fichiers restent tels quels
L’analyse et chaque modification de tags laissent vos fichiers audio intacts. Un fichier disparu garde ses favoris, ses notes et ses écoutes jusqu’à son retour.
Rien ne sort sans votre accord
Avec ses réglages par défaut, le serveur n’envoie rien de lui-même. Paroles, photos d’artistes, scrobbling et recherche de mises à jour attendent chacun votre oui.
Un compte pour chacun à la maison
Chaque compte ne voit que les bibliothèques dont il fait partie. Les mots de passe sont hachés avec Argon2id, la connexion est protégée contre les essais en série, et un jeton à usage unique empêche un inconnu de s’approprier un serveur tout neuf.
Sauvegardé en une commande
Une commande copie la base de données et sa clé ensemble, et avant une mise à jour qui modifie la base, le serveur fait lui-même une copie des deux, sauf si vous le désactivez. Les photos d’artistes, les canvas et les podcasts téléchargés se trouvent à côté, dans le dossier de données : sauvegardez le dossier entier pour les garder aussi.
Prêt en une minute
Un conteneur, un fichier de base de données, un fichier de clé. Pas de serveur de base de données, pas de cache, rien d’autre à faire tourner, et FFmpeg est déjà inclus.
Enregistrez ceci sous compose.yaml
Remplacez /path/to/music par le dossier où se trouve votre musique. Le serveur ne fait que le lire.
compose.yamlservices: 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:Démarrez-le
Docker récupère l’image et lance le serveur en arrière-plan.
Terminaldocker compose up -dCréez votre compte
Ouvrez http://your-host:4533. L’écran de configuration crée le compte administrateur et demande un jeton à usage unique, que vous pouvez consulter avec la commande ci-dessous :
Terminaldocker compose exec waveflow cat /data/setup-tokenAjoutez votre musique
Indiquez le nom du compte que vous venez de créer (admin ici). La première analyse démarre d’elle-même.
Terminaldocker compose exec waveflow \ waveflow-server library add --owner admin --name Music --path /music
L’image
ghcr.io/instazdll/waveflow-server
Construite pour amd64 et arm64 : elle tourne sur un Raspberry Pi 4 ou 5 avec un système 64 bits. Chaque version porte son numéro, latest suit la dernière version stable, et la même image est sur Docker Hub.
- linux/amd64
- linux/arm64
Écouter depuis l’extérieur
Le serveur parle HTTP sans chiffrement, ce qui convient à un réseau de confiance. Pour écouter de partout, placez-le derrière HTTPS : le dépôt fournit une configuration prête avec Caddy, qui obtient et renouvelle le certificat tout seul.
La configuration CaddySans Docker
Chaque version a aussi une archive à extraire et lancer sur votre propre ordinateur : sans installation, FFmpeg inclus, et le lecteur web s’ouvre de lui-même. Windows et macOS préviennent au premier lancement ; le README.txt fourni dit où cliquer.
- Windows · x86_64.zip
- macOS · Apple silicon.zip
- macOS · Intel.zip
- Linux · x86_64.tar.gz
- Linux · arm64.tar.gz
Les sommes de contrôle des archives sont disponibles dans le fichier SHA256SUMS de la même version.
Télécharger une archivePour aller plus loin
- L’exploiterInstallation, sauvegardes, la clé de l’instance, les proxys inverses et les fonctions optionnelles.(ouvre GitHub dans un nouvel onglet)
- Ce qui sort du serveurChaque hôte que le serveur peut contacter, ce qu’il y envoie, et le réglage qui l’arrête.(ouvre GitHub dans un nouvel onglet)
- Connecter une appLe guide Subsonic et OpenSubsonic : l’adresse à donner, le mot de passe d’app, ce que fait chaque appel.(ouvre GitHub dans un nouvel onglet)
- L’API nativePour construire votre propre client sur /api/v2.(ouvre GitHub dans un nouvel onglet)
- Ce qui a changéChaque version, avec en tête ce qui touche vos apps.(ouvre GitHub dans un nouvel onglet)
- Toute la documentationLa matrice de compatibilité, les documents de conception et les plans.(ouvre GitHub dans un nouvel onglet)
La famille WaveFlow
Une même façon d’écouter, sur chaque écran.
Tout commence par le lecteur. Un serveur de musique, une appli pour téléphone et un éditeur de paroles reposent sur le même principe : vos fichiers, sur vos appareils, sans rien à payer.
- Stable
WaveFlow
Le lecteur de musique local pour Linux, macOS et Windows : des mix tirés de vos écoutes, des paroles synchronisées, un son Hi-Res.
En savoir plus - En développement
WaveFlow Mobile
WaveFlow sur votre téléphone : des applications natives pour Android et iPhone, toutes deux en développement.
En savoir plus - Stable
WaveFlow QuickPlay
Un petit lecteur qui s’ouvre en un clin d’œil : double-cliquez sur un morceau et écoutez, puis continuez dans WaveFlow.
En savoir plus - Version préliminaire
Tempora
Un éditeur de paroles : tapez en rythme avec un morceau et créez des paroles qui s’allument mot à mot.
En savoir plus