Skip to main content
WaveFlow
en

Download

Get WaveFlow for your computer.

Free, and yours to keep.

The music player, the music server and QuickPlay, for Windows, macOS and Linux. No online account, no subscription: download, install, play your own music.

DownloadEvery file

Files read from each product's GitHub releases on November 11, 2026, when this page was built.

Every file

Each product's latest release, file by file. The SHA-256 is the one GitHub publishes for the file: compare it with yours after the download.

WaveFlow v2.0.1

Released November 10, 2026 · Release notes — WaveFlow v2.0.1 (opens in a new tab)

13.5K installer downloads across every version

WaveFlow QuickPlay v1.6.0

Released November 10, 2026 · Release notes — WaveFlow QuickPlay v1.6.0 (opens in a new tab)

108 installer downloads across every version

WaveFlow Server v2.2.1

Released November 10, 2026 · Release notes — WaveFlow Server v2.2.1 (opens in a new tab)

Package managers and Docker

Install through the tool you already use, and updates keep coming through it.

WaveFlow

winget

winget install InstaZDLL.WaveFlow

AUR

yay -S waveflow-bin

COPR

sudo dnf copr enable instazdll/waveflow
sudo dnf install waveflow

APT

sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://packages.buildkite.com/instazdll/waveflow/gpgkey | sudo gpg --dearmor -o /etc/apt/keyrings/waveflow.gpg
echo "deb [signed-by=/etc/apt/keyrings/waveflow.gpg] https://packages.buildkite.com/instazdll/waveflow/any/ any main" | sudo tee /etc/apt/sources.list.d/waveflow.list
sudo apt update && sudo apt install wave-flow

macOS

curl -fsSL https://waveflow.app/install.sh | bash

macOS · beta

curl -fsSL https://waveflow.app/install.sh | bash -s -- --beta

The macOS command downloads the latest release, checks it and installs it into Applications; it changes no system setting. Not on Flathub yet.

WaveFlow Server

Docker

docker run -d --name waveflow \
  -p 4533:4533 \
  -v waveflow-data:/data \
  -v /path/to/music:/music:ro \
  ghcr.io/instazdll/waveflow-server:2.2.1

One image for amd64 and arm64, on GitHub's registry and on Docker Hub; latest follows the latest stable. Compose file and first steps

WaveFlow QuickPlay

QuickPlay is not in a package manager yet: the files above are the way to get it. Except the .deb and the .rpm, it updates itself.

The first launch

WaveFlow is not signed by a certificate Windows or macOS trust yet, so both warn the first time. Here is what you will see, and how to go on.

  • Windows

    The installers carry a self-signed certificate, so Windows does not know the publisher.

    1. If SmartScreen says Windows protected your PC, choose More info.
    2. Then choose Run anyway.

    Smart App Control, when it is on, can block the app outright in some cases: it depends on a reputation Microsoft has not built up for WaveFlow yet.

  • macOS

    The apps are signed ad hoc, not notarized by Apple, so macOS refuses the first launch of a copy downloaded with a browser.

    1. Drag the app to Applications, then open it once.
    2. Open System Settings › Privacy & Security and choose Open Anyway.
    3. On macOS 14 and earlier, right-click the app and choose Open.

    Or clear the download flag of that one app in Terminal; it changes no system setting.

    Terminal

    xattr -dr com.apple.quarantine "/Applications/WaveFlow.app"

    The server has no app to drag: macOS refuses waveflow-server, ffmpeg and ffprobe in turn. The README.txt in its folder clears all three at once.

  • Linux

    Nothing to approve: install the .deb or the .rpm, or make the AppImage executable.

    1. The player needs glibc 2.39 or later: Ubuntu 24.04, Debian 13, Fedora 40 and newer.
    2. QuickPlay needs glibc 2.35 or later, and has Arm64 builds.
    3. The server's archives are static and run on any distribution.

    AppImage

    chmod +x WaveFlow_*.AppImage
./WaveFlow_*.AppImage

    The player is built for x86_64 only for now.

Check a download

Compute the file's SHA-256 and compare it with the one listed above, character for character. The same value means the same file GitHub published.

A matching checksum proves the file arrived intact. It does not say who built it: the files are not signed by a trusted certificate yet.

PowerShell

Get-FileHash .\WaveFlow_2.0.1_windows-x86_64-setup.exe -Algorithm SHA256

macOS

shasum -a 256 WaveFlow_2.0.1_macos-universal.dmg

Linux

sha256sum WaveFlow_2.0.1_linux-x86_64.AppImage

The server's releases also carry a SHA256SUMS file, and QuickPlay's one per system. Next to the downloaded files:

WaveFlow Server

sha256sum --check --ignore-missing SHA256SUMS

WaveFlow QuickPlay · x86_64

sha256sum --check --ignore-missing SHA256SUMS-linux.txt

WaveFlow QuickPlay · Arm64

sha256sum --check --ignore-missing SHA256SUMS-linux-aarch64.txt

Not on a computer?

The phone apps are in development, and Tempora, the lyrics editor, is in early preview. Each page says where it stands.

WaveFlow MobileTemporaWhat changed