WaveFlow QuickPlay v1.6.0

WaveFlow QuickPlay 1.6.0

Your audio files now look like WaveFlow files when QuickPlay is their default player, and QuickPlay plays WavPack and Monkey's Audio.

New

• WavPack (.wv) and Monkey's Audio (.ape): QuickPlay now decodes with the engine of WaveFlow 2.0.0, which reads both, stereo or multichannel. They are registered like the other formats: the context menu and Open with on Windows and Linux, Open With on macOS, Default apps and the per-format icons.
• An icon per format on Windows: once QuickPlay is the default player for a format, its files show a WaveFlow document with the format on it (FLAC, MP3, WAV, AIFF, Ogg, Opus, M4A, MP4, AAC, WavPack, APE, DSF, DFF, M3U, M3U8), in every Explorer view, as a badge on cover thumbnails, and in the file's properties. The Type column says "FLAC audio file" and so on, in QuickPlay's language.
• QuickPlay in Settings › Default apps on Windows: it is listed there with every format it plays, so it can be made the default player for each one in one place. Open with › Always use this app works too. QuickPlay still never makes itself the default: that stays your choice.
• Format icons on macOS: once QuickPlay is the default player for a format (Get Info › Open with › Change All), its files get the same WaveFlow document icon. DSF, DFF, WavPack and APE files show it everywhere in Finder. For the formats macOS knows itself (FLAC, MP3, AAC, playlists…), Finder keeps its own icon in the icon and list views and shows QuickPlay's in the Get Info window: that is Finder's choice, not something an app can change.

Install

• Windows: download waveflow-quickplay_1.6.0_x64-setup.exe. It installs for the current user without administrator rights and registers the context-menu entries, the per-format icons and the Default apps entry. Run it over an earlier version to upgrade; your settings live in their own file and are kept.
• Linux, on x86_64 (amd64, x86_64 in the file name) or Arm (arm64, aarch64): the .deb for Debian and Ubuntu, the .rpm for Fedora, RHEL and openSUSE, or the .AppImage for any distribution (make it executable and run it). The .deb and the .rpm install the desktop entry, so QuickPlay appears in Open with for audio files and playlists. An AppImage installs nothing: run it once with --register for the same entry.
• macOS: download waveflow-quickplay_1.6.0_macos-universal.dmg, open it and drag WaveFlow QuickPlay to Applications. The app is signed ad hoc, not by an Apple Developer ID, so macOS blocks the first launch: open System Settings › Privacy & Security and choose Open Anyway (on macOS 14 and earlier, right-click the app and choose Open).

1.2.0 to 1.5.0, installed from the Windows installer, the macOS app or an AppImage, update themselves to 1.6.0: they download it at launch and install it when you close QuickPlay, once it says "QuickPlay 1.6.0 will be installed when you close it", for six seconds in the status line under the title; closed before that, it picks up again at the next launch. Missed the message? Close QuickPlay, open it again and look at the version in the settings page; if it is still the old one after a launch or two, install 1.6.0 by hand. That takes Check for updates at launch, at the bottom of the settings page, which is on unless you turned it off. If it is off, either turn it back on and start QuickPlay again (the check runs only at launch), or install 1.6.0 by hand. 1.0.0 and 1.1.0 do not look for updates, so they are upgraded by hand once.

SHA-256 checksums are in SHA256SUMS-windows.txt, SHA256SUMS-linux.txt (x86_64), SHA256SUMS-linux-aarch64.txt and SHA256SUMS-macos.txt. latest.json is what the updater reads: it lists the packages that update themselves (the Windows installer, the macOS app and the two AppImages), each with its signature.

Note

The Windows installer is signed with WaveFlow's self-signed certificate, so Windows may still show a SmartScreen warning on first launch.

Known limitations

