Usage Documentation & FAQ

[jeffvli]

What hotkeys are there?

Currently supported hotkeys are:

• Ctrl + Shift + = - Zoom by 5%
• Ctrl + Shift + - - Unzoom by 5%
• CTRL+F - Target search bar
• CTRL + A - Select all rows when on list view
• DELETE - Removes selected rows when on Now Playing or Playlist
• BACKSPACE - Navigates back a page
• Media Key Play/Pause / Next / Prev / Stop
  • macOS will require that you add sonixd as a trusted accessibility client for media keys to work

MPRIS
The following commands are supported for MPRIS:

• quit, stop, pause, play, playpause, next, previous, position, seek, volume, shuffle, loop

How does playlist saving work?

Subsonic

With playlists less than 400 tracks, the playlist is safely saved using the /createPlaylist endpoint while passing through all the entries in order.

With playlists greater than 400 tracks, the entire playlist is first emptied and then the tracks are added back in batches of ~300 tracks at a time using the /updatePlaylist endpoint. The Subsonic API does not have a native way of re-ordering tracks so this measure needs to be used to successfully modify playlists. Obviously this can be a dangerous action if your network connection is unstable or your application closes while saving. There are a few measures in place to catch errors and restore your playlist, but it's not perfect.

Jellyfin

Saving a playlist in Jellyfin follows these steps:

1. Creates a new playlist with the updated local playlist data
2. Deletes the existing playlist
3. Writes the deleted playlist's metadata (name, date created, etc.) to the new playlist

How do I multiselect rows?

Multiselecting can be performed in multiple ways on any list-view (music, playlist, album, etc.)

1. Hold down click from your start row and drag to your desired end row
2. Click a row, hold down shift and click your desired end row
3. Ctrl + Click your desired rows

How do I drag and drop rows?

Drag-n-drop works in the list-view for songs in the Now Playing and Playlist pages. The column # is the drag-n-drop column and needs to be clicked and dragged to another row in that column. If you start the drag from an already-selected row, then it will drag all current selected rows. If you start the drag from a non-selected row, it will drag only the newly selected row.

My played tracks aren't being displayed on the server?

For Jellyfin and Navidrome, the Enable scrobbling checkbox needs to be enabled on the Player config. This will send your currently playing, and played songs to the server.

What are the conditions for scrobbling?

There are separate scrobbling conditions for the gapless player (fade duration is 0) and the crossfade player (fade duration is not 0).

Gapless:

1. 4 minutes OR 90% played
2. Not in the last 2 seconds

Crossfade:

1. 4 minutes OR (Song duration - fade duration - 15 seconds) played
2. The current track is not fading into the next track (This means if you skip to the end of the song, it won't send a scrobble. You will need to skip to before the fade starts.)