AuxRoom

Help with errors

What each message means and how to fix it. Every error in the app has a code in square brackets, like [SP-ASLEEP]. Search for it here, or tell the host.

Joining a room

Why it happens. The code has a typo, the room was closed by its host, or the code is from an old room. Codes never contain the letters O, I or L or the digits 0 and 1, so those are always a misread.

If you are the host

  1. Share the invite link or QR code with your guests. Both are in Room Settings.
  2. If a guest reports this error, check they typed the whole code and that your room is still open.

If you are a guest

  1. Ask the host for the current code or link, or scan the QR code on their screen.
  2. Check the code carefully. It is 18 characters in three groups of six.
  3. If the room was closed, the host needs to open a new one and share the new code.

Scanning a QR code

Why it happens. You pressed Block on the camera prompt, or camera access for this site (or for the browser) is off in the phone settings.

If you are the host

  1. Allow the camera for this site in the browser or phone settings, then press Try again.
  2. Or type the invite code instead.

If you are a guest

  1. On iPhone: Settings, then Safari (or the app), then Camera, then allow the site. On Android: tap the lock icon in the address bar, then Permissions, then Camera.
  2. Or type the invite code instead.

Why it happens. The device has no camera, another app is using it, or the browser has no camera support (some in-app browsers).

If you are the host

  1. Type the invite code instead, or open the page in the phone's main browser.

If you are a guest

  1. Close other apps that use the camera, or open the page in Safari or Chrome. You can always type the invite code instead.

Why it happens. Usually a browser glitch, especially right after switching apps or granting access. Some phones need a second try.

If you are the host

  1. Press Try again. If it still shows nothing, close and reopen the page, or type the code.

If you are a guest

  1. Press Try again. If it still shows nothing, close and reopen the page, or type the invite code.

Why it happens. The camera was busy, access was interrupted, or the browser refused for another reason.

If you are the host

  1. Press Try again, or type the invite code.

If you are a guest

  1. Press Try again, or type the invite code.

In the room

Why it happens. This room is private. The host approves each guest before they can add songs or use the controls.

If you are the host

  1. This normally shows to guests who are waiting for approval. Hosts are let in automatically, so if you see it, reload the page.
  2. If it keeps showing, close the room and open a new one from the home page.

If you are a guest

  1. Wait for the host to approve you. They see a request in the Guests tab.

Why it happens. Emergency stop is on, or queue additions were turned off for guests.

If you are the host

  1. Turn Emergency stop off on the Now Playing tab to let guests add songs again.

If you are a guest

  1. Ask the host to unlock the queue.

Why it happens. The host chooses, per guest, who can play and pause, skip, seek, change volume, add songs and manage playlists.

If you are the host

  1. Open the Guests tab and change that guest's permissions.

If you are a guest

  1. Ask the host to allow it for you.

Why it happens. The host turned on location checking, and your location hasn't been confirmed yet.

If you are the host

  1. Hosts are never asked to verify, so this normally shows to guests only.
  2. To change who is checked, or how far away they can be, open the location settings in Room Settings.

If you are a guest

  1. Tap "Verify my location" and allow location access. If your browser blocked it, allow location for this site in the browser settings and try again.

Why it happens. The host limited control to a radius around the room.

If you are the host

  1. Widen the radius or turn location checking off in Room Settings.

If you are a guest

  1. Move closer to the room and verify your location again.

Queue rules

Why it happens. The host set a limit so one person cannot fill the queue. Your songs count until they start playing.

If you are the host

  1. Change or turn off the limit in Room Settings, under Queue rules.
  2. Turn on "Exempt from queue rules" for a guest you trust, in the Guests tab.
  3. As host or co-host you only get a warning, with an Add anyway button.

If you are a guest

  1. Wait until one of your songs plays, then add another.
  2. Ask the host to raise the limit if you need more.

Why it happens. The host turned on the duplicate guard. A song is blocked while it is playing, waiting in the queue, or among the last few that played.

