Introduction
These docs explain how Sonora works once it's installed. If you haven't installed it yet, the install steps are on the home page.
Something broken? Start with the FAQ
The FAQ covers the problems people run into most, like macOS saying the app is damaged, no sound on Linux or a Spotify account that won't sign in. Most answers are a line or two, so check there before digging through the docs.
What's in the docs
| Using Sonora | |
|---|---|
| Providers | How signing in works for each service, their quirks, and the audio quality you get. |
| Shortcuts | Every keyboard shortcut, including the ones that only exist on macOS. |
| Scrobbling | Linking Last.fm, Libre.fm, ListenBrainz and Maloja, and when a play counts. |
| Customizing | |
| Settings file | Where settings.json is, editing it by hand, and the Home Manager module. |
| Custom themes | Writing your own color theme as a JSON file. |
| When something breaks | |
| Logs | Where the log file is and how to get more detail for a bug report. |
| Getting help | Where to ask questions and what a good bug report needs. |
| About | |
| Vision | What Sonora is for, and what it will never be. |
| Roadmap | What's planned, and what has already shipped. |
Finding things
Press Ctrl K anywhere in the docs or the FAQ to search both. Results jump straight to the section that matches.