Skip to content
nokarin-devPublic

About

Aqloss is a music player built around a Rust audio engine, with optional WASAPI Exclusive mode on Windows for bit-perfect output to compatible hardware.

Topics

Resources

Contributing

Stars

36 stars

Watchers

0 watching

Forks

Latest commit

 

History

249 Commits

Folders and files

Repository files navigation

Aqloss Banner

Release License: GPL v3 Flutter Platform

Total Downloads Flathub Downloads Latest Downloads Nightly Downloads

Nightly Status Test Status


Note

Windows, Linux, and Android are the platforms I actually ship. macOS and iOS compile; I don't test them regularly.

On Windows, WASAPI Exclusive can send the stream straight to the device (no OS mixer). Linux can do the same on ALSA hardware (hw:). Volume, EQ, ReplayGain, and the rest of the DSP stay off in that mode - that's the point. Shared mode goes through the mixer. Bit-perfect still needs a DAC/driver that won't resample behind your back.


Screenshot

Playing (Default) Library Detail (Default) Library Grid (Default)
Playing Library_Detail Library_Grid
Playing (M3) Library Detail (M3) Library Grid (M3)
Playing-M3 Library_Detail-M3 Library_Grid-M3

Formats

DSD (.dsf / .dff) is not supported. Symphonia has no DSD decoder, and I'm not adding a second path for it.

Format Extensions Notes
FLAC .flac lossless, up to 32-bit / 384 kHz
WAV / AIFF .wav .aiff .aif PCM
ALAC .m4a lossless
MP3 .mp3
AAC .aac .m4a
Vorbis .ogg
Opus .opus libopus via Symphonia adapter
WavPack .wv lossless

Download

GitHub releases (Windows installer/portable, Linux .deb / .rpm / AppImage / tarball, Android APKs). Linux is also on Flathub.

A rolling nightly from main has those plus unsigned macOS and iOS.

No AUR package yet. They closed new account registration, so I can't upload aqloss-bin until that opens again. Use GitHub or Flathub until then.

The Windows installer is not code-signed. SmartScreen will complain; More info → Run anyway.

macOS and iOS compile; I don't test them regularly. They only ship on nightly.


Build

You need Flutter (stable) and Rust (stable). For codegen changes, also cargo install flutter_rust_bridge_codegen.

flutter pub get
flutter_rust_bridge_codegen generate # only if you touch the Rust API
flutter run -d windows
sudo apt install clang cmake ninja-build pkg-config libgtk-3-dev liblzma-dev \
  libasound2-dev libpulse-dev libayatana-appindicator3-dev
flutter run -d linux
flutter run -d android

Last.fm / ListenBrainz

Both live under Settings → Integrations. Last.fm needs an API account because this repo is public and I don't ship a key - create one at last.fm/api/account/create and paste it in settings. ListenBrainz uses your own user token.

Lua/webhook plugins: see docs/plugin.md.


Support

Also in Settings → Support.


License

Aqloss
Copyright © 2025-2026 nokarin-dev

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program. If not, see <https://www.gnu.org/licenses/>.

About

Aqloss is a music player built around a Rust audio engine, with optional WASAPI Exclusive mode on Windows for bit-perfect output to compatible hardware.

Topics

Resources

Contributing

Stars

36 stars

Watchers

0 watching

Forks

Releases

Sponsor this project

Used by

Contributors

Languages