For the complete documentation index, see llms.txt. This page is also available as Markdown.

Browse

Browse is the main tab of the music app — the search interface where players find and play any song, add tracks to their queue, or save songs to a playlist.


Searching

The search bar sits at the top of the view. Typing a song name, artist, or album and pressing Enter (or clicking the search icon) queries YouTube Music and returns a list of matching tracks. Results include cover art, title, artist, album, and duration.

The search field has a clear button (×) that resets the results and returns to the home state.


Playing a Song

Clicking any row in the search results plays that track immediately on the active device. The row highlights to show it is the current track, and a pulsing dot replaces the track number while it plays.


Adding to Queue

Each result row has an Add to Queue button (list icon). Clicking it appends the track to the current device's queue without interrupting whatever is playing. A brief checkmark confirms the action.


Adding to a Playlist

Each result row also has a + button that opens a dropdown listing all of the player's playlists. Clicking a playlist name saves the track to it. The button gives visual feedback:

  • Checkmark (green) — track was added successfully.

  • Checkmark (yellow) — track is already in that playlist (duplicate skipped).

If no playlists exist yet, the dropdown shows a disabled message instead.


Notes

  • Search results come from YouTube Music, so any song available there can be found and played.

  • Adding to queue and adding to a playlist are independent actions — one does not affect the other.

  • The queue and playlist tabs are separate views accessible from the sidebar.

Last updated