Skip to content
NatsusomekeishiPublic

About

一个轻量级的 Web 异地同屏应用,致力于让身处不同地方的朋友能够通过浏览器实时同步观看视频,并进行即时互动。

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

WithMe

Version License

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 的浏览器)

安装步骤

  1. 克隆仓库

    git clone https://github.com/Natsusomekeishi/WithMe.git
    cd WithMe
  2. 安装依赖 建议使用虚拟环境:

    python -m venv venv
    # Windows
    venv\Scripts\activate
    # Linux/macOS
    source venv/bin/activate

    安装项目依赖:

    pip install -r requirements.txt
  3. 运行应用

    python app.py
  4. 开始体验 打开浏览器访问:http://localhost:5000

    • 房主:点击创建房间 -> 选择视频 -> 发送房间码给朋友。
    • 观众:输入房间码 -> 加入房间 -> 等待连接建立。

🤝 参与贡献

欢迎提交 Issue 和 Pull Request!

📄 许可证

本项目采用 GPL-3.0 许可证。详情请参阅 LICENSE 文件。

👤 作者

Keishi


Enjoy watching together with WithMe!

About

一个轻量级的 Web 异地同屏应用,致力于让身处不同地方的朋友能够通过浏览器实时同步观看视频,并进行即时互动。

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages