Music Library
The Music Library serves as the main entry point to your entire music collection, providing a central place to browse, search, and play your audio content.
As you navigate through folders, the layout adapts based on the type of content being displayed. Folders are labeled with their names. Playlists, images, and radio stations are additionally highlighted for easier recognition.
You can also filter the displayed content by entering text into the Search in this page box.
Browse header
Section titled “Browse header”The header of every browse page carries the cover and title of the current container, the control buttons on the left and the filters on the right. Scrolling down collapses it into a slim sticky bar that keeps both groups reachable.
Control buttons
Section titled “Control buttons”| Button | Action |
|---|---|
| PLAY | Will clear the current renderer playlist, adds all tracks and start playback. |
| SHUFFLE | Clears the current renderer playlist, adds all tracks and start random playback. |
| SWITCH VIEW | Switches to a tiles based view. Pressing this button again will cycle back to a track based view. |
| OPTIONS | Folder Options |
The like button (heart) is not part of this bar — it sits next to the album title in the header and only appears if the album is identified by a MusicBrainz Release ID (all tracks must belong to the same release).
Filters
Section titled “Filters”The right side of the header narrows down what the page shows. The filters apply to everything on the current page — folders, playlists, albums and tracks — and they are combined: an item has to pass all of them to stay visible. The section headings count what is left, and PLAY / SHUFFLE send exactly the tracks the filtered list shows, so a filtered page plays as it reads. A filter that is in use is highlighted; clicking the close icon resets it. Only the filters that make sense for the current page are displayed.
| Filter | Action |
|---|---|
| FILTER | Free text search across the titles of the current page (case insensitive, matches anywhere in the title). Nothing is requested from the server — only the displayed content is narrowed down. |
| GENRES | Multi select of the genres occurring on this page; an item is kept if it matches any of the selected ones. The button shows Any, the genre name, or how many genres are selected. Only shown if the content carries genre information. |
| RATING | Keeps only entries with exactly the chosen star rating: 5 (liked) down to 0 (disliked), or Any to switch the filter off. Requires a media server with the extended API (UMS fork). |
| SORT | Orders album tiles by Album Title, Album Artist or Genre; None keeps the order delivered by the media server. Appears only on pages that contain albums. |
Server Side Playlists
Section titled “Server Side Playlists”Configure MY PLAYLIST sidebar
Section titled “Configure MY PLAYLIST sidebar”To configure the quick access MY PLAYLISTS section, navigate to the folder containing your playlists, then click on the three dots in the header and select Set MY PLAYLISTS. The sidebar will be refreshed and the playlists are directly accessible.
Create Server Side Playlist
Section titled “Create Server Side Playlist”To create a server-side playlist, first navigate to the folder where you want the playlist to reside. Next, click the three-dot menu located next to MY PLAYLISTS. A dialog box will appear where you can enter the name for your new playlist and confirm your choice.
If you create the playlist inside the configured MY PLAYLISTS folder, it will automatically appear in the Quick Access sidebar.
Add songs to Server Side Playlist
Section titled “Add songs to Server Side Playlist”To add a song to a server side playlist, navigate to the desired song, click on the three dots to open the song options dialog, then select Add to playlist and select the desired playlist.
Delete Server Side Playlist
Section titled “Delete Server Side Playlist”Click the three-dot menu next to MY PLAYLISTS to open the options dialog. Switch to delete playlist, locate the playlist you want to remove (the search field narrows the list down) and click delete. Deleting a playlist on the media server cannot be undone, so it has to be confirmed once more.
Example usage
Section titled “Example usage”The animation shows how to create a new playlist. Because we are working inside the folder that feeds the MY PLAYLISTS sidebar, the new playlist appears there right away. After creating it, two songs are added, one of them is removed again, and finally the playlist itself is deleted.
View templates
Section titled “View templates”Album View
Section titled “Album View”
When browsing a container that contains only tracks from the same album, the interface switches to a track-based display.
Clicking on a track title will immediately play that track rather than adding it to the current playlist.
If the album is identified by a MusicBrainz Release ID, the like/dislike feature (heart icon) becomes available. Albums you mark as liked can then be quickly accessed from the My Albums section in the sidebar.
Songs can be rated from 1 to 5 stars by clicking on the desired star icon. If a MusicBrainz user account is configured in the App Settings, your ratings can be submitted directly to MusicBrainz.org.
Multi Disc Support
Section titled “Multi Disc Support”
To manage a multi-disc release, copy all audio files into a single folder. If the tracks are tagged with the correct numberOfThisDisc ID3 metadata, the songs will be automatically sorted first by disc number and then by track ID.
Playlist view
Section titled “Playlist view”
When browsing server-based playlists, the display automatically switches to a track view with small album covers. Clicking Switch View will change the display to a full-sized album view.
Song Options
Section titled “Song Options”
Clicking the three-dot menu next to a song opens the Song Options dialog. Where you can choose between server side actions and media player actions.
Server side playlist actions
- Add to playlist
- Delete from playlist
Both actions will be executed on the server side, so the changes will be reflected in the playlist file itself. The playlist has to be a m3u or m3u8 file.
Removing songs can only be done, if the current view displays a playlist file.
Player playlist actions
- Play next
- Add to queue
When the current media player is in playlist mode, selecting Play next will add the song to the playback queue in the next position, while Add to queue will place the song at the end of the current renderer playlist. If the media player is not in playlist mode, the selected song will play immediately, regardless of which action is chosen.
Other server actions
- Download
- Update album art
You can download a resource, or Update album art on the server side.
UPnP Search
Section titled “UPnP Search”If the selected media server supports UPnP search, entering text into the Global Search box will initiate a server-side search request.
Known media servers with compatible UPnP search capabilities include MinimServer and Universal Media Server (since 10.6.0). The search text is matched against tracks, albums, playlists, and artists. Artist covers are retrieved from Spotify if a connected account is available.
Clicking on a song item will play that song immediately. Clicking on any other item will navigate into that content.