SyncTV

SyncTV is a no-account synchronized watching app. The first version keeps the server thin: room state, WebSocket signaling, Redis-backed temporary state, and optional streaming proxy when the room owner enables it.

Quick Start

docker compose up --build

Server:

HTTP: http://yuyun-us1.stormrain.cn:8088
WebSocket: ws://yuyun-us1.stormrain.cn:8088/ws?roomCode=<CODE>&deviceId=<DEVICE_ID>
Health: GET /health

Local Server

cd server
$env:SYNCTV_CONFIG="../config/server.local.json"
go run ./cmd/synctv-server

Create a local config with Redis pointing at your local Redis instance.

HTTP API

GET /health
POST /api/rooms
GET /api/rooms/{code}?deviceId={deviceId}
POST /api/rooms/{code}/source with X-Device-Id
GET /api/rooms/{code}/stream for proxy mode playback

WebSocket

Connect:

ws://yuyun-us1.stormrain.cn:8088/ws?roomCode=A7K29Q&deviceId=dev_xxx

Client events:

setSource
play
pause
seek
syncProgress
syncToLive
heartbeat

Server events:

roomSnapshot
sourceChanged
playbackChanged
presenceChanged
heartbeatAck
error

Clients

The product is split by platform.

Windows

Windows source lives in windows_py_client.

Required tools:

Python 3.11+
VLC 64-bit runtime

Run:

cd windows_py_client
python -m venv .venv
.\.venv\Scripts\pip install -r requirements.txt
.\.venv\Scripts\python synctv_client\main.py

Build exe:

.\build_exe.ps1

The Windows client uses PySide6 + python-vlc.

App

HBuilder/uni-app source lives in hbuilder_app.

Open hbuilder_app in HBuilderX and run/build as an App project.

Playback direction:

Development fallback: built-in <video>.
Production target: nativeplugins/SyncTV-VLC, a uni-app native plugin wrapping VLC.

HBuilder cannot directly call VLC from Vue/JavaScript. It needs a native plugin bridge. The JS facade is already defined in hbuilder_app/common/player.js.

2.0 KiB Raw Blame History