• Some WavPack and Monkey's Audio files are not decoded by WaveFlow 2.0.0's engine: hybrid WavPack (with or without its .wvc correction file), DSD WavPack, floating-point APE, 32-bit APE with more than one channel (stereo included), and APE older than format 3950. Such files are left out when they are queued.
• Already made QuickPlay your default player on Windows? Pick it again for each format (Settings › Default apps, or Open with › Always use this app) to get the new icons. Windows keeps the choice you made before, which points at an entry with one icon for every format, and no app may change that choice for you.
• On macOS the icons show only once QuickPlay is the default player for a format, and, for the formats macOS knows itself, only in the Get Info window (see above).
• Linux has no per-format icons: a file's icon there comes from the icon theme, whatever the default player, so QuickPlay leaves it alone.
• A .deb, an .rpm and a copy run from a read-only place (the disk image itself, or an app macOS runs from a translocated copy because it was not moved to Applications) are never replaced by QuickPlay: they only say that a new version is out.

WaveFlow QuickPlay v1.5.0

WaveFlow QuickPlay 1.5.0

QuickPlay now runs on 64-bit Arm Linux, and its updates come from two places.

New

• Linux on Arm: a .deb, an .rpm and an AppImage for 64-bit Arm (aarch64), such as a Raspberry Pi 4 or 5 on a 64-bit system. They are built natively, on the same Ubuntu as the x86_64 packages, so they need the same glibc (2.35 or later). The Arm AppImage updates itself like the x86_64 one.
• A second home for updates: each release is also copied to download.waveflow.app. At launch QuickPlay reads GitHub's latest.json, then that copy, and keeps the newest version either offers. If one of them is unreachable, the other still delivers the update. When both have it, GitHub's package comes first, the copy's if GitHub's cannot be downloaded or does not check out. Each package is still verified against the release key, whichever host it came from.

Fixes

• --register from an AppImage wrote a desktop entry pointing at the AppImage's temporary mount under /tmp, which goes away when QuickPlay closes, so Open with stopped working after the first run. It now registers the .AppImage file itself. Run it again if you move that file.

Security

• An AppImage takes only its own architecture's update. The manifest that lists the packages is not signed, only each package is. An x86_64 package, genuinely signed, could therefore have been listed under the Arm entry. Each AppImage now accepts only a file whose signed name ends with its own architecture.

Install

• Windows: download waveflow-quickplay_1.5.0_x64-setup.exe. It installs for the current user without administrator rights and registers the context-menu entries. Run it over an earlier version to upgrade; your settings live in their own file and are kept.
• Linux, on x86_64 (amd64, x86_64 in the file name) or Arm (arm64, aarch64): the .deb for Debian and Ubuntu, the .rpm for Fedora, RHEL and openSUSE, or the .AppImage for any distribution (make it executable and run it). The .deb and the .rpm install the desktop entry, so QuickPlay appears in Open with for audio files and playlists. An AppImage installs nothing: run it once with --register for the same entry.
• macOS: download waveflow-quickplay_1.5.0_macos-universal.dmg, open it and drag WaveFlow QuickPlay to Applications. The app is signed ad hoc, not by an Apple Developer ID, so macOS blocks the first launch: open System Settings › Privacy & Security and choose Open Anyway (on macOS 14 and earlier, right-click the app and choose Open).

1.2.0 to 1.4.0, installed from the Windows installer, the macOS app or the x86_64 AppImage, update themselves to 1.5.0 from GitHub: they download it at launch and install it when you close QuickPlay. They know only GitHub; 1.5.0 is the first version that also reads the copy. 1.0.0 and 1.1.0 do not look for updates, so they are upgraded by hand once. Arm users install 1.5.0 by hand, since it is the first Arm release.

SHA-256 checksums are in SHA256SUMS-windows.txt, SHA256SUMS-linux.txt (x86_64), SHA256SUMS-linux-aarch64.txt and SHA256SUMS-macos.txt. latest.json is what the updater reads: it lists the packages that update themselves (the Windows installer, the macOS app and the two AppImages), each with its signature.

Note

The Windows installer is signed with WaveFlow's self-signed certificate, so Windows may still show a SmartScreen warning on first launch.

Known limitations

• The Arm packages were tested on GitHub's Arm build machines: built, installed and started there, not yet on a Raspberry Pi or another Arm desktop. Reports from Arm machines are welcome.
• An unreachable host delays the update by up to 30 seconds, the time the check gives each latest.json before going on to the other. It runs in the background: playback and the window are never held up.
• A .deb, an .rpm and a copy run from a read-only place (the disk image itself, or an app macOS runs from a translocated copy because it was not moved to Applications) are never replaced by QuickPlay: they only say that a new version is out.

