[!IMPORTANT] Sonora is not a piracy tool.

Sonora is not a platform for obtaining or sharing copyrighted material. We will not implement any functions that can be used to export decrypted streams, DRM licenses, content keys, or to convert protected streams into media files.

Sonora is not designed to circumvent subscriptions or other restrictions put in place by music streaming platforms. If the service demands that you have a valid subscription in order to play back their tracks, so will Sonora.

Features aimed at ripping, downloading, distributing, or gaining access to protected streaming content are out of scope for the project.

Installation

macOS

Install with Brew:

brew install --cask nolight132/tap/sonora

After installing (thanks Apple):

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

Or install the disk image, which updates itself.

Linux

Arch

Install from the AUR with your AUR helper of choice:

yay -S sonora-bin

Or:

yay -S sonora

Flatpak

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

AppImage

Download from the latest release, make it executable and run it:

chmod +x sonora-*.AppImage
./sonora-*.AppImage

Nix

Add either of those inputs:

inputs.sonora.url = "github:sonorahq/sonora";

inputs.sonora.packages.${system}.default     (prebuilt where available, else from source)
inputs.sonora.packages.${system}.sonora      (same as default)
inputs.sonora.packages.${system}.sonora-bin  (prebuilt, x86_64-linux, aarch64-linux, aarch64-darwin)
inputs.sonora.packages.${system}.sonora-src  (always built from source)

Building from source on macOS needs Xcode added to the Nix store, because the shaders compile with Apple's Metal compiler.

Configuration with Home Manager is provided by the module under programs.sonora.

Windows

Installer

Download and run the installer, or the ARM installer on Windows on ARM.

Portable

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

Nightly

Nightly builds are available.

brew install --cask nolight132/tap/sonora-nightly
yay -S sonora-nightly-bin
nix run github:sonorahq/sonora/nightly

Community

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

Translations

Language	Translated	Coverage
English (en-US)	1216/1216	100%
Deutsch (de)	1103/1216	91%
Español (es)	1103/1216	91%
Français (fr)	1104/1216	91%
Italiano (it)	1103/1216	91%
Bahasa Indonesia (id)	1103/1216	91%
日本語 (ja)	1103/1216	91%
Русский (ru)	1149/1216	94%
Українська (uk)	1105/1216	91%
Polski (pl)	1105/1216	91%
Čeština (cs)	1103/1216	91%
Português (Brasil) (pt-BR)	1103/1216	91%
简体中文 (zh-CN)	1103/1216	91%
Türkçe (tr)	1103/1216	91%
Shqip (sq)	1103/1216	91%

Star History

Credits

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 :)

Code signing policy

Free code signing provided by SignPath.io, certificate by SignPath Foundation.

The Windows executable and installer are built by GitHub Actions from this repository and signed through SignPath.

• Reviewers: members of sonorahq
• Approvers: @nolight132

License

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.