Skip to content
sonorahqPublic

Repository files navigation

Sonora

Changelog · Docs · Roadmap · FAQ

Build License Installs
Discord Matrix Support us

A native, familiar music streaming client

Stream from your favorite services and play local files — all in one native app.

image
image image
Adaptive themes are optional. Everything is (or will be) customizable.

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

Snap

Install from the Snap Store:

sudo snap install sonora

AppImage

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

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

Nix

Pick a channel with the input's ref and install inputs.sonora.packages.${system}.default:

inputs.sonora.url = "github:sonorahq/sonora/stable";   # the latest release
inputs.sonora.url = "github:sonorahq/sonora/nightly";  # the nightly
inputs.sonora.url = "github:sonorahq/sonora";          # main

Every channel is built for x86_64-linux and aarch64-linux and pushed to a binary cache, and stable only moves to a release once its build is there. Trust the cache and Nix downloads Sonora instead of compiling it:

nix.settings = {
  extra-substituters = [ "https://sonora.cachix.org" ];
  extra-trusted-public-keys = [ "sonora.cachix.org-1:qbPeDsvZPbwUWHpQS5Oe0bjz5oHAVscHem+MCzwrc9Q=" ];
};

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

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

{ inputs, ... }: {
  imports = [ inputs.sonora.nixosModules.default ]; # NixOS
  # imports = [ inputs.sonora.homeModules.default ]; # Home Manager
  programs.sonora = {
    enable = true;
    settings = {
      provider = "youtube";
      gapless = true;
      appearance.theme = "dark";
    };
  };
}

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) 1433/1433 100%
Deutsch (de) 1106/1433 77%
Español (es) 1104/1433 77%
Français (fr) 1105/1433 77%
Italiano (it) 1104/1433 77%
Bahasa Indonesia (id) 1427/1433 100%
日本語 (ja) 1104/1433 77%
한국어 (ko) 1428/1433 100%
Русский (ru) 1216/1433 85%
Українська (uk) 1106/1433 77%
Polski (pl) 1106/1433 77%
Čeština (cs) 1104/1433 77%
Português (Brasil) (pt-BR) 1104/1433 77%
Português (Portugal) (pt-PT) 1104/1433 77%
简体中文 (zh-CN) 1104/1433 77%
Türkçe (tr) 1433/1433 100%
Shqip (sq) 1104/1433 77%
Tiếng Việt (vi) 1339/1433 93%

Star History

Star History Chart

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.

Releases

Sponsor this project

Packages

Contributors

Languages