Technical Documentation · v1.4.6
System Manual
Complete reference for the Masterman Studios DJ Request System - all interfaces, all features.
System Overview
What is the DJ Request System?
The Masterman Studios DJ Request System is a real-time, cloud-based song request platform. Guests submit requests from any device. DJs manage an instant-updating queue. Everything syncs live with no page refresh required.
Clientside.html
Guest-facing request portal. Any phone or tablet.
VIP.html
Priority request portal for authorized VIP accounts.
Admin.html
Mobile admin panel. Designed for booth tablets and phones.
AdminD.html
Full-featured desktop command center. Widescreen optimized.
Guest App
Clientside.html - the guest-facing request portal
01. Making a Request
Open Clientside.html on your phone or tablet. No app install required.
Type the Song Name and Artist. Both fields are required.
Optionally add your Name and Shoutout in the Personalize section.
Tap Send Request. Added to the DJ's live queue immediately.
🛡 Security Check - A silent Cloudflare Turnstile check runs automatically. No guest action needed. The form is gated until it passes.
⚠ Duplicate Prevention - If the same song was requested in the last 30 minutes, submission is blocked with an alert.
⏱ Request Cooldown - After submitting, the button shows a 2-minute countdown. Persists across page refreshes to prevent spam.
⚠ If the request form is not visible - the DJ has temporarily closed requests. A 🔒 Requests Paused message will appear.
02. Live Status Tracking
After sending a request, a real-time status indicator appears below the form.
Request Pending - Your request is in the queue, waiting for the DJ.
✅
Request Accepted! - The DJ has confirmed your song. Get ready to dance.
💡 Your request status is remembered in your browser session.
03. DJ Lineup (Up Next)
When the DJ enables Guest Lineup, an Up Next section appears at the top of the page.
✦ This lineup is controlled entirely by the DJ.
04. Song Autocomplete
When autocomplete is enabled, typing shows a live dropdown of matching tracks with album art.
Suggestion mode - Dropdown appears as you type. Click a suggestion to fill both fields, or type freely.
Enforce mode - You must select a track from the list. Free text entry is disabled.
Off - No suggestions appear. The song field behaves as a standard text input.
💡 Selecting a track from autocomplete may pre-fill BPM, duration, and release year visible to the admin.
05. Trending & Public Voting
The Trending Requests section shows songs the DJ has pushed to the public vote.
💡 Voting is a one-click toggle. Each device gets one vote per song.
VIP Priority Portal
VIP.html - priority requests for authorized accounts
Accessing the VIP Portal
The VIP Access button appears on the Guest App only when VIP Mode is enabled by the DJ.
🛡 Login Security - VIP login requires a Turnstile challenge. May show a brief interactive challenge if risk is elevated.
⚠ Duplicate Prevention - Same 30-minute duplicate window applies system-wide, not just per VIP user.
⏱ VIP Cooldown - VIPs get a 1-minute cooldown vs. 2 minutes for guests. Countdown is shown live on the button.
Admin Mobile
Admin.html - booth-ready mobile management panel
Admin Mobile provides the core DJ controls in a touch-optimized layout.
System Live / Closed
Opens or closes guest requests globally.
Voting On / Off
Enables the public trending vote queue visible on Clientside.
Confirm / Delete
Confirm marks a request accepted. Delete removes it permanently.
Admin Desktop
AdminD.html - the full command center
Login & UI Selection
Enter your master admin email and password. Local preferences (theme, layout, etc.) load automatically on every login.
Queue Bar & Sort Controls
The queue toolbar contains sort controls that re-order requests instantly without any server round-trip.
Oldest
Default. Longest-waiting at top.
Newest
Most recently submitted shown first.
Top Voted
Sort by public upvotes, highest to lowest.
💡 Sort order is local - it does not affect what guests see.
Button
+ Add Track
A sidebar button that opens the Add Track popup. Bypasses the guest form. Only visible with the Can Add Tracks permission.
Toggle
Voting Interval
In the Request Behavior section of the sidebar. Enables a timed voting cycle with configurable 1–30 minute intervals.
Up Next - DJ Lineup Panel
The DJ Lineup system lets you build an ordered setlist. Two separate controls govern admin visibility and guest visibility independently.
Understanding the Two Controls
Guest Lineup (Sidebar)
Global setting. Controls guest visibility. The lineup order is saved here.
Up Next Panel (Settings)
Local setting per account. Controls admin-side panel visibility only.
Building Your Lineup
Enable the Up Next Panel in Local Settings → Layout → Up Next Panel.
Click ↑ Up Next on any request card to add it. The track disappears from the main queue to avoid duplication.
Each item shows the song, artist, and metadata pills - BPM, duration, VIP badge - at a glance.
Drag the ⠿ handle to reorder your playlist. New order saves automatically.
Click ✕ to remove a track. It returns to the main queue.
When ready, enable Guest Lineup in the sidebar and click Save Changes to publish.
Add Track Popup
The + Add Track button opens a modal to manually inject any song - no guest submission required. Useful for verbal walk-in requests or filler tracks.
Using Add Track
Click + Add Track in the left sidebar. The popup appears over the queue.
Type the Song Title. Click a suggestion to auto-fill title, artist, and metadata (BPM, duration, year).
Fill in the Artist field if not auto-populated.
Optionally enter a Requester Name. Appears in the admin queue card like any normal request.
Click Add to Requests or ↑ Add to Up Next to direct the track where you want it.
Autocorrect Toggle
Disables browser spellcheck on the song field. Useful for stylized names or foreign-language titles.
Metadata Preview
Shows BPM, duration, and release year badges when a track is selected from autocomplete.
Permission Required
Only visible with the Can Add Tracks permission. Sub-admins without it see nothing. Master Admin always has access.
Request Cards
Confirm
Marks the request confirmed. Guest sees ✅ Accepted in real time.
Delete
Permanently removes the request. Cannot be undone.
Add to Vote
Pushes the request to the public voting queue on Clientside.
↑ Up Next
Adds the track to the DJ Lineup. Card disappears from main queue to avoid duplication.
Card Indicators:
━ Gold stripe = VIP request
━ Green stripe = Confirmed
▲ count = Public vote tally
━ Orange stripe = Played
Source Button - Every card has a Source button. Opens a search popup with YouTube, Spotify, SoundCloud, Beatport, and TIDAL.
Public Display Panel
The 📺 Display button opens Display.html as a full-screen overlay inside Admin Desktop.
Fullscreen
Pushes the display into true browser fullscreen. Ideal for projecting onto a venue screen.
Close
Dismisses the overlay. The underlying Display.html continues running unaffected.
Panel Mode vs Popup
Panel mode (embedded) or standalone popup. Popup mode is ideal for second monitors.
💡 Projector Setup - Open in panel mode first to verify, then Fullscreen to project. Now Playing updates in real time.
Local Settings Drawer
Open with ⚙ Settings in the top nav. Settings persist per account. Only affect the Admin Desktop view.
Theme
Default / Darker / Midnight Blue / High Contrast. Live preview on select.
Density
Compact / Comfortable / Spacious queue card spacing. Preview applies immediately.
Left Sidebar
Always visible or Start collapsed. Use collapsed on smaller screens to maximize queue space.
Up Next Panel
Enables the Up Next tab. Full-height draggable DJ lineup. Independent from guest view.
Performance Mode
Disables CSS animations. Use on low-power hardware.
Auto-Move to History
Auto-archives Played songs after a configurable delay (1–30 min). Saved per account.
Show History Panel
Adds a History tab. Toggle without losing archived data.
Source Preselection
Choose a default streaming service. Skips the picker popup and opens that service directly. Saved per account.
History System
The History system marks songs as Played and auto-archives them after a configurable delay. Keeps the active queue clean.
Played Button
Marks the song as played. Adds an orange stripe. Auto-transfers to History if Auto-Move is enabled.
Restore
In the History tab. Moves the entry back to the active queue. Useful for mistakes.
Security & Cloudflare Turnstile
The system uses Cloudflare Turnstile across all pages as a bot-protection layer.
Managed Mode
Used on all admin and VIP login forms. Widget completes automatically in most cases; may show a brief challenge if risk is elevated.
Non-Interactive Mode
Runs silently in the background on guest and VIP submission forms. Guests never see a challenge. Form gates on completion.
✦ Where each mode applies - Managed: all admin logins + VIP login. Non-Interactive: guest request form + VIP submission form.
⚠ Turnstile Keys - Site keys are safe to include in client-side pages. Secret keys must never be placed in client-facing code.
VIP User Management
Master Admin only - Service Admin tab
The Master Admin can add and remove VIP users directly from the Service Admin tab - no external tools needed.
Adding a VIP User
Open the Service Admin tab in Admin Desktop (Master Admin only).
Scroll to the ★ VIP User Management section at the bottom.
Enter the VIP user's email address and click Add VIP. Added immediately.
Ensure VIP Mode is enabled in the sidebar so the login button is visible on the guest page.
Removing a VIP User
Each listed email has a Remove button. Prompts for confirmation. Change takes effect immediately.
✦ VIP Credentials - VIP users log in with their regular system account. Create the account first, then add their email here to grant VIP access.
Sub-Admin Management
Service Administration - Master Admin only
The Service Admin tab lets the Master Admin grant limited dashboard control to trusted assistants - without giving them full system access.
How to Add a Sub-Admin
Open the Service Admin tab in Admin Desktop (Master Admin only).
Create an account for the sub-admin and obtain their UID. Enter their email and UID, tick permissions, click Save Sub-Admin.
Share the AdminD.html URL and their credentials. The panel auto-restricts to their permissions on login.
Permission Flags
Can Delete
Allows permanent deletion of requests. Without it, the Delete button is locked 🔒.
Can Toggle System
Grants access to the Live/Closed toggle in the sidebar.
Can Toggle VIP
Grants access to the VIP Mode toggle in the sidebar.
Can Toggle Voting
Grants access to the public Voting toggle. Base card actions always available.
Can Toggle Guest Lineup
Grants access to the Guest Lineup visibility toggle in the sidebar.
Can Change Venue Name
Allows editing and saving the venue name. Without it, the field is locked and dimmed.
Can Set Background
Allows the sub-admin to update the guest page background image URL.
Can Manage Up Next
Allows adding tracks to and reordering the DJ Lineup (Up Next) panel.
Can Use Mobile UI
Allows signing into Admin Mobile. Access denied at login if this flag is off.
Can Add Tracks
Shows the Add Track popup button. Sub-admin can manually add tracks to the queue or Up Next.
Can Change Suggestion Settings
Reveals the Autocomplete section in the sidebar. Hidden entirely without this permission.
✦ Permission Groups - 11 flags organized into two visual groups: Queue & System and Display & Tools. Grouping is visual only - all flags work independently.
✦ Locked Buttons - When a permission is missing, the button is dimmed with a 🔒 tooltip on hover. Clicking shows an alert instead of acting. No hidden controls.
Tips & Best Practices
🎛 Use Both Admin Views
Keep Admin Desktop at the booth for full view; use Admin Mobile for quick confirms on-the-fly.
📸 Background Images
Use direct image links ending in .jpg/.png/.webp. Unsplash works great.
🗳 Use Voting Strategically
Push only 3–5 requests to vote at a time. Use Top Voted sort to see the crowd favorites.
🔒 VIP Best Practices
Enable VIP Mode only when VIP guests arrive. Pre-create Firebase accounts before the event.
📋 Lineup Workflow
Build the lineup privately, then publish with Guest Lineup when ready.
💡 Share the Link
Display the Clientside URL as a QR code around the venue. No installation needed for guests.