v2.0.1

2.0.1 (2026-11-10)

🩹 What's new in v2.0.1

Important

Coming from 1.9? Read the WaveFlow 2.0.0 notes first: they present the new interface and everything else 2.0 brings, and explain that your library is upgraded the first time 2.0 opens it, after a verified backup — 1.9 cannot open it afterwards.

The first fixes after 2.0: a track whose file is gone now says so, the Liked tracks count follows your hearts, switching profiles brings up the new profile's music right away, and an empty cover picture no longer hides the real one.

---

🎧 Playback

• A missing file says so when you start it. Double-clicking a track whose file was deleted outside WaveFlow, or starting an album or a playlist on it, showed that track as playing while the previous one carried on, with no message, and Play then went back to the previous track. It now behaves as it already did when the queue reached such a file: the previous track stops, the player stays on the missing one and the "This track could not be played" alert appears. A track on a network share that does not answer shows its own message. The track is not marked as missing, since an unplugged drive is not a deleted file: the next scan decides. (#1068, refs #1065)

💚 Liked tracks and profiles

• The Liked tracks count follows your hearts. The count in the sidebar and on Home did not move when you liked or unliked a track, so it could stay stale until something else refreshed it, often the next launch. It now changes as soon as you like or unlike a track, in every skin, and after a scan or a duplicate sent to the trash. A like copied from your WaveFlow Server updates it too. (#1069, refs #1066)
• Switching profiles shows the new profile's music. The open page stayed on the previous profile: Liked tracks kept its list until you left and came back, and an open album could even show an album of the other profile. A switch now reloads the page and the search bar and starts a fresh history. An album, artist, genre or playlist that was open takes you to the matching tab of the library, since it belongs to the other profile, and the page starts at the top. (#1069, refs #1067)

🖼️ Covers

• An empty front cover no longer hides the real one. A file whose tags began with an empty front cover picture got no cover at all, even with a valid picture behind it. WaveFlow now takes the first picture that holds an image. A file already in your library is read again only when it changes, so for one that showed no cover, use Deep rescan on its folder. (#1072, refs #1071)

---

📦 Recommended install

Use your platform's package manager when one is available, so updates keep flowing through the tool you already use.

Windows

winget install InstaZDLL.WaveFlow

Arch / Manjaro / EndeavourOS / CachyOS

yay -S waveflow-bin
# or: paru -S waveflow-bin

Fedora / RHEL / Rocky / Alma / CentOS Stream

sudo dnf copr enable instazdll/waveflow
sudo dnf install waveflow

Debian / Ubuntu / Mint / Pop!_OS

The Debian package is wave-flow (kebab-case, required by the Debian naming spec — Tauri bundles it that way from the WaveFlow product name).

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

WaveFlow is not notarized by Apple yet, so macOS refuses to open a copy downloaded by a browser. The script removes the quarantine flag from WaveFlow.app only and changes no system setting; --help lists its options. It is scripts/install-macos.sh, to read before running it. The .dmg below works too: right-click → Open the first time, or run xattr -cr /Applications/WaveFlow.app.

Standalone download

Everything is also available as a raw bundle below — .AppImage, .deb, .rpm, .exe, .msi, .dmg.

🐛 If something goes wrong

Open an issue with your OS, the exact steps, and your logs — Settings → Maintenance → Diagnostics → Copy logs puts them on your clipboard, ready to paste.

---

Thanks to @GoEverLo for three precise reports, and keep the feedback coming. 💚

Full changelog: v2.0.0...v2.0.1