Changelog · Docs · Roadmap · FAQ
Stream from your favorite services and play local files — all in one native app.
|
|
|
|
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.
Install with Brew:
brew install --cask nolight132/tap/sonoraAfter installing (thanks Apple):
xattr -dr com.apple.quarantine /Applications/Sonora.appOr install the disk image, which updates itself.
Install from the AUR with your AUR helper of choice:
yay -S sonora-binOr:
yay -S sonoraflatpak install --user https://sonorahq.github.io/sonora/sonora.flatpakrefDownload from the latest release, make it executable and run it:
chmod +x sonora-*.AppImage
./sonora-*.AppImageAdd 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.
Download and run the installer, or the ARM installer on Windows on ARM.
Download the latest windows-msvc.exe for your architecture from Releases.
Nightly builds are available.
brew install --cask nolight132/tap/sonora-nightly
yay -S sonora-nightly-bin
nix run github:sonorahq/sonora/nightlyFeel free to join our Discord server and Matrix space. Discord is the primary one, but we do have a Matrix bridge.
| 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% |
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 providesgpui— their native Rust rendering stack. - librespot — Spotify playback and library integration.
- yt-dlp — certain YouTube ideas implemented in ytmusic-rs :)
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
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.