Features  •  Installation  •  How to use  •  Updating  •  Uninstalling  •  Troubleshooting

Features

	Feature	Description
🎵	Perfect Playback Sync	Listen together at the exact same second — when the host plays, pauses, or skips, everyone stays in tune
🎶	Shared Party Queue	Build the vibe together — anyone can add songs, remove tracks, or drag-and-drop to reorder live
🎙️	Pass the Aux (Guest Controls)	Host can grant control to friends so anyone can control the music
👥	Live Friend Avatars	See who's in the room with real Spotify profile pictures and live presence
📌	Mini Player Widget	A sleek floating widget keeping you connected to the Jam even when the sidebar is minimized
⚡	Instant Room Invites	Invite friends in seconds using a 6-letter room code, QR code, or shareable link
🔄	Seamless Auto-Sync	Automatically keeps everyone in sync without pausing or interrupting the music

Installation

Quick Install (Recommended)

Just run this. It downloads the latest build and sets everything up automatically.

Windows (PowerShell):

irm https://raw.githubusercontent.com/Kyzenkms/spicetify-jam/main/install.ps1 | iex

Linux / macOS:

bash <(curl -fsSL https://raw.githubusercontent.com/Kyzenkms/spicetify-jam/main/install.sh)

That's it. Restart Spotify and look for the 🎵 icon in the player bar.

---

Manual Install (Developers)

Requirements: Git · Node.js v18+ · Spicetify

Windows: Restart PowerShell after installing Git and Node.js.

Windows

git clone https://github.com/Kyzenkms/spicetify-jam
cd spicetify-jam
npm install
npm run build
spicetify config extensions spicetify-jam.js
spicetify apply

Linux / macOS

git clone https://github.com/Kyzenkms/spicetify-jam
cd spicetify-jam
npm install
npm run build
spicetify config extensions spicetify-jam.js
spicetify apply

Updating

From inside the spicetify-jam folder:

git pull
npm install
npm run build
spicetify apply

How to use

As a host

1. Click the Jam icon in the bottom-right of the Spotify player bar.
2. Click Start a new Jam in the sidebar.
3. Share your Session ID, QR code, or join link with friends.
4. Add songs via the sidebar or by right-clicking a track in Spotify and selecting Add to Jam.

As a guest

1. Click the Jam icon in the player bar.
2. Enter the host's Session ID or open their join link.
3. Playback syncs automatically. Resuming after a pause jumps you straight to the live position.

Uninstalling

Quick Uninstall (Recommended)

Windows (PowerShell):

irm https://raw.githubusercontent.com/Kyzenkms/spicetify-jam/main/uninstall.ps1 | iex

Linux / macOS:

bash <(curl -fsSL https://raw.githubusercontent.com/Kyzenkms/spicetify-jam/main/uninstall.sh)

---

Manual Uninstall

spicetify config extensions spicetify-jam.js-
spicetify apply

Then delete the extension file from your Extensions folder.

---

Troubleshooting

"Connection timed out" when joining

Spicetify Jam uses WebRTC (P2P) to connect directly between users. Strict NAT — common on university, corporate, or mobile carrier networks — can block this.

• Switch to a mobile hotspot
• Use a VPN
• Use a home network instead of public or institutional Wi-Fi
• Make sure both users are on the latest version

The Jam icon doesn't appear after install

Run spicetify apply again, or try:

spicetify restore apply

Then restart Spotify.

npm or git is not recognized

Install Node.js and Git, then restart your terminal.

Contributing

Found a bug or have a suggestion? Open an issue — contributions are welcome.

License

MIT — see LICENSE for details.