If you are the host

  1. Change how many tracks the guard covers, or turn it off, in Room Settings under Queue rules.
  2. You can add it anyway with Add anyway.

If you are a guest

  1. Pick a different song, or try again after a few more songs have played.

Why it happens. The host keeps a block list of songs and artists. A song is refused if it, or one of its artists, is on the list.

If you are the host

  1. See and edit the list in Room Settings under Queue rules. Remove an entry to allow it again.
  2. You can add it anyway with Add anyway.

If you are a guest

  1. Pick a different song.

Why it happens. The host turned on "Block explicit songs". Spotify labels each song, and the label is what AuxRoom goes by.

If you are the host

  1. Turn it off in Room Settings under Queue rules, or use Add anyway for one song.

If you are a guest

  1. Pick the clean version of the song, or a different one.

Location

Why it happens. Very old browsers, and some in-app browsers, have no location support.

If you are the host

  1. Open AuxRoom in Safari or Chrome. Or enter the coordinates by hand.

If you are a guest

  1. Open AuxRoom in Safari or Chrome to verify your location.

Why it happens. Location is switched off, access was blocked for this site, or the device has no GPS or network signal right now (for example indoors with location services off).

If you are the host

  1. Allow location for this site, turn on location services, and try again. Or drop the pin on the map by hand.

If you are a guest

  1. Allow location for this site, turn on location services on the phone, and try again.

Why it happens. A number was typed outside those ranges, or the fields mix up latitude and longitude.

If you are the host

  1. Enter latitude first (for example 52.37), then longitude (for example 4.90).

If you are a guest

  1. That setting belongs to the host, so let them know.

Why it happens. It is switched on, but no centre point has been chosen.

If you are the host

  1. Use "Use my location", drop the pin on the map, or enter coordinates, then save.

If you are a guest

  1. That setting belongs to the host, so let them know.

Spotify and playback

Why it happens. Phones, iPhones especially, put the Spotify app to sleep soon after playback pauses. A device that sleeps disappears from Spotify, and commands sent to it fail (Spotify answers "Bad gateway" or "no active device"). AuxRoom cannot wake it.

If you are the host

  1. Open the Spotify app on the playback device and bring it to the front.
  2. Press play in Spotify for a moment, or pick the device again in Room Settings.
  3. Come back here. The room notices within a few seconds and Play works again.
  4. For a device that has to stay available, use a laptop, a speaker or an Android phone as the player. On an iPhone, turn on Background App Refresh for Spotify and turn off Low Power Mode.

If you are a guest

  1. Ask the host to open Spotify on the playback device.

Why it happens. Spotify gives every Spotify app a quota for its playback requests. When it is used up, Spotify answers "too many requests" with a wait that can last hours. Music that is already playing keeps playing. AuxRoom only cannot read or control it until the wait is over, and it stops asking meanwhile, because asking more does not help.

If you are the host

  1. Wait it out. AuxRoom picks up again by itself, and the room says how long is left.
  2. To get going right away, create a second Spotify app in the Spotify developer dashboard and connect with its Client ID and secret in Room Settings. Each app has its own quota.
  3. Meanwhile, control the music from the Spotify app itself.

If you are a guest

  1. The music keeps playing. The room works again as soon as Spotify lifts the limit.

Why it happens. Controlling playback from outside the Spotify app is a Premium feature. A free account can listen but cannot be remote-controlled.

If you are the host

  1. Use a Premium Spotify account as the host. In Room Settings, reconnect Spotify with a Premium account.
  2. If the account is Premium, check that the subscription is active in your Spotify account settings.

If you are a guest

  1. Let the host know. This one is theirs to fix, and the host steps explain how.

Why it happens. Usually a short-lived Spotify problem: the service is busy or rate limiting, the device is switching, or the device you chose is no longer the active one.

