A lightweight, self-hosted video synchronization service for watching YouTube, Twitch VODs, and raw mp4 files together in real-time.

Originally built as an experiment with local LLM code generation, it turned out to be genuinely useful for watch parties and remote hangouts.

• Room-based sessions with 6-character codes
• Queue system for multiple videos
• Play/pause/seek sync across all viewers
• YouTube and Twitch embed support
• Chat with nicknames
• Shareable invite links

pip install fastapi 'uvicorn[standard]'

python syncstream.py

Then open http://localhost:8000

docker build -t syncstream .
docker run -p 8000:8000 syncstream

Or with docker-compose:

docker compose up

The app includes rate limiting, input validation, and XSS protection.

This project is licensed under the Elastic License 2.0 - see the LICENSE file for details.