Providers

Sonora signs in to one streaming service at a time, and your local files are always there next to it. Switching services clears the queue, so finish what you're listening to first.

Spotify

Signing in opens Spotify's login page in your browser. Once you approve, the browser hands the session back to Sonora through 127.0.0.1:8989, so nothing else can be using that port.

  • You need Premium. Spotify turns free accounts away at sign-in.
  • If you are getting a "Spotify is not granting this account playback keys" error each time you try playing a track, Spotify won't work for you in Sonora. See issue 1649 in librespot.
  • A region error means Spotify won't serve your account from where you're connecting.

Spotify Connect and Jams

Sonora appears as a device in Spotify's other apps, so you can control it from your phone. To turn this off, use SettingsPlaybackShow as a Spotify device.

The Sessions button in the player bar switches playback to another Spotify device and back. While another device plays, the button shows that device's icon. Jams are in its Spotify Jams submenu, see Sessions. To hide Sonora's Discord status while Spotify Connect plays, turn on SettingsIntegrationsDiscordHide during Spotify Connect.

YouTube Music

There are three ways to log in: a Google login window, pasting your cookies manually, or guest mode. None of them needs Premium.

Apple Music

Sign in through the Apple Music window, or paste the media-user-token cookie from music.apple.com. Playback needs the Widevine module.

Deezer

Sign in through the Deezer window or paste your arl cookie.

Tidal

Signing in opens link.tidal.com in your browser with a code. Approve it there.

Subsonic and Navidrome

Enter the server address, your user name and password. Leave out the scheme and Sonora assumes http://, so type https:// yourself if your server has TLS.

Lyrics stored on the server, such as ones embedded in your files, are used too.

Local files

Add folders under SettingsProvidersMusic folders. Sonora scans them, subfolders and symlinks included. After the first read it only checks files whose size or date changed, so later scans are quick. It doesn't watch the folders while it runs, though. Hit Rescan after you add music.

  • MP3, FLAC, M4A, MP4, AAC, OGG, Opus, WAV, AIFF, WavPack, APE, WebM and MKA are supported.
  • A track with several artist tags shows each artist separately. Sonora never splits a single tag on commas, ampersands or "feat.", and artist names that differ only in capitalization count as one artist.
  • Covers are loaded from the embedded art, or from cover.* or folder.* in the same folder. Use JPG, JPEG, PNG or WebP. Artist pictures come from a scanned folder whose name matches the artist, using artist.*, folder.* or cover.* in those formats.
  • Lyrics come from a .ttml or .lrc file next to the track, or from the tags.

Importing and exporting playlists

Import an M3U or M3U8 file with Import playlist… on your local Playlists page, from its button or right-click menu. Songs that aren't in your library are left out. To export a local playlist, right-click it and choose Export playlist…. An export saved next to your music lists songs by relative path.

Editing tags

Right-click one local track and choose Edit tags. Saving writes the changes to the audio file and updates the library. The album artist tag controls album grouping. If it is missing, tracks with the same album name in the same folder stay together even when their track artists differ.

Local lyrics

Enable Local under SettingsLyricsLyrics sources to use lyrics from a track's tags or a matching .ttml or .lrc file. TTML files and TTML in the lyrics tag can be timed word by word. Drag the sources to rank them. Synced lyrics beat plain text, and among synced lyrics the higher source wins, even when a lower one has them word by word.

To keep your local track metadata off online lyrics services, turn off SettingsLyricsLook up lyrics for local files. Lyrics from your files still work.

Audio quality

Pick a level in SettingsPlaybackStreaming quality. If your plan or the track doesn't have it, the next level down plays.

ProviderLevels
SpotifyHigh: Vorbis 320 kbps. Normal: 160 kbps. Low: 96 kbps.
YouTube MusicHigh: AAC up to 256 kbps with Premium. Normal: 128 kbps. Low: 48 kbps.
Apple MusicHigh: AAC 256 kbps. Low: 64 kbps.
DeezerLossless: FLAC 16-bit 44.1 kHz. High: MP3 320 kbps. Normal: MP3 128 kbps.
TidalHi-res: FLAC up to 24-bit 192 kHz. Lossless: FLAC 16-bit 44.1 kHz. High: AAC 320 kbps. Low: AAC 96 kbps.
Local filesThe file as it is

For Subsonic and Navidrome, set Stream format to MP3, Opus or AAC and a Maximum bitrate to have the server convert tracks. To keep music for offline use, see Downloads and offline.

Widevine

Apple Music streams are encrypted and need Google's Widevine module. A copy downloaded from Google is used first, then one from a browser such as Chrome, Edge, Brave, Vivaldi, Chromium or Firefox.

To download Google's copy, use SettingsPlaybackWidevine module. Do this if no browser has the module or if Apple Music tracks fail because the browser's copy is out of date. Widevine only exists for x86_64 and arm64.