Troubleshooting
Start with Diagnostics. It checks what Sona needs and tells you what is wrong.
Check Sona
Section titled “Check Sona”- Open Settings → Diagnostics.
- Read the verdict. It covers the playback host, the Widevine download, the database and the keyring.
- Choose Check again after you fix something.
Each problem or warning says what to do. If Sona says your sign-in is stored unencrypted, your system has no working keyring. See Privacy and Security.
Find the logs
Section titled “Find the logs”Settings → Diagnostics → Open log folder opens the folder. The log is sona.log:
| System | Location |
|---|---|
| Linux | ~/.local/state/sona/ (or $XDG_STATE_HOME/sona/) |
| macOS | ~/Library/Application Support/Sona/State/ |
| Windows | %LOCALAPPDATA%\Sona\State\ |
Report a bug
Section titled “Report a bug”- Choose Copy diagnostics in Settings → Diagnostics. Sona copies a report and removes tokens and your email address. It also saves a copy in the log folder.
- Open the bug report form.
- Choose your platform and how you installed Sona. Describe what happened and the steps to reproduce it.
- Paste the diagnostics, and check them for anything personal.
For a question rather than a bug, ask in Discussions.
For a security problem, do not open an issue. See Privacy and Security.