WaveFlow QuickPlay v1.4.0

WaveFlow QuickPlay 1.4.0

QuickPlay now opens .m3u and .m3u8 playlists.

New

• M3U playlists: open an .m3u or .m3u8 from the file manager, the open dialog, a drop on either window or the command line, and QuickPlay queues its files in the playlist's order.
  • Entries can be absolute paths, paths relative to the playlist, or file:// URLs.
  • A playlist written on Windows, with \ between folders, also works on Linux and macOS.
  • The text is read in whatever code page wrote it, so an old playlist saved by a Windows player keeps its accented names.
  • Web addresses and files that are not there are left out.
• In the menus: on Windows, Play with QuickPlay and Add to QuickPlay playlist now appear on .m3u and .m3u8 files. On Linux, QuickPlay is offered for the M3U types. On macOS, Finder lists it under Open With for playlists. Installing 1.4.0, by hand or by the updater, adds the entries.

Security

• Network shares in a playlist. On Windows, merely opening \\host\share\… can make Windows authenticate to that host with your current credentials. A playlist downloaded from anywhere could abuse that to capture an NTLM authentication exchange. QuickPlay follows a share only from a playlist on that same host: an .m3u on your NAS listing the NAS's files works, while one in Downloads naming someone else's server does not. Mapped drives are treated as local paths and always work. Device paths and anything not clearly a drive or a share are refused.

Install

• Windows: download waveflow-quickplay_1.4.0_x64-setup.exe. It installs for the current user without administrator rights and registers the context-menu entries. Run it over an earlier version to upgrade; your settings live in their own file and are kept.
• Linux: the .deb for Debian and Ubuntu, the .rpm for Fedora, RHEL and openSUSE, or the .AppImage for any distribution (make it executable and run it). All three carry the desktop entry, so QuickPlay appears in "Open with" for audio files and playlists.
• macOS: download waveflow-quickplay_1.4.0_macos-universal.dmg, open it and drag WaveFlow QuickPlay to Applications. The app is signed ad hoc, not by an Apple Developer ID, so macOS blocks the first launch: open System Settings › Privacy & Security and choose Open Anyway (on macOS 14 and earlier, right-click the app and choose Open).

1.2.0 and 1.3.0, installed from the Windows installer, the macOS app or the AppImage, update themselves to 1.4.0: they download it at launch and install it when you close QuickPlay. 1.0.0 and 1.1.0 do not look for updates, so they are upgraded by hand once.

SHA-256 checksums are in SHA256SUMS-windows.txt, SHA256SUMS-linux.txt and SHA256SUMS-macos.txt. latest.json is what the updater reads: it lists the packages that update themselves (the Windows installer, the macOS app and the AppImage), each with its signature.

Note

The Windows installer is signed with WaveFlow's self-signed certificate, so Windows may still show a SmartScreen warning on first launch.

Known limitations

• Playlists are read up to 16 MiB. A playlist inside a dropped folder is not read, since its files would come twice. Neither is one named by another playlist.
• One hand-over carries up to 10 000 files, in a message of at most 4 MiB (the paths with their line breaks and the command). A larger selection given to a QuickPlay that is already open opens in a window of its own instead.
• Pinned on Wayland, QuickPlay runs under XWayland, which can look softer at fractional scaling unless the compositor scales X11 windows natively. A session without XWayland cannot pin.
• A .deb, an .rpm and a copy run from a read-only place (the disk image itself, or an app macOS runs from a translocated copy because it was not moved to Applications) are never replaced by QuickPlay: they only say that a new version is out.
• On macOS, Finder has no per-app menu entries, so there is no Add to QuickPlay playlist there; Open With replaces the queue, as Play with does on Windows.
• Continue in WaveFlow needs WaveFlow Desktop 2.0.0-beta.1 or later, read from the install's metadata. The button stays hidden for an older WaveFlow, for one whose version cannot be read (such as an AppImage put on PATH by hand), and for the Flatpak build, whose sandbox cannot see the hand-over file.
• The output device is the system default, opened in shared mode.

