MusicSpace Quick Start

MusicSpace is a shared 3D media room. You can join a room, move around, sit, chat, listen, watch shared TV media, and interact with room objects. If you are signed in and own the room, you can also manage room media, frames, TV playback, and room access.

1. Start Or Join A Room

Use the Join a Room panel in the sidebar.

To create a saved room:

  1. Sign in.
  1. Enter a room name or slug.
  1. Click Create Room.
  1. Share the copied room link with others.

To join an existing room:

  1. Pick a room from the browser list, or open a shared room link.
  1. Click Join or Join Room.
  1. Choose a display name if prompted.
  1. Enter the room.

You can also enter as a guest, but guest rooms and guest permissions are limited. Saved rooms require sign-in for owner/admin features.

2. Move Around

Desktop controls:

  • W: move forward.
  • S: move backward.
  • A: move left.
  • D: move right.
  • Click and drag in the room view: look around.
  • Release the mouse button: stop looking.
  • Avoid using typing shortcuts in text fields: movement keys are ignored while your cursor is in chat or another input field.

Mobile controls:

  • Use the Move joystick area to walk.
  • Use the Look pad area to turn and look around.
  • Sidebar controls still work by tapping normally.

3. Sit And Stand

Some furniture can serve as seating.

To sit:

  1. Walk close to a seat, couch, or chair.
  1. When the seat prompt appears, press E or click/tap the seat prompt.
  1. Your view moves into the seated position.

To stand:

  • Press W while seated.
  • The app releases the seat and returns you to walking mode.

Notes:

  • Only one person can occupy a seat at a time in a live room.
  • If a seat is already taken, choose another seat.
  • The participant list shows whether people are walking or seated.

4. Pick Up And Place Objects

Some room objects are interactive.

To pick up an object:

  1. Look at or hover over a pickable object.
  1. Click it.
  1. The object is held in front of you.

To place/drop an object:

  1. While holding it, click somewhere else in the room.
  1. The object is released and synced to the room.

Notes:

  • Held objects are shared in multiplayer.
  • If another participant owns or is holding an object, you may not be able to take it until it is released.
  • Objects may return to valid drop areas depending on the room layout.

5. Chat

Use the Chat panel in the sidebar.

  • Type a message.
  • Press Enter or click the send button.
  • Chat is room-specific.
  • You must be in a room before sending messages.

6. Audio And Radio

The room includes audio playback and station/mood behavior.

  • Use the audio controls to play/pause and adjust volume.
  • Browser audio may require a click/tap before playback starts.
  • On mobile, tapping the volume or playback controls may be required to unlock audio.

7. Shared TV

Owners/admins can set the shared TV source.

You can:

  • Use an existing uploaded video from the room media library.
  • Upload a supported MP4 video.
  • Set or clear the TV source.
  • Play/pause shared TV playback.

TV media is shared across the room, so other users see the selected TV content too.

8. Room Frames

Owners/admins can place image media into the room frames.

In the room media library:

  • Frame 1
  • Frame 2
  • Frame 3
  • Frame 4
  • Clear
  • Delete

Use Frame 1-4 to place an uploaded image into that frame. Use Clear to remove that image from active frames. Use Delete to remove the media asset from the room library.

Notes:

  • The same image can be placed on multiple frames.
  • Clearing removes the image from all active frames where it is used.
  • Deleting removes the asset from the room library and clears it from any active surfaces.

9. Room Media Library

The media library stores uploaded room assets.

Supported media:

  • Surface images: PNG, JPG, WebP.
  • TV video: MP4.

The app checks for duplicate uploads by file checksum. If the exact same file already exists in the room, the app should reuse the existing asset instead of creating a duplicate.

Media controls are owner/admin features.

10. Participants And Room Controls

The participant panel shows who is currently in the room.

Depending on your role, you may see controls for:

  • Locking/unlocking the room.
  • Muting participants.
  • Promoting/demoting admins.
  • Kicking participants.

Roles:

  • Owner: created or owns the saved room.
  • Admin: can help manage room controls and media.
  • Member: can join, move, sit, chat, and interact with allowed objects.

11. Saved Rooms

Saved rooms persist after users leave.

Owners can:

  • Delete saved rooms.
  • Manage saved room media.
  • Control owner/admin permissions.

Only the room owner can delete a saved room.

12. Common Tips

  • If you cannot upload, set TV media, or edit frames, make sure you are signed in and are the room owner/admin.
  • If movement does not work, click back into the room view and make sure you are not typing in a text field.
  • If audio does not start, click/tap the page once and try playback again.
  • If the room list looks stale, refresh the browser.
  • If multiplayer state seems delayed, leave and re-enter the room.

Short Control Cheat Sheet

Desktop:

  • W/A/S/D: move.
  • Click + drag: look around.
  • E near seat: sit.
  • W while seated: stand.
  • Click object: pick up.
  • Click while holding the object: drop/place.
  • Chat input + Enter: send message.

Mobile:

  • Move pad: walk.
  • Look pad: rotate view.
  • Tap UI buttons: join, chat, media controls, and room actions.