Skip to content

v2.0.2

Choose a tag to compare

@github-actions github-actions released this 13 Nov 07:38
786a256

2.0.2 (2026-11-13)

🩹 What's new in v2.0.2

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.

Coming from 2.0.1? 2.0.2 makes two small changes to each profile's database the first time it opens that profile, after making and verifying a backup. 2.0.1 cannot open an upgraded profile directly: restore its pre-migration backup if you need to go back.

Artists who share a spelling stay apart, Last.fm gets the right artist, the active lyrics line holds still on macOS, and round buttons stay round.


🎀 Artists

  • Two artists with the same spelling stay two artists. "LiSA" and "LISA" were merged into one artist, whose name and picture the other one then took over. When WaveFlow can read MusicBrainz artist identifiers from the files, it now keeps such artists apart, in the library, in the tag editor and in the tag workshop, even when both are credited on the same track. Without an identifier, names still merge regardless of case, as before; DSF and DFF files still use the artist name alone. Run Deep rescan on the folders concerned to separate artists already merged. (#1080, #1084, refs #1076, #1081)
  • Last.fm gets the main artist. A track credited to several artists was scrobbled under the whole credit ("Giga, TeddyLoid"), which Last.fm treats as an artist of its own. It is now scrobbled under its main artist. (#1079, refs #1075)
  • Undo in the tag workshop puts every Album Artist back. Undoing a batch that changed the Album Artist of a file holding two values restored only the first one. (#1085, refs #1082)

πŸ“ Lyrics

  • The active line holds still on macOS. Each time the sung word changed, every word of the line shook by a fraction of a pixel, in the side panel and in the immersive view. A word now only changes colour as the song moves on. Linux's WebKitGTK draws the same way, so the same fix applies there. (#1087)

πŸ–₯️ Interface and window

  • Round buttons stay round when they have focus. Play and the other round buttons turned into rounded squares when focused with the keyboard, and a clicked button could show a focus ring again after the window was restored or a key such as Win / Super was pressed. (#1088, refs #1086)
  • The title bar WaveFlow draws on Linux can minimise and maximise. Its two buttons did nothing. (#1088)
  • KDE Plasma on Wayland: the window frame options tell the truth. There, KWin draws the window frame and keeps it, so the title bar drawn by WaveFlow had no effect, and neither had the GNOME style. Both are no longer offered on such a session, and a note points to the "Run through XWayland" option, which brings them back. (#1091, refs #1089)

πŸ“¦ 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 @Geebarwan and @GoEverLo for their precise reports, and keep the feedback coming. πŸ’š

Full changelog: v2.0.1...v2.0.2