不管想和爸妈唠着家常看老剧,还是和 TA 同步追新番,Go 开发的开源 SyncTV 都懂!实时互动 + 多平台支持,轻松还原家人相聚、情侣同观的温馨感~

项目介绍

开源地址:

https://github.com/synctv-org/synctv/
✨SyncTV 核心特征清单

一、📺 同步观影体验

  • • 同步观看基础:视频同步、直播、剧院模式

  • • 播放辅助:解析视频(含实时解析)

二、💬 互动沟通功能

  • • 文字互动:聊天、弹幕聊天

  • • 音视频互动:WebRTC 在线通话(支持声音、视频、屏幕共享)

三、📥 多平台内容支持

  • • 第三方集成:阿利斯特(Alist)、哔哩哔哩、Emby

四、🔧 技术保障能力

  • • 代理服务:代理人、视频代理、实时代理、代理缓存

项目部署

🚀 SyncTV 三种安装方式指南

为方便不同需求的用户快速上手,整理了脚本、Docker、二进制三种安装方案,步骤清晰且附实操命令:

选项1:快速脚本安装(适用于 Linux/macOS)

  1. 1. 复制并执行以下命令:
    sudo -v ; curl -fsSL https://raw.githubusercontent.com/synctv-org/synctv/main/script/install.sh | sudo bash -s -- -v latest

   2. 脚本将自动下载并安装 SyncTV 最新版本到系统中。
 

选项2:Docker 安装(通用便捷方案):

  1. 1. 执行 Docker 运行命令:
    docker run -d --name synctv -v /opt/synctv:/root/.synctv -p 8080:8080 synctvorg/synctv

选项3:二进制下载(手动控制版本)

如需指定版本或手动部署,可下载预编译二进制文件:

  1. 1. 访问 SyncTV 发布页面(需跳转至 GitHub);

  1. 2. 解压下载的归档文件,获取 synctv 二进制程序;

访问SyncTV 

http://0.0.0.0:8080

项目实操

一、房间管理:创建与加入

1. 创建房间(附接口)

  1. 1. 操作步骤:

    • • 从主仪表板点击「创建房间」按钮;

    • • 输入房间名称,可选设置密码(限制访问);

    • • 按需配置房间初始设置(后续可修改);

    • • 点击「创建」,自动成为房间创建者(拥有全量管理权限)。

2. 加入房间(附接口)

支持 4 种加入方式,按需选择:

  • • 公共房间列表:从主仪表板直接浏览;

  • • 热门房间列表:查看当前有活跃观众的房间;

  • • 直接输ID:输入朋友分享的房间ID;

  • • 搜索:按房间名称、创建者或ID精准查找。

  • 注:加入带密码的房间时,需输入正确密码。

3. 查看房间信息

进入房间后,可实时查看关键信息:

  • • 基础信息:房间名称、创建者;

  • • 观众状态:当前观众数量;

  • • 权限说明:你在房间中的角色与对应权限;

  • • 配置详情:当前房间设置。

二、媒体管理:添加与维护

1. 添加媒体(附接口)

支持 3 种添加方式,覆盖不同内容场景:

  • • 直接URL:粘贴媒体文件的直接链接(如视频链接);

  • • 平台集成:从 Bilibili、Emby、AList 等已集成平台选内容;

  • • RTMP 直播流:通过 RTMP 协议设置自定义直播流。

  1. 💡 小贴士:SyncTV 可通过服务器代理媒体内容,解决跨网络访问问题,保障播放一致性。

2. 媒体库管理

每个房间自带独立媒体库,操作权限按角色分配:

  • • 基础操作:查看所有媒体、搜索特定内容、将媒体分类到文件夹;

  • • 删除操作:移除不再需要的媒体;

  • • 权限说明:仅房间创建者和管理员拥有媒体库全量管理权限。

三、同步观影:播放控制与互动

1. 一起观看:核心同步功能

SyncTV 通过 WebSocket 维持播放同步,确保所有人看到相同内容:

  1. 1. 播放媒体:从房间媒体库选视频,点击「播放」,全员同步开始;

  2. 2. 控制同步:播放/暂停、快进、调倍速等操作,实时同步给所有观众。

2. 播放权限管理

房间管理员可自定义权限分配,控制谁能执行以下操作:

  • • 内容切换:更改当前播放的视频;

  • • 播放控制:执行播放/暂停/快进;

  • • 参数调节:调整播放速度、切换字幕;

    注:权限可在房间设置中灵活调整。

四、互动功能:聊天与弹幕

1. 文本聊天

内置实时聊天系统,边看边聊:

  • • 操作:在聊天输入框输消息,按 Enter 发送;

  • • 效果:消息实时同步到所有观众的聊天面板。

2. 弹幕聊天

弹幕漂浮在视频画面上,增强互动感:

  • • 操作:在聊天面板切换「弹幕模式」,输入消息发送;

  • • 自定义:可调整弹幕的颜色、大小、屏幕显示位置。

五、直播流支持

针对直播场景,SyncTV 提供多格式与平台兼容:

  • • 自定义直播:支持 RTMP 流媒体,可广播自己的直播内容;

  • • 平台集成:对接 Bilibili 等直播平台,直接同步观看平台直播;

  • • 格式兼容:输出 HLS、FLV 格式,适配不同设备与网络环境。

 都看到这里了 关注一下吧

Logo

更多推荐