Sonora

• Spotify, YouTube, and local playback
• Library management within supported providers
• Gapless playback
• Audio normalization
• Synced/karaoke lyrics
• Romanization
• Cross-platform support
• Custom themes

Install with Brew:

brew install --cask nolight132/tap/sonora

After installing (thanks Apple):

xattr -dr com.apple.quarantine /Applications/Sonora.app

Install from the AUR with your AUR helper of choice:

yay -S sonora-bin

sonora-bin installs the prebuilt release binary. sonora builds the same version from source instead, which takes a while on a Rust and GPUI tree but links against your own system libraries:

yay -S sonora

Either pipewire-alsa or pulseaudio-alsa is required, matching your sound server.

Add the Sonora repository once; it pulls the runtime from Flathub and updates with flatpak update:

flatpak install --user https://nolight132.github.io/sonora/sonora.flatpakref

Every release also attaches a standalone .flatpak bundle for x86_64 and aarch64 on Releases, for installing without a remote.

Just use the flake in the project root:

inputs.sonora.packages.${system}.default

The flake installs the latest tagged release binary.

Download and run the installer.

Download the latest windows-msvc.exe for your architecture from Releases.

Feel free to join our Discord server and Matrix space. Discord is the primary one, but we do have a Matrix bridge.

We have nothing against the usage of LLMs in the project — in fact, we use them ourselves. We believe that AI can speed up development in a lot of meaningful ways and be a useful tool for learning new concepts. We have also found it particularly helpful for contributing to substantial codebases such as GPUI and librespot, where it has helped us quickly locate the relevant parts of the code.

However, using AI cannot act as an excuse for failing to understand, review, and test the changes proposed. Furthermore, we expect communication with a real person, not a computer. This includes but is not limited to PR/issue text generation, comments in discussions, etc. A summary of changes can be generated and does not need to be disclosed explicitly, but the reasoning and motivation behind a change must come from the contributor and reflect their own understanding.

AI-assisted proofreading and translation of human-written text are permitted.

Sonora is built with the help of some incredible open-source projects, including:

• Zed — a wonderful editor (ab)used by all core team members. Conveniently provides gpui — their native Rust rendering stack.
• librespot — Spotify playback and library integration.
• yt-dlp — certain YouTube ideas implemented in ytmusic-rs. :)

Copyright (C) 2026 Sonora Contributors.

Sonora is free software, released under the GNU General Public License version 3 or later.

Sonora is an unofficial client and is not affiliated with, endorsed by, or sponsored by Spotify AB.

The binary also embeds the Inter typeface (SIL Open Font License 1.1) and four interchangeable icon sets: Lucide (ISC), Iconoir (MIT), Remix Icon 4.8.0 (Apache 2.0) and the Solar Linear set (CC BY 4.0, by 480 Design). Each pack keeps its licence beside its files in assets/icons. THIRD-PARTY.md lists every bundled dependency.