https://github.com/keepcoolch/webrtccamerastream
Simple peer-to-peer live video streaming - start a camera stream in your browser and share it instantly with a receiver via a unique Stream ID.
https://github.com/keepcoolch/webrtccamerastream
css html json php video video-streaming webrtc webrtc-signaling webrtc-video
Last synced: 2 months ago
JSON representation
Simple peer-to-peer live video streaming - start a camera stream in your browser and share it instantly with a receiver via a unique Stream ID.
- Host: GitHub
- URL: https://github.com/keepcoolch/webrtccamerastream
- Owner: KeepCoolCH
- Created: 2025-10-03T19:16:16.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-10-03T19:23:00.000Z (9 months ago)
- Last Synced: 2025-10-03T21:29:10.984Z (9 months ago)
- Topics: css, html, json, php, video, video-streaming, webrtc, webrtc-signaling, webrtc-video
- Language: HTML
- Homepage: https://webrtc.kevintobler.ch
- Size: 217 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 📹 WebRTC Camera Stream
**Simple peer-to-peer live video streaming** – start a camera stream in your browser and share it instantly with a receiver via a unique Stream ID. Version **1.0** – developed by Kevin Tobler 🌐 [www.kevintobler.ch](https://www.kevintobler.ch)
---
## 🔄 Changelog
### 🆕 Version 1.x
- **1.0**
- 📹 Start live video directly from your browser (desktop or mobile)
- 🔗 Share the stream via a unique Stream ID
- 📋 One-click copy of the Stream ID or a ready-to-use receiver link
- 🔄 Switch between front and back camera (on supported devices)
- 🎥 Select specific cameras from a list (desktop devices)
- ❌ End a stream manually (Sender clears all signals, Receiver can send “Bye”)
- 🌍 Works without plugins – pure WebRTC + PHP signaling
---
## 🚀 Features
- 🎥 Real-time **WebRTC video streaming** between browsers
- 🔑 **Stream ID** is randomly generated and unique for each session
- 📋 Copy Stream ID or full Receiver link with one click
- 🔄 **Switch cameras** (front/back on mobile, device selection on desktop)
- 🗑️ Automatic cleanup of old signaling files
- ✅ No database required – signaling stored as temporary JSON files
- 🌐 Works on modern browsers (Chrome, Firefox, Safari, Edge)
---
## 📸 Screenshot
---
## 🌍 Online Demo
Try WebRTC Camera Stream directly in your browser:
🔗 [https://webrtc.kevintobler.ch](https://webrtc.kevintobler.ch)
---
## 🔧 Installation
1. Upload all files (`index.html`, `sender.html`, `receiver.html`, `signal.php`, `css`, `img`) to your web server
2. Ensure PHP and HTTPS is enabled (⚠️ PHP 7.4 or higher and TLS/HTTPS required)
3. Make sure the server allows writing to the `/signals` directory (created automatically and protected with .htaccess)
4. Share the Stream ID or the Receiver link with your viewer
---
## ⚙️ How It Works
- **Sender** opens `sender.html` and starts the stream → a new random Stream ID is created.
- **Receiver** opens `receiver.html` and enters the same Stream ID.
- Both communicate via the **signaling server** (`signal.php`), which exchanges:
- 📤 Offers & Answers (SDP)
- ❄️ ICE candidates (STUN connectivity)
- 🚫 Bye messages (to end streams)
- Once connected, the video/audio stream flows directly peer-to-peer (encrypted).
---
## 🔒 Security
- All signaling data is stored as temporary JSON files on the server (auto-deleted after 24h).
- Access to the `/signals` directory is blocked via `.htaccess`.
- Media streams are **end-to-end encrypted** by WebRTC.
- Stream IDs are random 6-digit numbers and expire after stream termination.
---
## 🧑💻 Developer
**Kevin Tobler**
🌐 [www.kevintobler.ch](https://www.kevintobler.ch)
---
## 📜 License
This project is licensed under the **MIT License** – feel free to use, modify, and distribute.