Full changelog: v1.3.0...v1.4.0

WaveFlow QuickPlay v1.3.0

WaveFlow QuickPlay 1.3.0

A large selection sent from the file manager now lands in one window, Explorer hands it over in one go, and the bitrate display now follows what is actually playing.

New

• Live bitrate: the format chip showed the whole file's average, read from its tags, from the first second to the last. A FLAC that opens on a quiet passage showed a low figure through its loud middle. QuickPlay now measures the bitrate each second from the packets it decodes and shows it as that second plays; the average shows only until the first reading. In silence it drops to a few kbps, as the compressed stream really does.
• DSD bitrate: DSF and DFF files showed none. Their rate is constant, one bit per sample and channel, so the chip shows it from the header: 5 645 kbps for DSD64 stereo.
• Explorer hands the whole selection to one QuickPlay: Play with QuickPlay and Add to QuickPlay playlist started one QuickPlay per selected file, a thousand processes for a thousand files. They are now drop targets: Explorer starts QuickPlay once and gives it the whole selection. Folders lose the 15-item limit Explorer put on them. Installing 1.3.0, by hand or by the updater, switches the menu entries over.

Fixed

• A large selection no longer opens dozens of windows. Launches that arrived faster than the player could take them, or before its window was up, each opened their own window, and enough of them could bring the system down. A launch that finds the player busy now waits for it to take its files, for up to 30 seconds, and opens no window of its own. This covers Linux file managers and Explorer's Open with, which still start one process per file.
• A launch tried twice is queued once. A launch that timed out and tried again could add its files twice.
• Single instance with a long temporary directory. On macOS and Linux, a $TMPDIR or $XDG_RUNTIME_DIR set by hand, or a long user name, could make the socket's path too long; every launch then opened its own window. QuickPlay now falls back to a shorter one: a short name in the same directory, else a directory of yours in /tmp that only you can open.
• A restart that lost its state says so. When pinning or unpinning under Wayland restarts QuickPlay and the new copy cannot read where the old one was, it still opens, now with Playlist lost while restarting in the status line rather than an empty player and no word why.

Install

• Windows: download waveflow-quickplay_1.3.0_x64-setup.exe. It installs for the current user without administrator rights and registers the context-menu entries. Run it over an earlier version to upgrade; your settings live in their own file and are kept.
• Linux: the .deb for Debian and Ubuntu, the .rpm for Fedora, RHEL and openSUSE, or the .AppImage for any distribution (make it executable and run it). All three carry the desktop entry, so QuickPlay appears in "Open with" for audio files.
• macOS: download waveflow-quickplay_1.3.0_macos-universal.dmg, open it and drag WaveFlow QuickPlay to Applications. The app is signed ad hoc, not by an Apple Developer ID, so macOS blocks the first launch: open System Settings › Privacy & Security and choose Open Anyway (on macOS 14 and earlier, right-click the app and choose Open).

1.2.0 installed from the Windows installer, the macOS app or the AppImage updates itself to 1.3.0: it downloads it at launch and installs it when you close QuickPlay. 1.0.0 and 1.1.0 do not look for updates, so they are upgraded by hand once.

SHA-256 checksums are in SHA256SUMS-windows.txt, SHA256SUMS-linux.txt and SHA256SUMS-macos.txt. latest.json is what the updater reads: it lists the packages that update themselves (the Windows installer, the macOS app and the AppImage), each with its signature.

Note

The Windows installer is signed with WaveFlow's self-signed certificate, so Windows may still show a SmartScreen warning on first launch.

Known limitations

• One hand-over carries up to 10 000 files, in a message of at most 4 MiB (the paths with their line breaks and the command). A larger selection given to a QuickPlay that is already open opens in a window of its own instead.
• Pinned on Wayland, QuickPlay runs under XWayland, which can look softer at fractional scaling unless the compositor scales X11 windows natively. A session without XWayland cannot pin.
• A .deb, an .rpm and a copy run from a read-only place (the disk image itself, or an app macOS runs from a translocated copy because it was not moved to Applications) are never replaced by QuickPlay: they only say that a new version is out.
• On macOS, Finder has no per-app menu entries, so there is no Add to QuickPlay playlist there; Open With replaces the queue, as Play with does on Windows.
• Continue in WaveFlow needs WaveFlow Desktop 2.0.0-beta.1 or later, read from the install's metadata. The button stays hidden for an older WaveFlow, for one whose version cannot be read (such as an AppImage put on PATH by hand), and for the Flatpak build, whose sandbox cannot see the hand-over file.
• The output device is the system default, opened in shared mode.

