Ga naar de hoofdinhoud
WaveFlow
nl

WaveFlow Server

Stabielv2.2.1

Je muziek, overal waar je luistert.

Jouw bestanden. Jouw server. Elke speler.

Wijs WaveFlow Server de mappen aan waar je muziek staat. Hij bouwt je bibliotheek op en speelt die af in een browser, op een telefoon of in de WaveFlow-speler, thuis of onderweg, en verlaagt zelf de kwaliteit als de verbinding zwak is.

WaveFlow Server downloadenZo installeer je het

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

De webspeler van WaveFlow Server: mixen op basis van waar je naar luistert boven een raster van albums, met de navigatie links
De webspeler. Covers uit de eigen bibliotheek van de maintainer, alleen ter illustratie.

Wat het doet

  1. Een speler in je browser

    Niets te installeren: open het adres van je server en luister op een computer of telefoon. Bewaar nummers via HTTPS voor als je offline bent.

  2. Werkt met de apps die je al gebruikt

    Muziekapps die Subsonic ondersteunen, kunnen zonder aanpassingen verbinding maken. De WaveFlow-speler houdt je bibliotheek en luistergeschiedenis op al je computers gelijk.

  3. Weet wat je bestanden echt zijn

    Elk lossless bestand wordt gemeten, zodat een FLAC met de kenmerken van een lossy bestand als zodanig wordt gemarkeerd.

  4. Albums en artiesten blijven herkenbaar

    Albums en artiesten behouden dezelfde identiteit als de bibliotheek opnieuw wordt gescand, zodat de koppelingen die je apps bewaren blijven werken.

  5. In een minuut klaar

    Eén programma en één databasebestand. Start het op je eigen computer, of laat het met Docker draaien op een thuisserver.

  6. Van jou, en alleen van jou

    Je muziekbestanden worden nooit gewijzigd. Niets verlaat je server zonder dat je het aanzet, en iedereen thuis kan een eigen account hebben.

Waar het nu staat

Stabiel sinds 2.0. Versie 2.2.1 is de nieuwste, er komen nieuwe versies bij, en de server kan je laten weten wanneer er een uit is, zodra je hem toestemming geeft om te controleren.

  • Docker Stabiel

    Eén image voor amd64 en arm64: een server, een NAS of een Raspberry Pi 4 of 5.

  • Windows · macOS · Linux Stabiel

    Een archief om uit te pakken en te starten op je eigen computer: FFmpeg inbegrepen, zonder installatie.

Links

De webspeler

Een speler in je browser

Niets te installeren: open het adres van je server op een computer of telefoon. Albums, artiesten, mappen en genres, zoeken terwijl je typt, de wachtrij, gesynchroniseerde songteksten op volledig scherm en mixen op basis van waar je echt naar luistert.

Offline
Bewaar de nummers die je kiest en speel ze af zonder verbinding, in die browser en alleen voor jouw account. Browsers staan dit toe via HTTPS, of op de computer waarop de server draait.
Installeerbaar
Zet hem als app op je telefoon, met bediening op het vergrendelscherm, mediatoetsen en sneltoetsen.
14 thema's
Licht en donker, passend bij de kamer en het uur.
9 talen
Engels, Frans, Duits, Spaans, Italiaans, Japans, Koreaans en vereenvoudigd en traditioneel Chinees.
Nu aan het afspelen in de webspeler: de albumcover groot, de titel en de artiest, en eronder de kwaliteit van de stream
Nu aan het afspelen, met wat er echt wordt gestreamd

Werkt met de apps die je al hebt

WaveFlow Server spreekt Subsonic en OpenSubsonic, het open protocol dat veel muziekapps al kennen. Voeg je server in de app toe met zijn adres, je gebruikersnaam en een app-wachtwoord: geen plug-in, niets anders om te installeren.

