XStarWake Media Player

Endpoints

• GET / – This page.
• GET /MUSIC/CONFIG – Web UI: upload MP3s, select single/playlist, set chunk duration & volume.
• GET/POST /MUSIC – Main trigger; extends playback window by configured seconds.
• GET/POST /MUSIC/RESET – Reset play clock to 00:00 and stop playback.
• POST /MUSIC/NEXT – Advance to next song (playlist or single loop).
• GET /MUSIC/STATUS – JSON status for overlays/automation.
• GET /MUSIC/OVERLAY – Audio-only overlay (hidden timer, no on-screen text).
• GET /MUSIC/OVERLAY/VERBOSE – Overlay with timer display: MM:SS | MM:SS.

How it Works

Each request to /MUSIC extends playback by chunkSeconds (configured in /MUSIC/CONFIG). Multiple hits stack. When the window expires, audio pauses but holds its position, so the next trigger resumes from where it left off.

You can run in single-song mode (loop one track) or playlist mode (ordered or randomized non-repeating). Playlist loops when complete; random mode reshuffles each cycle.

Overlays

These endpoints are designed for OBS browser sources or standard browsers:

• /MUSIC/OVERLAY – Completely blank, audio only.
• /MUSIC/OVERLAY/VERBOSE – Shows currentTime | duration.

In normal browsers, you get a one-time "CLICK TO ENABLE MUSIC" gate to satisfy autoplay rules.
In OBS, the gate is hidden and audio is auto-armed.