Skip to main content

​
Create room is unavailable

Work through the Role / Room / Configure / Live rail in order:
  1. On What are you doing today?, select Host a session and finish browser sign-in.
  2. Under Choose room mode, select Direct OBS Room, then Next.
  3. On Set up the room and your setlist, select a relay and Vocal source.
  4. Confirm the vocal meter responds.
  5. Select the target OBS scene and select Add Music Collab to scene.
The dock enables Create room only after sign-in, hosted access, a vocal source, and the required plugin-owned scene sources are ready. If the hosted-time footer reports no time left, add time or change plans before creating another hosted room. See Hosted time.

​
The guest key does not advance to Configure

The Music guest path has two actions:
  1. Select Join as a guest, then Continue as guest.
  2. On Connect with a guest key, enter the display name and complete Music Collab guest key, then select Continue.
  3. On Choose what the host receives, select an OBS audio source, verify its meters, and select Connect.
If Continue rejects the key:
  • Confirm it is a Music Collab key, not an ASMR Collab key or Scene Share credential.
  • Paste the complete current key. Both the readable Karaoke key and the full legacy key are supported.
  • Ask the host whether the room ended or Rotate guest key invalidated the previous key.
  • Retry after checking that both computers can reach the hosted service.

​
A saved setlist is missing

Setlists are local to the host computer; they are not stored in the room or downloaded by the guest.
  • Open the dock menu and select Setlist folder to inspect the saved JSON files.
  • From Set up the room and your setlist, select View all songs, open the menu, and select Open saved setlist.
  • Finish any active room, connection, song preparation, sharing, or backing-load task before opening another saved setlist.
  • If a local .opus or .ogg file moved, use the song’s Ready / retry action and choose the replacement in Relink backing track.
After an OBS restart, Music Collab resets an interrupted preparation to queued and rechecks local and prepared file paths. Prepare the affected songs again.

​
A YouTube song is labelled Audio only

Audio only is a supported fallback, not a failed backing track. The extracted audio prepares and synchronizes normally; vAudioLink Backing Video and Music View display the branded fallback because the video cannot be embedded. If a link is marked unavailable, it is not added to the setlist. If the availability check could not complete, go back and run Check songs again.

​
Unsupported local file

Choose an Ogg Opus backing file with an .opus or .ogg extension. Other local formats are not accepted by the current decoder.

​
A setlist song does not prepare

  • Use Prepare all on the Configure page or Prepare remaining in the full setlist.
  • For a failed row, open its menu and select Ready / retry.
  • Keep OBS open while YouTube extraction or local-file preparation runs.
  • Check free disk space and endpoint security if preparation repeatedly fails.
  • Preserve the row status and OBS log for support.

​
Stuck on sharing, receiving, or waiting for both

Only the active song is sent to the partner.
  1. Keep both peers in the live room.
  2. Confirm the participant card reports the peer connected.
  3. Keep the active song selected while its preparation and sharing finish.
  4. Wait for Ready on both before using Play.
  5. If the guest disconnected, reconnect first and allow sharing to resume or retry the active song.

​
Play is unavailable

The host Play control requires:
  • A live, joined room.
  • An active prepared song.
  • The managed scene sources.
  • No preparation or sharing task still running for that song.
  • The partner ready when a partner is connected.
If sources were removed during the room, expand Session tools and select Add missing scene sources before playback.

​
Backing track is doubled

The combined program output and another backing path are both reaching the program.
  1. Keep vAudioLink Output in the host’s stream mix.
  2. Leave vAudioLink Backing (monitor) as the monitor-only source.
  3. Check Desktop Audio, application capture, and browser capture for another copy.
  4. Record with each possible path enabled separately.

​
Vocals do not align with the backing

  • Confirm neither participant started a separate local player.
  • Let the host use the shared Play, Pause, and Restart controls.
  • Check that both sides reported the backing ready before Play.
  • Verify the selected vocal source is direct and not delayed by another monitoring application.
  • Preserve diagnostics and a short local recording for support.

​
Managed sources cannot be added or removed cleanly

The dock deliberately avoids taking ownership of same-named user sources.
  • Rename or move the user-created conflicting source.
  • On Configure, select Add Music Collab to scene again.
  • During Live, use Add missing scene sources to repair the managed group.
  • Use Remove scene sources only for the plugin-owned group.
  • A guest normally has vAudioLink Backing (monitor) and vAudioLink Backing Video but no vAudioLink Output; the combined output belongs to the host.

​
OBS closed during a room or preparation

Version 0.1.18 performs an ordered shutdown: it disables capture, pauses managed sources, stops media workers, disconnects the relay, and stops the local media service before OBS clears scene data. The managed scene group remains in OBS because only Remove scene sources deletes it. Reopen Music Collab, review the saved setlist, and use Ready / retry for any preparation that was interrupted. Create or join a new room; the previous active room is not resumed automatically.