> 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/playlists.md).

# Playlists

The Playlists tab lets players create personal song collections that persist between sessions. Playlists are stored per player on the server and are available every time they open the app.

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

***

### Creating a Playlist

Clicking the **+** button in the top-right corner opens the creation modal, which has two fields:

* **Name** — required. The display name of the playlist.
* **Cover Image URL** — optional. A direct link to an image used as the playlist's cover art. A live preview is shown as the URL is typed.

Pressing **Create Playlist** (or hitting Enter while in the name field) saves the playlist and adds it to the grid.

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

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

***

### Opening a Playlist

Clicking a playlist card opens its track list, showing all saved songs with their cover art, title, artist, album, and duration. A pulsing dot marks the track currently playing.

***

### Playing a Playlist

* The **play button** (circle icon, top-right of the track list header) starts the playlist from the first song and loads all tracks into the device queue in order.
* Clicking any individual row starts playback from that track and queues the rest of the playlist after it.

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

***

### Removing a Song

Each row in the track list has a trash icon on the right. Clicking it removes that song from the playlist immediately.

<figure><img src="/files/5NVynADi1RPZgbGxkEBS" alt=""><figcaption></figcaption></figure>

***

### Deleting a Playlist

From the playlist grid, each card has a small delete icon in its corner. Clicking it removes the entire playlist permanently.

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

***

### Limits

Each playlist can hold up to **30 songs** by default (configurable via `Config.MaxSongsInPlaylist` in `config/_config.lua`).

***

### Persistence

Playlists are saved to `json/playlists.json` on the server, keyed by player identifier. They survive server restarts and resource reloads.