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.

---

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.

---

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.

---

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.

---

Deleting a Playlist

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

---

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.