WithMe 是一个轻量级的 Web 异地同屏应用,致力于让身处不同地方的朋友能够通过浏览器实时同步观看视频,并进行即时互动。
WithMe 基于 Flask 和 WebRTC 构建。它不依赖复杂的客户端安装,只需通过浏览器即可实现点对点的视频流传输和状态同步。无论是电影、教学视频还是生活记录,都可以通过 WithMe 与好友分享。
- ⚡ 极速创建:一键生成专属房间,通过 6 位随机字符房间码即可邀请好友加入。
- 🎥 实时同屏:
- 利用 WebRTC 技术实现 P2P 视频流传输,低延迟,高画质。
- 支持 Host (房主) 模式,由房主上传/选择本地视频文件。
- 🔄 状态同步:
- 播放/暂停、进度条拖动等操作在所有连接端实时同步。
- 确保每个人看到的画面帧数保持一致。
- 💬 互动弹幕:
- 内置实时聊天室/弹幕系统。
- 支持发送即时消息,消息以气泡形式展示,增强互动感。
- 🎨 现代化 UI:
- 采用深色主题 (Dark Mode) 设计,沉浸式观影体验。
- 完全响应式布局,完美适配 PC 和移动端设备。
本项目采用前后端分离的设计思想(但在本项目中通过 Flask 模板渲染):
- 后端:
- Python Flask:提供 Web 服务。
- Flask-SocketIO:处理 WebSocket 连接,负责信令交换 (Signaling) 和状态同步广播。
- 前端:
- 原生 HTML5/CSS3/JavaScript。
- Socket.IO Client:与后端保持实时双向通信。
- WebRTC API:建立浏览器间的点对点连接,传输媒体流。
- Python 3.7 或更高版本
- 现代浏览器(Chrome, Firefox, Edge 等支持 WebRTC 的浏览器)
-
克隆仓库
git clone https://github.com/Natsusomekeishi/WithMe.git cd WithMe -
安装依赖 建议使用虚拟环境:
python -m venv venv # Windows venv\Scripts\activate # Linux/macOS source venv/bin/activate
安装项目依赖:
pip install -r requirements.txt
-
运行应用
python app.py
-
开始体验 打开浏览器访问:
http://localhost:5000- 房主:点击创建房间 -> 选择视频 -> 发送房间码给朋友。
- 观众:输入房间码 -> 加入房间 -> 等待连接建立。
欢迎提交 Issue 和 Pull Request!
本项目采用 GPL-3.0 许可证。详情请参阅 LICENSE 文件。
Keishi
- GitHub: @Natsusomekeishi
Enjoy watching together with WithMe!