Music Drop

Welcome to the music request app.
Quick Actions

Request a Song

Requests open

My Queue

Songs you've added this session
You haven't added any songs yet.

Dashboard

Live request activity and current operating status.
Open
Waiting for songs to be added…

Request as Admin

Add songs to the moderation queue with admin override rules.

My Admin Queue

Songs you've added this session
You haven't added any songs yet.

Requests & Queue

Moderate requests, manage the active queue and queue-level behaviour.
Queue Behaviour
Auto PushSongs go straight to Spotify when submitted. Manual moderation is bypassed.
Spotify Playlist Actions
Shuffle on pushRandomise order when pushing songs to Spotify.
Requested Songs

Playlist Manager

Edit playlist order, push to Spotify and manage playlist backups.
Playlist Manager
Playlist actions
Remove removes the song from the Playlist Manager only. Spotify is unchanged until you use Push Order to Spotify.
⚠ Live Remove immediately removes the song from the live Spotify playlist. Only use it for urgent changes while music is already playing. The app will create a backup, capture the current playback position, remove the track, verify the change and fetch the latest playlist from Spotify.
No playlist verification run yet.
Fetch from Spotify to edit the playlist order.
Playlist Backups
No backups loaded.

User Experience

Branding, display theme, broadcast messages and user-facing prompts.

Branding & Appearance

Enable seasonal/event themeAdmin-controlled theme overlay. Users can only choose light, dark or system mode.
Music Drop

Broadcast Message

Broadcast messageShow a message on home/search pages.

Theme Suggestion & Queue Estimate

Theme suggestionOptional prompt shown to users.
Queue capacity warningWarn when queue duration exceeds available play time.

User Front End

Manage the user home page, discovery menu items and Spotify playlist pages.

Home Page

Enable Home pageIf disabled, users continue landing on the Request page.
Show Discovery on Home pageShow active custom playlist previews on the Home page.

Custom Playlist Pages

Add Spotify playlist pages to the user front-end menu. Playlist fetch works best with playlists owned by, or collaborated on by, the authorised Spotify account.

No custom playlist pages loaded.
Show request buttonsAllow users to request songs from this playlist page.

Song Rules

Rules that apply when users request songs.

Song Limits

No song limitGuests can request unlimited songs per session.

Explicit Tracks

Explicit warningWarn users before explicit tracks are added.
Explicit hard stopBlock explicit tracks for users. Admin can still override.

Long Songs

Long song warningWarn users when songs exceed the threshold.
Long song hard limitBlocks users during configured times. Admin can override.
Use hard limit time windowOnly enforce the hard limit during this window.

Duplicates & History

Duplicate detectionBlock duplicate Spotify tracks in the active queue.

Spotify

Playlist Synchronisation
How often the app fetches playlist information from Spotify and recalculates queue estimates.
Spotify Rate Limit Protection
Rate limit status not checked yet.
How long the app waits after typing stops before searching Spotify. Default is 1 second.
How long Spotify search results are cached locally. Default is 24 hours.
Minimum characters required before search runs. Default is 3.
When Spotify rate-limits the app, playlist pages and queue estimates should use the most recent cached data where available.
Spotify cooldowns are based on Spotify's Retry-After response and apply across all Spotify calls.
Spotify Authorisation
Permission status not checked yet.
This URI must be registered in the Spotify Developer Dashboard. Leave blank unless your proxy/domain requires a custom value.
Use Re-authorise Spotify after changing scopes or when Live Remove says playback permissions are missing.
Active Playlist
Loading…
Credentials
Refresh tokens are stored in SQLite after using Re-authorise Spotify. They are no longer manually entered here. Changes to Spotify credentials are saved using the floating Save Changes toast.

Schedule

Request window, open days and timezone.
Request Window
Use ScheduleWhen off, requests are open whenever not paused.
Open Days

Access

PINs, open access, session expiry and lockout protection.
Access
Open accessUsers can enter without a PIN — admin login still required.
Session Settings
Brute Force Protection

Storage & Maintenance

Persistent SQLite storage, local backups, offsite backup and maintenance mode.

Time & Locale

Used by request windows, broadcasts, maintenance, backups and other timed jobs.

Storage

Storage status unavailable.
Number of local SQLite database backups to keep before older backups are deleted.
Google Drive offsite backupKeep local storage as primary and Google Drive as secondary backup.

Google Drive / Offsite Backup

Enable Google Drive Cloud SettingsRestores settings at boot before services start, then saves changes back to Google Drive.
Cloud settings status unavailable.
SQLite Database Backup
Daily Google Drive database backupUploads a timestamped SQLite backup to Google Drive once per day.
Google Drive database backup status unavailable.
Queue Backup
Queue backup status unavailable.

Maintenance Mode

Maintenance modeDisable user searching/requesting while admin keeps access.
Show queue during maintenanceUsers can see queue but cannot request.

System Status

Watchdog status, manual task runner and recent usage analytics.

Overall Status

System status not loaded yet.

Automated Tasks / Watchdog

No task status loaded.

Manual Task Runner

Run safe maintenance tasks manually. Destructive cleanup tools stay in Danger Zone.

Usage Analytics

Analytics not loaded yet.

Danger Zone

System usage, cache cleanup and destructive maintenance tools.

System Health & Usage

Load stats to view system usage.

Maintenance Tools

Lower-risk cleanup actions. These do not delete the live queue or app settings.

Danger Zone

Destructive actions require typed confirmation. A SQLite backup is created before medium/high-risk deletions where possible.

Logs & Diagnostics

Live logs and Google Drive log capture settings.
Google Drive Log Capture
Include verbose logs in manual captureWhen enabled, Drive log capture includes request and SSE detail.
Drive log capture unavailable.
Persistent Database Logs

Important events are saved to SQLite. Debug mode temporarily saves every log event to SQLite for crash investigation.

Debug ModeWhen enabled, every log event is written to SQLite until the timer expires.
Persistent log status unavailable.
Waiting for log events…
You have unsaved changes
🅴

Explicit Content

This song has been marked as explicit. Please make sure it's appropriate for everyone before adding it to the queue.

⏱

Long Song

This song is quite long. Please consider that other users may also want to request songs.

ℹ️

Notice

⚠

Live Remove

This will remove the selected song from the live Spotify playlist.

A playlist backup will be created before removal. Spotify playback may skip or stop if this playlist is currently being used.