https://github.com/rajin-khan/tessro
Real-time P2P video streaming and syncing platform with your local files ( + chat).
https://github.com/rajin-khan/tessro
group-watch peer-to-peer react realtime video-sharing video-sync webrtc websockets
Last synced: 6 months ago
JSON representation
Real-time P2P video streaming and syncing platform with your local files ( + chat).
- Host: GitHub
- URL: https://github.com/rajin-khan/tessro
- Owner: rajin-khan
- License: gpl-3.0
- Created: 2025-03-31T16:17:19.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-04-11T17:47:53.000Z (6 months ago)
- Last Synced: 2025-04-13T15:16:30.026Z (6 months ago)
- Topics: group-watch, peer-to-peer, react, realtime, video-sharing, video-sync, webrtc, websockets
- Language: JavaScript
- Homepage: https://tessro.com
- Size: 24 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
Tessro
Real-time. Real fast. Fully private.
---
### **💻 V2 Live Now! →** [tessro.com](https://tessro.com/)
https://github.com/user-attachments/assets/df068085-cc06-45f4-aebe-c4bfac24f215
---
## 🎥 What is Tessro?
**Tessro** is a blazing-fast real-time synchronized video playback platform that just got even better. Whether you're across the world or across the room, Tessro brings friends and teams together with seamless, **fully private video sessions**.
🚀 You can now choose between two modes:
- 🌀 **Sync Mode** — Everyone picks the same local video file, and Tessro syncs playback across devices.
- 📡 **Stream Mode** — The host selects a file, and others watch the host’s stream in real-time, thanks to **WebRTC**.
**All with:**
- ❌ No uploads
- 🔐 No accounts
- 👀 No tracking
- 🔄 Real-time sync
- 💬 Live chat
---
## 💡 The Vision
> *Bring back the joy of watching together — personal, private, and perfectly in sync.*
Tessro is ideal for:
- 🎞️ Movie nights
- 🎓 Online training
- 📽️ Remote film reviews
- 🤝 Connecting with loved ones
---
## ✅ Core Features (v2.0)
| Feature | Status | Notes |
|----------------------------------|--------|--------------------------------------------------------------------|
| 🔁 Sync Mode | ✅ | File-based synchronization with hash matching |
| 📡 Stream Mode (WebRTC) | ✅ | Host streams video to all guests via peer-to-peer |
| 🔐 Secure Sessions | ✅ | Password-protected, nickname-based login |
| 💬 Live Chat | ✅ | Scrollable, with sender info and timestamps |
| 👥 Participant List | ✅ | Real-time with host/you indicators |
| 🧠 Smart Cleanup | ✅ | Host leaving ends session, guests gracefully exit |
| 🛡️ Private, Peer-to-Peer | ✅ | WebRTC ensures direct connections — **no centralized relaying** |
| 📱 Mobile-Friendly | ✅ | Drawer-based mobile layout with responsive design |
---
---
## 🧐 How It Works
1. 🔧 **Create Session** — As a host, generate a session and choose a file.
2. 🔑 **Invite Others** — Friends join with your session ID and password.
3. 🌀 **Pick Your Mode** — Sync files or just let the host stream.
4. ⏯️ **Watch Together** — Tessro handles syncing, controls, and chat!
---
## 🔒 Privacy First
Tessro:
- Stores **no user data**
- Uses **no uploads**
- Supports **end-to-end WebRTC streaming**
- Has **no trackers, ads, or analytics**
Coming soon: self-hosted TURN fallback for even better firewall/NAT support.
---
## 🧱 Tech Stack
### Frontend
- ⚛️ **React** + **Vite**
- 🎨 **Tailwind CSS**
- 📺 **React Player**
- ⚡ **Socket.IO Client**
### Backend
- 🖥 **Node.js + Express**
- 📡 **Socket.IO** for sync/chat
- 🚉 **Railway** deployment (soon migrating to scalable cloud)
### WebRTC
- 🔄 **Peer-to-Peer media streaming**
- 🌍 STUN/TURN-ready with fallback handling
- 🔐 Future TURN servers with full privacy (currently using free 24h servers on Twilio)
---
## 🔮 Roadmap
| Feature | Status |
|----------------------------------|-------------|
| ✅ Real-time Sync Mode | Completed |
| ✅ WebRTC Peer Streaming | Completed |
| ⏳ Voice Chat | In Progress |
| ⏳ Emoji Reactions | In Progress |
| ⏳ Subtitle Syncing | Planning |
| ⏳ Self-hosted TURN server | Planning |
| ⏳ Native Mobile App | Planning |
| ⏳ Offline LAN-only Mode | Planning |
| ⏳ Persistent Accounts (Optional) | Not in Vision, but may integrate on request |
---
## **👨💻 Dev Team**
Just me, actually.
| Name | Institution | ID | GitHub | Followers |
|---------------------------|-------------------------|-- |--------|------|
| **Rajin Khan** | North South University | 2212708042 | [](https://github.com/rajin-khan) |  |
---
### ⭐ **Star this repo if you want more cool stuff like this!**
## 🚀 Want to Contribute?
Tessro is open-source, and minimalist. PRs are welcome!