Skip to content

Latest commit

 

History

82 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Syncwave

Listen to music together, in perfect sync.
A self-hosted Spotify Jam alternative. No accounts, no Premium.

Website · Download · Self-host guide · FAQ · Changelog

Latest release License: PolyForm Noncommercial Website


A Syncwave room: Daft Punk's Instant Crush playing, a shared queue showing who added each song, DJ suggestions, and a chat where the AI DJ has just queued three jazz tracks for a listener.

Start a room, send one link, and everyone hears the same second of the same song. There's a shared queue anyone can add to, live chat, reactions, and an optional AI DJ that takes requests in plain English. It runs on a computer you already own, and your friends connect to it.

Features

Synced playback A server-side clock keeps every listener on the same second. A laptop waking from sleep catches up instead of pulling the room back.
Shared queue Anyone can add. Upvotes move a track one place per person, drag to reorder, vote to skip, and see who added what.
One-link rooms No sign-ups for anyone. Rooms survive restarts, so a link can be your group's spot for good.
Chat and presence See who's listening, typing or away. Reactions burst identically on every screen.
Sounds like a real app Crossfade, volume levelling, lock-screen controls and casting to speakers.
Host controls Mute or remove listeners, or make a room invite-only and approve each person.
Optional AI DJ /dj add 10 rainy day songs fills the queue and introduces tracks in character. Free with Gemini or a local Ollama.
Built for phones Swipeable panes, installable to the home screen, and the room takes its colour from the album art.
Syncwave on two phones: the shared queue, and the chat with the AI DJ introducing a Tame Impala track.

Quick start

Desktop (easiest). Download the latest release, unzip it, and run start.bat on Windows or ./start.sh on macOS and Linux. It fetches Node if needed, opens your browser, and prints a public link you can send to anyone.

Docker (always-on box).

git clone https://github.com/SAKMZ/syncwave.git && cd syncwave
cp .env.example .env
docker compose up -d --build

Linux server (one command).

curl -fsSL https://raw.githubusercontent.com/SAKMZ/syncwave/main/scripts/install.sh | sudo bash

Then open the address it prints and set an admin password at /setup straight away. Until it's set, anyone who can reach the server can claim it.

Note

On a cloud VPS, YouTube refuses most datacenter IPs, so you'll need a proxy pool or a cookies file. It's one setting in /admin; DEPLOY.md walks through it, along with custom domains, Tailscale, Railway and automatic updates.

See it running

Documentation

  • DEPLOY.md: every install path, domains and HTTPS, updates, configuration, and fixing playback.
  • FAQ: common questions, keyboard shortcuts, and how it works.
  • CHANGELOG.md: what changed in each release.
  • CONTRIBUTING.md: running it locally and sending a pull request.

Legal

Syncwave is a self-host tool. You run it and are responsible for how it's used where you live. Streaming audio from YouTube with unofficial tools may break YouTube's Terms of Service, so don't run a public or for-profit service on top of it. Syncwave is not affiliated with Spotify or YouTube.

License

PolyForm Noncommercial 1.0.0. Free to run, fork and modify for personal, hobby and nonprofit use. Commercial use, including selling access, running it as a paid or ad-supported service, or bundling it into a product, needs a separate agreement: hello@awetomiq.com.


A product by AWETOMIQ

About

Self-hosted Spotify Jam alternative — listening rooms where everyone hears the same song at the same second. Shared queue, live chat, reactions, vote-to-skip. No accounts, no Premium, runs on a machine you own.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

15 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages