mazupo /pi-webrtc

Low-latency hardware-accelerated WebRTC video streaming and remote control for Raspberry Pi & NVIDIA Jetson

★ 999⑂ 58👁 8⑃ 247● 143▤ 28
C++Apache-2.0Created 2022-05-09mazupo.com
下载:v4.0.0v4.0.0 ↓4.0.02026-10-21
+0
日增长
999
stars
58
forks
8
watchers
247
prs
143
issues
28
releases

README

pi-webrtc



    
    
    
    
    


 What is pi-webrtc?

A single binary that streams a camera from a Raspberry Pi or Jetson to a browser over WebRTC, and carries control messages back to the device. It delivers sub-100ms latency on LAN and works remotely over WiFi, LTE, or 5G with no public IP.


  



  ▶ Watch the full demo


 Features

- Low-latency video — WebRTC with NAT traversal and congestion control.
- Remote control — commands and telemetry over WebRTC DataChannels.
- Hardware acceleration — H.264/AV1 on supported devices.
- RTSP input — add WebRTC and DataChannels to an existing IP camera.

 Signaling

| Signaling | Use case |
| --- | --- |
| WHEP | Playback with any standard WebRTC player |
| MQTT | Peer-to-peer from anywhere, with device control |
| SFU | Many viewers at once via LiveKit or Cloudflare Realtime |

Several signaling options can run at the same time. See Signaling.

 Quick Start

On a Raspberry Pi with Raspberry Pi OS Trixie (64-bit) and a CSI camera:

bash
sudo apt update
sudo apt install libmosquitto1 pulseaudio libavformat61 libyaml-cpp0.8

wget https://github.com/mazupo/pi-webrtc/releases/latest/download/pi-webrtc_raspios-trixie-arm64.tar.gz
tar -xzf pi-webrtc_raspios-trixie-arm64.tar.gz

./pi-webrtc --camera=libcamera:0 --uid=my-pi --no-audio --use-whep


Open app.mazupo.com/whep, enter http://:8080 as the WHEP URL, and connect.

Step-by-step guides: Raspberry Pi · NVIDIA Jetson · Watch from anywhere with MQTT

!preview_demo

 Hardware

| Platform | Camera backend | Hardware encoding |
| --- | --- | --- |
| Raspberry Pi | libcamera | H.264 on supported models |
| NVIDIA Jetson | libargus | H.264 / AV1 on supported models |

USB cameras (V4L2) and RTSP streams work on both platforms.

 Documentation

📚 Full documentation, also readable in docs/.

 Support the project

Sponsors help fund continued development and receive access to additional releases, features, and documentation. See Sponsors.

 License

Apache-2.0 — see LICENSE. Third-party notices: see NOTICE.

Top issues

Latest release

v4.0.0 v4.0.0 2026-10-21
- fix: close the peer connection on DISCONNECT without releasing it inside its own callback (2622dd9)
- fix: build with libcamera that uses std::span (13689e3)
- feat: cf sfu worker (385) (0168655)
- docs: add a low bitrate page with encoder curves and the jetson resolution steps (6d17a85)
- feat: floor the video bitrate at --min-bitrate, with a jetson default for a fixed resolution (3712cdd)
- feat: switch the jetson encoder's resolution by its encoded bitrate (dfb0aa5)
- fix: stop openh264 from treating sensor noise as scene changes (1226eb1)
- fix: let the jetson decoder wait for an idr fra

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON