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.
What's the difference between All-in-One and Use as 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.
Use as Request Only: Approved requests are added to a playlist in your streaming service. You then play from your own app or DJ software.
Note: With Apple Music, there's a limitation where we can't read what's currently playing in the external app, so guests won't see "Now Playing" info in this mode.
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.
Why does the display show 'Recently Played' instead of 'Now Playing'?▼
If you play music from the Apple Music app (external playback), Apple doesn't let web apps read the current track.
In that case we show the most recent track as Recently Played so the screen still stays alive.
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.
You can also reopen it from the DJ dashboard.
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 (in the Apple Music app) 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.
Which streaming services are supported?▼
Currently supported: Apple Music
Coming soon: Spotify
We're working on adding more streaming services. Stay tuned!
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 in your streaming service. DJ apps like djay, Serato, and Rekordbox can access your 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 song display
- 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
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.
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.