Frequently Asked Questions
Everything you need to know about GuestDJ.
Do I need to download an app?▼
No! GuestDJ works entirely in your browser. No app to download — just open the website on your phone, tablet, or computer and you're ready to go.
How do guests join my session?▼
When you start a session, you get a unique 5-character code (like "ABCDE"). Guests go to the website and enter this code to join your session and start requesting songs.
No account needed — guests just enter the code and they're in!
Do guests need to create an account?▼
No! Guests don't need an account or to download anything. They simply enter your session code and can start requesting songs immediately.
How does 'Request Only Mode' work?▼
Request Only Mode disables the built-in music player. The app becomes a pure request management system where you approve requests to build your setlist.
Key differences:
- Player Hidden: The music controls are hidden to avoid confusion.
- No Now Playing: Guests and displays will not see current track info.
- Queue becomes 'Accepted': Your Queue acts as a list of approved songs to play.
- External Playback: You play the music using your own DJ software or hardware.
What's the difference between All-in-One and Request Only?▼
All-in-One: Play music directly from our built-in player. Everything syncs automatically — guests can see what's playing now, and you can approve a request and play it directly from the dashboard.
Request Only: You use the app mainly to receive requests. Approved requests are added to a playlist on Apple Music, but you control playback externally.
Note: In Request Only mode, guests won't see a live "Now Playing" status unless you manually update it, because the app isn't controlling the music.
What is the Display Mode?▼
Display Mode lets you show a large-screen view for your event — great for TVs, projectors, or venue screens.
It can show the session code, trending requests, and what's playing (or recently played if Apple Music is playing externally).
How do I open the external display?▼
Open Settings → External Display and click Open Display. It opens in a new window you can move to a second screen.
Tip: double-click the display to toggle fullscreen.
Note: The External Display option only appears on desktop devices. On mobile, you control the session from the dashboard only.
How do I connect Apple Music?▼
Sign in as a host and tap Connect Apple Music. Approve access when prompted.
You can disconnect anytime in Settings.
What are Sponsor and Wedding modes?▼
These are optional display layouts for events. Sponsor mode highlights a sponsor message/logo and a QR code. Wedding mode shows names and a date.
You can enable them in Settings > External Display.
How do I end a session?▼
Open Settings and tap End Session. This closes requests for guests and ends the current session.
What happens when no music is playing?▼
If playback stops, the display shows a friendly Silence Mode poster until music resumes.
Does playback work if my phone screen is off?▼
Yes, as long as music is playing. If the queue has songs, they will keep playing in the background.
However, if the queue runs empty: Your phone's browser may enter "sleep mode" to save battery. Any new requests (even with Auto-Accept) might not start automatically until you open the browser tab again.
Recommendation: To ensure the music never stops, we recommend keeping the browser tab (music player) open and your screen ON.
How do I switch between DJ and Guest mode?▼
Use the links at the bottom of each entry screen: Host a Session or Switch to Guest Mode.
You can always go to /dj for hosting and /guest for guest access.
Can guests edit or cancel a request?▼
Not yet. Once a request is submitted it can’t be edited or removed by the guest.
The DJ can still reject or remove requests from the queue.
What happens when the DJ enables Auto-approve?▼
All new requests are automatically accepted and added to the queue.
The DJ can turn this off anytime in Settings.
What is the cooldown timer and how does it affect guests?▼
The cooldown limits how often each guest can submit a request.
After a request, the guest must wait for the cooldown to finish before requesting again.
How does voting and trending work?▼
Guests can vote on pending requests. Tracks with more votes appear in Trending.
Votes don’t auto‑approve a song, they only influence visibility.
How do I resume a session after closing the tab?▼
If you are signed in as the DJ, the session resumes automatically when you return.
GuestDJ saves your playback position every few seconds. If you refresh the page or close the browser, playback resumes from exactly where you left off — same song, same position. Your queue, request history, and all session data are stored in the cloud and restored automatically.
Playback state is preserved for up to 4 hours, so you can close the browser and come back later during the same session.
What if Apple Music authorization expires?▼
You’ll be prompted to reconnect Apple Music.
Open Settings and tap Connect Apple Music again.
Do requests sync across devices in real time?▼
Yes. The DJ dashboard and guest views stay in sync live.
What does the Refresh Playlist button do?▼
The Refresh Playlist button reloads your Apple Music playlist from the server.
When to use it:
- If songs you added externally (on Apple Music) don't appear in the dashboard
- If the queue looks out of sync with your actual playlist
- After network issues or if the app was in the background for a while
It's a quick way to make sure the dashboard shows exactly what's in your playlist.
Is there a limit on the number of requests per session?▼
There is a rate limit to prevent spam, and you can also use cooldowns.
If you need higher limits, contact us.
Can I block specific songs or artists (not just genres)?▼
You can restrict requests to specific artists using Artist Mode.
Blocking individual songs is not supported yet.
How do I change the session code?▼
Session codes are generated when a session starts and can’t be changed.
To get a new code, end the session and start a new one.
What data is stored after a session ends?▼
Requests and queue data are removed when a session ends.
We do not keep guest identities after the session.
Does GuestDJ work with Apple Music?▼
Yes! GuestDJ is built on Apple Music. Connect your subscription and your guests can search and request from the full catalog.
Can I use this with DJ software like djay or Serato?▼
Yes! With "Use as Request Only" mode, approved requests are added to a playlist on Apple Music. DJ apps like djay, Serato, and Rekordbox can access your Apple Music library, so you can mix the requested songs professionally.
What display customizations are available?▼
We offer several display modes for the big screen:
- Default — Clean, modern display with animated turntable and picture disc album art
- Hi-Fi — Audiophile-inspired design with turntable, tonearm tracking, and warm tones
- SingAlong — Real-time synced karaoke lyrics on the big screen
- Jukebox — Retro pub-style with neon and vinyl aesthetics
- Wedding — Elegant design with custom couple names and dates
- Sponsor — Feature logos and messages for corporate events
All display modes show a progress bar, spinning vinyl art, and the Up Next song.
How does the request queue work?▼
When guests request songs, they appear in your pending requests list. You can:
- Approve — adds the song to your queue
- Reject — removes the request
- Auto-approve — automatically approve all requests (toggle in settings)
Guests can also vote on pending requests to help you see what's popular!
DJs can also add songs directly to the queue. Approved requests always get top priority in the queue.
How does queue priority work?▼
The queue automatically sorts songs by priority:
- Guest requests — Always shown first (oldest request at top)
- DJ-added songs — Shown after requests
- Playlist songs — Shown last
This ensures guest requests are always prioritized, while still allowing you to add your own songs and maintain a backup playlist.
Can I switch playlists during a session?▼
Yes! Click the Load Playlist button in the queue section. You can choose between:
- Add to Queue — Adds songs to the end of your current queue
- Replace Queue — Clears your queue and loads the new playlist
Guest requests and the currently playing song are preserved when replacing the queue.
How do I clear the entire queue?▼
Click the trash icon next to the "Add Song" button. A confirmation dialog will appear where you can choose to keep the currently playing song while clearing everything else.
Note: This removes all songs from the queue, including requests, DJ-added songs, and playlist songs.
Why do some songs show a 'REQUEST' tag?▼
The REQUEST tag indicates songs that were requested by guests. Songs you add yourself or songs from your playlist don't show this tag.
This helps you quickly identify which songs came from your audience!
How do I reorder songs in the queue?▼
You can drag and drop songs to change their order! Just click and hold any song card in the queue, then drag it to your desired position.
Tip: Dragging a song to the very top makes it the Up Next song.
How do I remove a song from the queue?▼
Click the trash icon 🗑️ on any song card in the queue to remove it.
You can remove both requested songs and songs you added yourself.
Can I limit how often guests can request songs?▼
Yes! You can set a cooldown timer in your session settings. After a guest submits a request, they'll need to wait (e.g., 30 seconds) before they can submit another one.
This prevents spam and keeps the queue manageable.
What is Artist/Band Mode?▼
Artist/Band Mode lets you restrict requests to only songs by specific artists. Perfect for cover bands or tribute nights where you only want requests for songs you actually know how to play!
Guests will see the artist's catalog and can only request from those songs.
How do Genre Presets work?▼
Genre Presets are pre-configured filters that block certain genres based on the vibe you want:
- Party Mode: Pop, Dance, Hip-Hop, Latin — blocks slow and mellow genres
- Rock Night: Rock, Metal, Alternative — blocks pop and hip-hop
- Lounge: Jazz, R&B, Soul, Acoustic — blocks heavy and intense genres
- Summer Vibes: Tropical, Reggae, Latin, Pop — upbeat feel-good music
You can also use Custom to manually select which genres to allow or block, or All Genres for no restrictions.
What does Panic Mode do?▼
Panic Mode temporarily pauses all incoming requests. Use it when you need to take control of the music or when the request queue is getting overwhelming.
Guests will see that requests are paused, and you can resume anytime.
What is SingAlong Mode?▼
SingAlong Mode turns your TV or projector into a karaoke screen. Real-time synced lyrics appear on the big screen as the song plays, so your crowd can sing along.
Animated prompts keep the crowd engaged:
- "Get ready to sing!" — appears during the intro before lyrics start
- "Catch your breath!" — shown during long instrumental breaks
- "Great job!" — displayed after the last lyric line
Enable it from Settings > Display Mode > SingAlong. Most popular songs have synced lyrics available. If a song doesn't have lyrics, the display automatically falls back to album art.
Can guests see lyrics on their phones?▼
Yes! When the DJ enables lyrics, guests see synced karaoke-style lyrics on the Now Playing screen on their phones in real time.
Guests can rotate their phone to landscape for an immersive full-screen lyrics experience. Toggle this in Settings > Show Lyrics to Guests.
What if I don't have an Apple Music subscription?▼
GuestDJ requires an active Apple Music subscription to play music. When you connect Apple Music, the app checks for a valid subscription.
If your subscription has expired or isn't active, you'll see a clear message explaining what's needed. Guests can still search and request songs, but playback won't work without an active DJ subscription.