Full changelog: v1.2.0...v1.3.0

WaveFlow QuickPlay v1.2.0

WaveFlow QuickPlay 1.2.0

QuickPlay now keeps itself up to date, pinning works from a Wayland session through XWayland, it takes WaveFlow's new logo, and a full code review brings a round of fixes to playback, the playlist and hand-offs between launches.

New

• Automatic updates: at launch, QuickPlay looks for a newer release. The Windows installer's copy, the macOS app and the AppImage download it in the background, check it against QuickPlay's release key and install it when you close QuickPlay. The next launch is the new version, and nothing that plays is cut. A .deb or an .rpm only says that the new version is out, with a link to it in the settings, and your package manager installs it. Check for updates at launch, at the bottom of the settings page, turns the check off.
• Pinning works through XWayland in Wayland sessions: only the compositor may keep a window on top there, so the pin did nothing. Pinning QuickPlay in a Wayland session now restarts it under XWayland, where the pin works (GNOME, KDE) and the playlist docks to the player again. The queue, the track, the position and the play or pause state carry over. Unpinning goes back to Wayland. The pin's tooltip says what a click will do, or why a session without XWayland cannot pin.
• WaveFlow's new logo: the W of its name drawn as a wave replaces the three bars, in the title bar, the settings, the Continue in WaveFlow button and the app icon on every system.

Fixed

• Headphones in or out no longer stop playback on macOS. A change of the default output was taken for a lost device: the engine was released and the track stopped. Playback now follows the new output.
• Next after deleting the current track plays the track that moved up into its place. It skipped it, and shuffle skipped it too.
• Stop, Clear and removing the playing track stay that way. The end of the previous track, or an error, arriving at the same moment could start another one.
• A device that cannot be opened shows the reason instead of leaving the player stuck on Loading.
• Resuming a track paused in its last second after more than five seconds no longer cuts what was left of it.
• The spectrum keeps moving on mono and low-rate output devices, where it froze for the whole track.
• Steady playlist scrolling: the list no longer jumps while scrolling, nor stops short of the bottom of a tall window.
• The settings header fits a 320-point window: the language picker no longer runs over the title.
• A launch no longer hangs behind another program that connects to QuickPlay and sends nothing. A file name that is not valid Unicode or holds a line break opens in a window of its own instead of being mangled.
• Lyrics: a damaged .lrc can no longer freeze the window, an invalid [offset:] no longer resets the timing, and a sidecar named .LRC is found on Linux.
• Linux packages declare the system libraries they need, so an older distribution refuses the package at install instead of QuickPlay failing at launch.
• SHA256SUMS-windows.txt now has Unix line ends, so sha256sum -c checks the installer on Linux and macOS.

Changed

• The licence is GPL-3.0-only, as Cargo.toml and the packages already said; the README no longer offers "any later version".
• An unknown --option on the command line is logged and ignored instead of being opened as a file.

Install

• Windows: download waveflow-quickplay_1.2.0_x64-setup.exe. It installs for the current user without administrator rights and registers the context-menu entries. Run it over 1.1.0 to upgrade; your settings live in their own file and are kept.
• Linux: the .deb for Debian and Ubuntu, the .rpm for Fedora, RHEL and openSUSE, or the .AppImage for any distribution (make it executable and run it). All three carry the desktop entry, so QuickPlay appears in "Open with" for audio files.
• macOS: download waveflow-quickplay_1.2.0_macos-universal.dmg, open it and drag WaveFlow QuickPlay to Applications. The app is signed ad hoc, not by an Apple Developer ID, so macOS blocks the first launch: open System Settings › Privacy & Security and choose Open Anyway (on macOS 14 and earlier, right-click the app and choose Open).