If you are the host

  1. Wait a few seconds and try again.
  2. Open Spotify on the playback device and make sure it is the one shown in Room Settings.
  3. Pick the device again in Room Settings (Host Hub).
  4. If it keeps failing, reconnect Spotify in Room Settings.

If you are a guest

  1. Wait a moment and try again. If it keeps happening, tell the host.

Why it happens. Many phones and some speakers control their own volume and ignore Spotify volume commands.

If you are the host

  1. Use the volume buttons on the device itself.
  2. To control volume from here, use a laptop or a speaker that supports Spotify Connect volume.

If you are a guest

  1. Use the buttons on the playback device, or ask the host.

Why it happens. The queue changed (the song played, was skipped or the playlist moved on) between you looking at it and tapping.

If you are the host

  1. Look at the refreshed list and tap again.

If you are a guest

  1. Look at the refreshed list and tap again.

Why it happens. Jumping to a track only works inside the playlist or album that is playing. Songs added to the queue, or something playing on its own, have nowhere to jump within.

If you are the host

  1. Start a playlist from the Playlist card first, then tap a track in its list.

If you are a guest

  1. Ask the host to start a playlist.

Why it happens. Spotify turned the saved login down. That happens when access was removed in Spotify account settings, the password changed, or the Spotify app credentials were rotated or deleted.

If you are the host

  1. Open Room Settings and use Reconnect Spotify, then sign in and allow access.
  2. If that fails, check the client ID and secret of your Spotify app on developer.spotify.com.

If you are a guest

  1. Let the host know. Reconnecting Spotify is theirs to do, and it only takes a minute.

Why it happens. You pressed Cancel on the Spotify page, or Spotify declined to continue.

If you are the host

  1. Press Connect Spotify again and choose Agree on the Spotify page.

If you are a guest

  1. Connecting Spotify is up to the host. Let them know if this keeps appearing.

Why it happens. The sign-in took too long, was opened in two tabs, or the session was reset in between.

If you are the host

  1. Press Connect Spotify again and finish within a minute, in the same tab.

If you are a guest

  1. Connecting Spotify is up to the host. Let them know if this keeps appearing.

Why it happens. The sign-in came back before any credentials existed, usually after an earlier attempt was interrupted.

If you are the host

  1. Enter the client ID and client secret of your Spotify app, then press Connect Spotify.

If you are a guest

  1. Connecting Spotify is up to the host. Let them know if this keeps appearing.

Why it happens. The most common causes: the client secret is wrong, the redirect URI is not registered in your Spotify app, or this Spotify account is not allowed to use the app yet.

If you are the host

  1. Check the client ID and secret match your app on developer.spotify.com.
  2. In your Spotify app settings, add this exact redirect URI: https://auxroom.flashba.ng/spotify/callback
  3. If you sign in with a different Spotify account than the app owner's, add that account under User Management in the app (Development Mode apps only allow a few listed users).
  4. Then press Connect Spotify again.

If you are a guest

  1. Connecting Spotify is up to the host. Let them know if this keeps appearing.

Logging in

Why it happens. A typo, the wrong account, or a password that was changed. Guests do not need an account to join a room; only hosts log in.

If you are the host

  1. Check the email and password, or use "Forgot your password?" to reset it.

If you are a guest

  1. You do not need an account to join a room. Use the invite code or link.

Why it happens. Several wrong attempts in a row. The pause protects the account from guessing.

If you are the host

  1. Wait for the time shown, then try again, or reset the password.

If you are a guest

  1. You do not need an account to join a room. Use the invite code or link.

Why it happens. Login codes last 2 minutes and work once. It was either too old, or it was already used.

If you are the host

  1. On the computer, press "Show a new code", then scan it again on your phone.

If you are a guest

  1. On the computer, press "Show a new code", then scan it again.

Why it happens. You pressed Deny on the phone, or typed the wrong number three times, which cancels the request.