Protocol
Subsonic · OpenSubsonic
Adres
/rest/*De meeste apps vullen het zelf aan: geef ze gewoon het adres van je server.
Wachtwoord
Apps krijgen een eigen wachtwoord, los van het wachtwoord dat je in de browser gebruikt.
Apps die met WaveFlow Server zijn getest en de functies die daarbij werkten
AppWerkende functies tijdens de test
SymfoniumAndroidBladeren, spoelen in Opus, MP3 en FLAC, favorieten, beoordelingen, bladwijzers, songteksten
FeishinWindowsBladeren, mappen, gesynchroniseerde songteksten, radio, afspeellijsten
DSubAndroidMappen, podcasts, wachtrij, afspeellijsten, delen
JulietiPhoneBladeren, transcoderen, wachtrij, afspeellijsten

Elke app is met de hand getest, en elk resultaat is teruggelezen op de server, niet op het scherm van de app. De laatste volledige testronde eindigde op 28 oktober 2026, vóór 2.0.0. Niet alles wat sindsdien is toegevoegd, is al met deze apps getest.

Lees de compatibiliteitsmatrix

WaveFlow DesktopWindows · macOS · Linux

Houdt je bibliotheek en je luistergeschiedenis op je computers gelijk, via de eigen API

Weet wat je bestanden echt zijn

Een bibliotheek die over de jaren is opgebouwd, zit vol verrassingen. WaveFlow Server luistert naar de bestanden zelf en stuurt elke app het geluid dat ze aankan.

De kwaliteitspagina: lossless bestanden gemeten aan hun audio, met een aantal per oordeel en, voor elk nummer, waar de hoge tonen ophouden
Elk lossless bestand gemeten, niet op zijn woord geloofd

  • Nep-lossless, ontdekt

    De audio van elk lossless bestand wordt gemeten. Een FLAC met de kenmerken van een lossy bestand wordt als zodanig gemarkeerd, net als opgevulde bits en audio die naar een hogere samplefrequentie is opgeschaald.

  • Het origineel, of lichter onderweg

    Speel het originele bestand af, of laat de server het tijdens het afspelen omzetten naar MP3, Opus of AAC als de verbinding beperkt is. Een app die bytebereiken gebruikt om naar een andere positie te springen, kan dat mogelijk niet in een stream die nog wordt omgezet: geef die app het originele bestand.

  • Een gelijk volume

    ReplayGain gaat met elk nummer mee naar je apps, en de server kan een omgezette stream zelf egaliseren voor een app die dat niet kan.

Van jou, en alleen van jou

Een server bij jou thuis hoort alleen aan jou te antwoorden. WaveFlow Server is vanaf de eerste start zo gebouwd.

Alles wat de server kan benaderen

  • Je bestanden blijven zoals ze zijn

    De scanner en elke tagwijziging laten je audiobestanden ongemoeid. Een bestand dat verdwijnt, houdt zijn favorieten, beoordelingen en afspeelgeschiedenis tot het terugkomt.

  • Niets gaat weg zonder dat je het aanzet

    Met de standaardinstellingen stuurt de server uit zichzelf niets. Songteksten, artiestenafbeeldingen, scrobbling en de updatecontrole wachten elk op jouw ja.

  • Een eigen account voor iedereen thuis

    Elk account ziet alleen de bibliotheken waar het bij hoort. Wachtwoorden worden gehasht met Argon2id, het aantal inlogpogingen is beperkt om het raden van wachtwoorden tegen te gaan, en een eenmalig token voorkomt dat een onbekende de controle over een nieuwe server overneemt.

  • Back-up met één opdracht

    Eén opdracht kopieert de database en de sleutel samen, en vóór een upgrade die de database wijzigt maakt de server zelf een kopie van beide, tenzij je dat uitzet. Artiestenfoto's, canvassen en gedownloade podcasts staan ernaast in de gegevensmap: maak een back-up van de hele map om die ook te bewaren.

In een minuut klaar

Eén container, één databasebestand, één sleutelbestand. Geen databaseserver, geen cache, niets anders om te draaien, en FFmpeg zit er al in.

  1. Sla dit op als compose.yaml

    Vervang /path/to/music door de map waar je muziek staat. De server leest hem alleen.

    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. Start hem

    Docker haalt de image op en start de server op de achtergrond.

    Terminal
    docker compose up -d

  3. Maak je account aan

    Open http://your-host:4533. Het installatiescherm maakt het beheerdersaccount aan en vraagt om een eenmalig token, dat de server voor je heeft genoteerd:

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

  4. Voeg je muziek toe

    Geef de naam van het account dat je zojuist hebt gemaakt (hier admin). De eerste scan start vanzelf.

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

De image

ghcr.io/instazdll/waveflow-server

Gebouwd voor amd64 en arm64, dus hij draait op een Raspberry Pi 4 of 5 met een 64-bits systeem. Elke release heeft zijn versienummer als tag, latest volgt de nieuwste stabiele versie, en dezelfde image staat op Docker Hub.

  • linux/amd64
  • linux/arm64

Van buitenaf luisteren

De server spreekt gewoon HTTP, wat past bij een netwerk dat je vertrouwt. Om overal te kunnen luisteren, zet je hem achter HTTPS: de repository heeft een kant-en-klare opzet met Caddy, dat het certificaat zelf ophaalt en vernieuwt.

De Caddy-opzet

Zonder Docker

Elke release heeft ook een archief dat je op je eigen computer uitpakt en start: zonder installatie, FFmpeg inbegrepen, en de webspeler opent vanzelf. Windows en macOS waarschuwen bij de eerste start; de README.txt erin zegt waar je op moet klikken.

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

De checksums staan in SHA256SUMS, bij dezelfde release.

Een archief downloaden

Lees verder

De WaveFlow-familie

Eén manier van luisteren, op elk scherm.

Het begint met de speler. Een muziekserver, een telefoonapp en een liedtekst-editor zijn op dezelfde manier gebouwd: jouw bestanden, op jouw apparaten, zonder iets te betalen.