1.0.0 and 1.1.0 do not look for updates, so this version is installed by hand once. From 1.2.0 on, the Windows, macOS and AppImage copies update themselves.

SHA-256 checksums are in SHA256SUMS-windows.txt, SHA256SUMS-linux.txt and SHA256SUMS-macos.txt. latest.json is what the updater reads: it lists each package with its signature.

Note

The Windows installer is signed with WaveFlow's self-signed certificate, so Windows may still show a SmartScreen warning on first launch.

Known limitations

• Pinned on Wayland, QuickPlay runs under XWayland, which can look softer at fractional scaling unless the compositor scales X11 windows natively. A session without XWayland cannot pin.
• A .deb, an .rpm and a copy run from a read-only place (the disk image itself, or an app macOS runs from a translocated copy because it was not moved to Applications) are never replaced by QuickPlay: they only say that a new version is out.
• On macOS, Finder has no per-app menu entries, so there is no Add to QuickPlay playlist there; Open With replaces the queue, as Play with does on Windows.
• Continue in WaveFlow needs WaveFlow Desktop 2.0.0-beta.1 or later, read from the install's metadata. The button stays hidden for an older WaveFlow, for one whose version cannot be read (such as an AppImage put on PATH by hand), and for the Flatpak build, whose sandbox cannot see the hand-over file.
• The output device is the system default, opened in shared mode.

Full changelog: v1.1.0...v1.2.0

WaveFlow QuickPlay v1.1.0

WaveFlow QuickPlay 1.1.0

A macOS app, repeat and shuffle in the playlist, a hand-over to WaveFlow, cleaner DSD, and the player now decodes through exactly the same code as WaveFlow Desktop.

New

• macOS app: a disk image with one app for Apple silicon and Intel Macs, macOS 11 or later. Finder offers it under Open With for its supported audio extensions, DSF and DFF included, and it can be made the default player from Get Info. Until now macOS meant building from source.
• Repeat and shuffle in the playlist toolbar. One press on repeat loops the playlist, a second loops the current track, a third turns it off. Shuffle plays every track once before any comes round again, and Previous walks back through what played. Both are remembered, and R and H toggle them from the keyboard.
• Continue in WaveFlow: a button with the WaveFlow logo hands the queue, the current track, the position and the play or pause state over to WaveFlow Desktop, then QuickPlay closes. WaveFlow picks up at the same spot. The button appears only when WaveFlow Desktop 2.0.0-beta.1 or later is installed, so it stays hidden until that version is out.
• Long lyric lines keep up with the song: a line wider than its column holds for a moment, then scrolls so that its end is on screen before the next line starts.
• A shorter title bar that reads QuickPlay beside the WaveFlow logo, which leaves more room for the track's title. The file-manager entries are shortened the same way, to Play with QuickPlay and Add to QuickPlay playlist, in all eight languages.

Fixed

• DSD conversion no longer adds a steady hiss. DSF and DFF files are converted with WaveFlow Desktop's 256-tap filter instead of 64 taps, which let the DSD shaping noise through as a steady hiss in the background.
• Explorer menu order: Play with QuickPlay now comes above Add to QuickPlay playlist. The installer removes the old entry.
• A brief audio stall no longer stops the track. A buffer underrun, such as the one macOS causes while it checks a new app on its first launch, was taken for a lost output device: the engine was released and the track stopped with an error. Playback now carries on.
• A slow file no longer freezes the controls. A track on a network share or a disk that is spinning up opens in the background, and Stop, another track or closing the window answer at once. Files on a network share are read ahead, so a seek there does not wait for the whole transfer.

Under the hood

QuickPlay now plays through waveflow-core's playback module, the decoding WaveFlow Desktop itself uses, instead of a copy of it. Decoding fixes can now be shared between WaveFlow Desktop and QuickPlay instead of being implemented twice. What QuickPlay keeps of its own is the small transport around it: the decoder thread, the lock-free ring and the audio callback.

Install

