Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kclyu/rpi-webrtc-streamer
This repo's objective is providing something like Web Cam server on the most popular Raspberry PI hardware. By integrating [WebRTC](https://webrtc.org/native-code/) and Raspberry PI, we can stream the Raspberry camera feed to browser or native client which talks WebRTC.
https://github.com/kclyu/rpi-webrtc-streamer
h264 raspberry-camera raspberry-pi raspberry-pi-camera raspberry-webrtc video-streaming webrtc webrtc-streamer webrtc-video
Last synced: about 1 month ago
JSON representation
This repo's objective is providing something like Web Cam server on the most popular Raspberry PI hardware. By integrating [WebRTC](https://webrtc.org/native-code/) and Raspberry PI, we can stream the Raspberry camera feed to browser or native client which talks WebRTC.
- Host: GitHub
- URL: https://github.com/kclyu/rpi-webrtc-streamer
- Owner: kclyu
- License: other
- Created: 2016-10-03T11:53:57.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2021-09-30T11:43:10.000Z (about 3 years ago)
- Last Synced: 2024-09-28T00:40:55.099Z (about 2 months ago)
- Topics: h264, raspberry-camera, raspberry-pi, raspberry-pi-camera, raspberry-webrtc, video-streaming, webrtc, webrtc-streamer, webrtc-video
- Language: C++
- Size: 61.2 MB
- Stars: 626
- Watchers: 32
- Forks: 108
- Open Issues: 31
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
- awesome-webrtc - rpi-webrtc-streamer - Web Cam server on the most popular Raspberry PI hardware. (Miscellaneous / Tool)
README
# WebRTC streamer for Raspberry PI
## General
Notice: This is a work in progress,
This repo's objective is providing something like Web Cam server on the most popular Raspberry PI hardware. By integrating [WebRTC](https://webrtc.org/native-code/) and Raspberry PI, we can stream the Raspberry camera feed to browser or native client which talks WebRTC.
Generally, the components of WebRTC service are classified into Signaling Server and WebRTC client. However, RWS(Rpi-WebRTC-Streamer) is built to operate on one piece of Raspberry PI hardware and includes some of Signaling Server functionality. In other words, the Browser or Client supporting WebRTC directly connects to RWS and receives WebRTC streaming service.
### Streaming camera feed
To get the camera feed from Raspberry PI, i.e. H.264 video stream, RWS use MMAL(Multi-Media Abstraction Layer) library can be found on [ARM side libraries for interfacing to Raspberry Pi GPU](https://github.com/raspberrypi/userland). it provides lower level API to multi-media components running on Broadcom VideoCore. For convenience, this streamer directly integrated [raspivid](https://github.com/raspberrypi/userland/tree/master/host_applications/linux/apps/raspicam)
with encoding parameter changing in H.264 stream and passing video frame through WebRTC native code package.
### Motion Detection
Motion Detection feature provided by Rpi-WebRTC-Streamer uses Inline Motion Vector which is generated during video encoding. And use this to get the approximate Motion Detection function while using minimal CPU resources.
Please refer to [README_motion document](../master/README_motion.md).
### Messenger Notification
The motion detection event message can be transmitted to the user through the telegram messenger. It can send motion detection message and detected video clip to Telegram Messenger client so that it can be used as a private security bot.
For more information, Please refer to [README_TelegramBot document](../master/README_TelegramBot.md).
## Rpi WebRTC Streamer
### Demo Video
## Hardware Requirement
### Raspberry PI
- Raspberry PI 2/3
- Raspberry Pi Zero/Zero W (ZeroW tested)
### Video Camera
- RPI Camera board V1/V2
- Arducam 5 Megapixels 1080p Sensor OV5647 Mini Camera Video Module
### Audio hardware
Please refer to the [README_audio.md](https://github.com/kclyu/rpi-webrtc-streamer/blob/master/README_audio.md)
## Running RWS on Raspberry PI
Please refer to [README_rws_setup.md document](../master/README_rws_setup.md).
## Download Docker image for Testing
In Raspberry PI, you can run the image directly after the pull from the docker hub as shown below.
```
docker pull kclyu/rpi-webrtc-streamer
docker container run --device=/dev/vcsm --device=/dev/vchiq --net=host --mount type=bind,source=/var/run/dbus,target=/var/run/dbus --rm -d kclyu/rpi-webrtc-streamer # note1
```
_Note1: docker image is currently for armv7l (Raspberry PI2 and above)._
## Download Deb package for Testing
To download RWS deb package, please refer to the following URL. RWS is currently in development and testing, so please use it with consideration.
Please refer to [Rpi-Webrtc-Streamer-deb Repo](https://github.com/kclyu/rpi-webrtc-streamer-deb).
## Cross Compile on Ubuntu Linux
Please refer to [README_building.md document](../master/README_building.md).