> For the complete documentation index, see [llms.txt](https://docs.av-scripts.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.av-scripts.com/laptop-pack/music/app/browse.md).

# 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.

<figure><img src="/files/7bVEJk94Whfvm9PUJnJE" alt=""><figcaption></figcaption></figure>

***

### 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.

<figure><img src="/files/PZ5P9TmEVRKNH5XGxJ4w" alt=""><figcaption></figcaption></figure>

***

### 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.

<figure><img src="/files/4KpIDmpoE2F8YVarHL0S" alt=""><figcaption></figcaption></figure>

***

### 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.

<figure><img src="/files/Z3XQJRiORydKIMyu2TQ6" alt=""><figcaption></figcaption></figure>

***

### 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.
