🎵 Music Player Configuration

The Music Player plays a rotating playlist during the loading screen, complete with track titles, artist names, and optional cover art.

Customize your music experience by modifying the music array in your configuration file.

---

JSON Structure

"music": [
  {
    "path": "./assets/mp3/1008gs.mp3",
    "title": "1008 Grams",
    "artist": "OT7 Quanny",
    "image": null
  }
]

Field Breakdown

Field	Description
path	Path to the .mp3 audio file to be played
title	Display title for the track (shown in the UI)
artist	Display artist name
image	(Optional) Path to an image or album art to show for this track (set to null if unused)

Audio Format Support

Only .mp3 files are supported at this time. Make sure all audio files are properly encoded and placed under assets/mp3/.

Track Rotation

Tracks rotate automatically in order. The player includes play, pause, skip, and volume control functionality.

Optional Album Art

If you'd like to show cover art or thumbnails per track, provide the image field:

"image": "./assets/path/to/cover_art.png"

Image files should ideally be square (1:1 aspect ratio) and under 500KB for fast load times.

Optional Default Volume Setting

To set the initial volume level of the music player, add the following entry to your config:

"defaultVolume": 100

This value accepts a number from 0 to 100, representing the percentage volume on first load.

Music Player UI Preview

Automatic Music Player Hiding

The music player tab is automatically hidden if the music array is empty ([ ]) or omitted entirely from the config. To disable the music player, simply remove the music entry or ensure the array contains no entries.

---