Listen to YouTube together without leaving VS Code. One person creates a room, shares an
8-character code, and everyone in the room hears the same queue at the same moment.
How it works
Open the SyncRoom view in the activity bar and choose Create room.
Send the room code to your friends. They choose Join and type it.
Search YouTube from the box under the player, or paste a video or playlist link. Results include a few playlists among the videos; adding one adds the whole playlist. Each result has buttons to add it to the queue or play it next. Anyone in the room can add, reorder, skip, pause or seek.
The chat has its own icon in the activity bar; unread messages show as a badge on it, and a short sound plays when someone else writes. Mute it with the bell button on the chat view (or the syncroom.chatSound setting).
Whoever created the room can lock the queue and the playback with the two toggles in the queue header, so only they can change the list or play, pause and skip.
The owner can choose Who can find this room: private (code only), public, or a group. Public and group rooms appear under Open rooms in the lobby. A group is a shared word (at least 8 characters): add it with + Group and you will see the rooms listed for it.
The SyncRoom view shows the video of the current track, live. It is captured from the hidden player on your computer and goes only to the view, while the view is open; nothing is sent to the room. Turn it off with the camera button on the picture (or the syncroom.videoPreview setting) to see only the thumbnail.
There is no account and no SyncRoom server. Rooms exist only while someone is in them.
Requirements
A Chromium-based browser installed: Microsoft Edge, Google Chrome, Brave or Chromium.
VS Code cannot play YouTube audio by itself, so SyncRoom runs the official YouTube
player in that browser, hidden in the background. Use SyncRoom: Show or Hide Player
Window to see it, for example to skip an ad.
An internet connection that can reach YouTube.
Commands
Command
What it does
SyncRoom: Create Room
Start a new room
SyncRoom: Join Room…
Enter a room with its code
SyncRoom: Add YouTube Link…
Add a video or playlist to the queue
SyncRoom: Play / Pause
Also available by clicking the status bar button, which is highlighted so you can tell which VS Code window has the room
SyncRoom: Next Track
Skip for everyone
SyncRoom: Show or Hide Player Window
Toggle the small YouTube window
SyncRoom: Copy Room Code
Copy the code to share it
SyncRoom: Change Name…
Change the name the others see
SyncRoom: Leave Room
Stop listening
SyncRoom: Report a Bug…
Open a new GitHub issue with your versions and the end of the log (your user name and room codes are removed). You see it before sending it. Error messages have a Report bug button that does the same.
Settings
Setting
Default
Meaning
syncroom.displayName
(asked once)
Your name in the room
syncroom.browserPath
(auto)
Browser used to play audio
syncroom.directConnections
true
Connect peer to peer. Turn off to hide your IP from the room
syncroom.relays
4 public relays
Nostr relays used as a fallback path
syncroom.videoPreview
true
Show the video of the current track in the SyncRoom view (captured on your computer, never sent to the room)
syncroom.chatSound
true
Play a short sound when someone else writes in the room chat
Privacy
Anyone who has the room code can join and control playback. Share it only with people you trust.
A public room shows its code to every SyncRoom user. Group rooms are announced encrypted; without the group word
neither the room nor its code can be read.
Rooms you join from Open rooms connect through relays only, so the people in them never see your IP address.
If you list your own room as Public or for a Group, people who join it with direct connections on can see your
IP address; turn syncroom.directConnections off to avoid it.
With direct connections on, the other people in the room can see your IP address (this is how
peer-to-peer works). Turn syncroom.directConnections off to send everything through relays.
Messages that travel through public relays are encrypted with a key derived from the room code.
The relays see that someone is using a room, not what is playing.
YouTube sees your playback the same way it does in a browser tab.
Known limits
Playlists add their first 15 videos. YouTube Mixes (list=RD…) add the first batch YouTube generates, about 25 videos.
Some videos cannot be played outside youtube.com, or are blocked in your region. They are marked
as not available for you and the rest of the room keeps listening.
In hidden mode an ad cannot be skipped; show the player window to skip it.
Ads that play in the hidden player are visible in the video preview too.
Each VS Code window runs its own audio engine: joining the same room from two windows on one computer plays the audio twice.
Tested on Windows. macOS and Linux should work but are not verified yet.
Your computer clock must be roughly right, or relays may reject your messages.