1// BuzzSync.md
2// ---------------------------
3
4# BuzzSync
5
6High-precision web player for multi-device synchronized audio playback — NTP-inspired time sync with Spotify Connect integration.
7
8**TYPE:** Web Application
9**STATUS:** Live
10**LIVE:** https://buzzsync.vercel.app
11**DEV:** http://localhost:3200
12**WORKSPACE:** ~/GitHub/buzzsync
13**GITHUB:** nikanjuri/buzzsync (private)
14
15---
16
17## FEATURES
18
19- Millisecond-accurate playback synchronization across devices
20- NTP-inspired time synchronization primitives over WebSockets
21- Spotify Connect integration for Premium accounts
22- Real-time collaborative rooms with shared playback control
23- Works in any modern browser — no install required
24- Self-hostable with a Turborepo monorepo setup
25
26---
27
28## TECHNOLOGIES
29
30- TypeScript
31- Next.js
32- Turborepo
33- Bun
34- WebSockets
35- Spotify Web API + Connect
36- Vercel
37
38---
39
40## NOTES
41
42BuzzSync turns a room full of phones and laptops into one synchronized sound system. Multiple users join a room, anyone controls playback, and every device plays in lockstep.
43
44### The synchronization problem
45
46Browsers give you no clock guarantees, and audio pipelines add device-specific latency. BuzzSync abstracts NTP-inspired time-synchronization primitives — round-trip offset estimation over WebSockets — to build a shared timeline that devices schedule playback against, achieving millisecond-level accuracy.
47
48### Spotify Connect
49
50Premium users stream directly through Spotify Connect with synchronized control, so the music source is real streaming catalog rather than uploaded files.
51
52### Architecture
53
54A Turborepo monorepo splits the Next.js client from the WebSocket sync server. The whole stack is self-hostable with a few commands and documented environment configuration.