• Windows: download waveflow-quickplay_1.1.0_x64-setup.exe. It installs for the current user without administrator rights and registers the context-menu entries. Run it over 1.0.0 to upgrade; your settings live in their own file and are kept.
• Linux: the .deb for Debian and Ubuntu, the .rpm for Fedora, RHEL and openSUSE, or the .AppImage for any distribution (make it executable and run it). All three carry the desktop entry, so QuickPlay appears in "Open with" for audio files.
• macOS: download waveflow-quickplay_1.1.0_macos-universal.dmg, open it and drag WaveFlow QuickPlay to Applications. The app is signed ad hoc, not by an Apple Developer ID, so macOS blocks the first launch: open System Settings › Privacy & Security and choose Open Anyway (on macOS 14 and earlier, right-click the app and choose Open). This is asked again for each new version you download, since every release is signed anew.

SHA-256 checksums are in SHA256SUMS-windows.txt, SHA256SUMS-linux.txt and SHA256SUMS-macos.txt.

Note

The Windows installer is signed with WaveFlow's self-signed certificate, so Windows may still show a SmartScreen warning on first launch.

Known limitations

• On macOS, Finder has no per-app menu entries, so there is no Add to QuickPlay playlist there; Open With replaces the queue, as Play with does on Windows.
• Continue in WaveFlow needs WaveFlow Desktop 2.0.0-beta.1 or later, read from the install's metadata. The button stays hidden for an older WaveFlow, for one whose version cannot be read (such as an AppImage put on PATH by hand), and for the Flatpak build, whose sandbox cannot see the hand-over file.
• On Wayland the playlist window opens where the compositor places it and does not follow the player; the protocol does not let an application position its windows.
• The output device is the system default, opened in shared mode.

Full changelog: v1.0.0...v1.1.0

WaveFlow QuickPlay v1.0.0

WaveFlow QuickPlay 1.0.0

The first release of the small player that sits next to WaveFlow: double-click a track, hear it now, with the desktop app's own decoders in a window the size of a notification.

What it does

• Plays every format WaveFlow plays: MP3, FLAC, WAV, AIFF, Vorbis, Opus, AAC, ALAC, DSF and DFF, through the same codec registry, resampler and lock-free ring as the desktop engine.
• Opens in a quarter of a second, audio engine created on the first play, one 31 MB executable.
• Two sizes: a compact bar with clock, title, format, spectrum, seek and transport, or the cover above it, freely resizable.
• A playlist window docked to the player: it follows it, minimizes and restores with it, and shares its taskbar entry.
• Synced lyrics from a .lrc next to the file, the current line in place of the title; long lines scroll.
• One instance per user: launching another file hands it to the open player, --enqueue appends.
• File-manager integration: Play with WaveFlow QuickPlay and Add to WaveFlow QuickPlay playlist in the Explorer context menu and an "Open with" entry, installed for the current user; a desktop entry with the audio MIME types on Linux.
• Eight languages: English, French, German, Spanish, Italian, Simplified Chinese, Japanese and Korean. The system language is used by default; the gear in the title bar opens a settings page to pick another, with the about block (version, licence, repository) under it. The Explorer entries follow the chosen language.

Deliberately not in scope: EQ, crossfade, gapless, ReplayGain, device selection and exclusive output. Those live in WaveFlow Desktop.

Install

• Windows: download waveflow-quickplay_1.0.0_x64-setup.exe. It installs for the current user without administrator rights and registers the context-menu entries; uninstalling removes them.
• Linux: the .deb for Debian and Ubuntu, the .rpm for Fedora, RHEL and openSUSE, or the .AppImage for any distribution (make it executable and run it). All three carry the desktop entry, so QuickPlay appears in "Open with" for audio files.
• macOS: no bundle or installer for this release. The player was checked from a locally built binary on macOS 26 (Apple silicon): playback, the docked playlist, minimize and restore from the Dock, the single instance. Build it with cargo build --release (needs Xcode's command line tools and cmake).

SHA-256 checksums are in SHA256SUMS-windows.txt and SHA256SUMS-linux.txt.

Note

The Windows installer is signed with WaveFlow's self-signed certificate, so Windows may still show a SmartScreen warning on first launch.

Known limitations

• On Wayland the playlist window opens where the compositor places it and does not follow the player; the protocol does not let an application position its windows.
• The output device is the system default, opened in shared mode.

Full changelog: https://github.com/InstaZDLL/waveflow-quickplay/commits/v1.0.0