If you are the host

  1. If you did not start this login, you did the right thing, and nothing needs fixing. To log in, press "Try again" on the computer and approve it on your phone.

If you are a guest

  1. On the computer, press "Try again".

Why it happens. The number proves you are looking at the screen that asked. It has to match, and three misses cancel the request.

If you are the host

  1. Look at the screen of the computer you are logging in on. It shows a large 2-digit number under the QR code. Type exactly that.

If you are a guest

  1. Check the number on the computer and try again.

Why it happens. To protect accounts, a browser can ask for 10 login codes a minute, and an account can approve 10 requests every 10 minutes. Asking again and again, or opening the login page in several tabs, hits it.

If you are the host

  1. Wait a minute and press "Log in with QR" again. If you hit the limit while approving, wait about 10 minutes.
  2. Close extra tabs of the login page, then ask for one new code and use it.

If you are a guest

  1. Wait a minute and try again.

Why it happens. The computer and the phone were both answering the same login request at once, and one had to wait. This is rare and harmless.

If you are the host

  1. Press Approve again. If it keeps happening, ask the computer for a new code and scan that one.

If you are a guest

  1. Press Approve again, or ask for a new code on the computer.

Page errors

Why it happens. You opened a host page while logged out, or your login expired.

If you are the host

  1. Log in again. Sign in from the home page.

If you are a guest

  1. Guests do not log in. Use the invite link or code to join a room.

Why it happens. The action belongs to someone else, for example closing a room you do not host.

If you are the host

  1. Check that you are logged in as the account that created the room.

If you are a guest

  1. This is something only the host can do. If you need it, ask them.

Why it happens. The link has a typo, or the room it points to was closed. Closed rooms vanish completely, including their party screen.

If you are the host

  1. Open a new room from the home page if yours was closed.

If you are a guest

  1. Ask the host for a fresh invite link or code.

Why it happens. A stale page, a bookmark to an action rather than a page, or a browser extension altering the request.

If you are the host

  1. Go back to the home page and open the page again.

If you are a guest

  1. Go back to the home page and try again.

Why it happens. The page stayed open long enough for its security token to expire. This is common when the installed app was left in the background.

If you are the host

  1. Reload the page and repeat what you were doing. Nothing was lost.

If you are a guest

  1. Reload the page and repeat what you were doing.

Why it happens. Joining, logging in and loading pictures are rate limited. Several people on one network can trip it together.

If you are the host

  1. Wait a minute and try again.

If you are a guest

  1. Wait a minute and try again.

Why it happens. A bug or a service the app depends on had a problem. It is logged with the reference ID shown on the page.

If you are the host

  1. Try again in a moment. If it repeats, send the reference ID from the error page to whoever runs AuxRoom.

If you are a guest

  1. Try again in a moment. If it repeats, tell the host and include the reference ID.

Why it happens. An update is being installed. It normally takes under a minute.

If you are the host

  1. Wait a minute and reload.

If you are a guest

  1. Wait a minute and reload.

Connection

Why it happens. Two things make screens fast: a live connection that pushes changes the moment they happen, and a background check on the server that keeps the room true to Spotify. If either is down, screens fall back to checking every few seconds. Sleeping phones, a weak connection and a restart of the server can each cause it.

If you are the host

  1. Reload the page to reconnect the live connection.
  2. If it stays amber on every device, the server's background check may be stopped. Check the Uptime Kuma monitor, or redeploy from Dokploy.
  3. The /health/watcher address says which part is down.

If you are a guest

  1. Wait a few seconds, or reload the page. It reconnects by itself.
  2. If it stays slow for a long time on every device, tell the host.

Why it happens. Wi-Fi or mobile data dropped. AuxRoom needs a connection to sync the room, and returns by itself when it is back.

If you are the host

  1. Check Wi-Fi or mobile data. Playback on the speaker is not interrupted by this.

If you are a guest

  1. Check Wi-Fi or mobile data. The room stays as it is and you rejoin automatically.