# Raspi als WebCam Server

# RunBook incl. Installation

\# Runbook -- Raspberry Pi Webcam-Streaming mit Logitech C920 und MediaMTX

\*\*Version:\*\* 2.0\\  
\*\*Stand:\*\* Juli 2026

\------------------------------------------------------------------------

\# Inhaltsverzeichnis

1\. Ziel  
2\. Architektur  
3\. Hardware  
4\. Software  
5\. Voraussetzungen  
6\. Installation  
7\. Webcam testen  
8\. FFmpeg installieren  
9\. MediaMTX installieren  
10\. MediaMTX konfigurieren  
11\. Systemd-Dienste  
12\. Funktionstest  
13\. OBS einrichten  
14\. VLC-Test  
15\. Fehlerbehebung  
16\. Wartung  
17\. Updates  
18\. Mehrere Webcams  
19\. Performance  
20\. Backup

\------------------------------------------------------------------------

\# 1. Ziel

Bereitstellung einer Logitech C920 als RTSP-Stream für:

\- OBS  
\- VLC  
\- Home Assistant  
\- weitere RTSP-Clients

\------------------------------------------------------------------------

\# 2. Architektur

``` text  
Logitech C920  
 │  
 ▼  
 Raspberry Pi  
 │  
 /dev/video0  
 │  
 FFmpeg (H.264)  
 │  
 MediaMTX  
 │  
rtsp://<IP>:8554/webcam  
 │  
 ├── OBS  
 ├── VLC  
 └── Home Assistant  
```

\------------------------------------------------------------------------

\# 3. Hardware

\- Raspberry Pi 4 oder 5 (64 Bit empfohlen)  
\- Logitech C920  
\- stabiles Netzteil  
\- Netzwerkverbindung

\------------------------------------------------------------------------

\# 4. Software

\- Raspberry Pi OS 64 Bit  
\- FFmpeg  
\- MediaMTX

\------------------------------------------------------------------------

\# 5. Voraussetzungen

``` bash  
uname -a  
```

Sollte `aarch64` enthalten.

\------------------------------------------------------------------------

\# 6. Installation

\## Webcam prüfen

``` bash  
lsusb  
ls /dev/video\*  
v4l2-ctl --all  
v4l2-ctl --list-formats-ext  
```

Auflösung setzen:

``` bash  
v4l2-ctl --set-fmt-video=width=1920,height=1080,pixelformat=MJPG  
v4l2-ctl --set-parm=30  
```

\## FFmpeg

``` bash  
sudo apt update  
sudo apt install ffmpeg  
```

\## MediaMTX

``` bash  
cd /tmp  
wget https://github.com/bluenviron/mediamtx/releases/download/v1.19.2/mediamtx\_v1.19.2\_linux\_arm64.tar.gz  
tar xzf mediamtx\_v1.19.2\_linux\_arm64.tar.gz

sudo mv mediamtx /usr/local/bin/  
sudo mkdir -p /etc/mediamtx  
sudo cp mediamtx.yml /etc/mediamtx/  
```

Version:

``` bash  
mediamtx --version  
```

\------------------------------------------------------------------------

\# 7. MediaMTX konfigurieren

Datei:

`/etc/mediamtx/mediamtx.yml`

``` yaml  
paths:  
 webcam:  
```

\------------------------------------------------------------------------

\# 8. systemd-Dienst MediaMTX

Datei:

`/etc/systemd/system/mediamtx.service`

``` ini  
\[Unit\]  
Description=MediaMTX RTSP Server  
After=network.target

\[Service\]  
ExecStart=/usr/local/bin/mediamtx /etc/mediamtx/mediamtx.yml  
Restart=always  
RestartSec=5

\[Install\]  
WantedBy=multi-user.target  
```

Aktivieren:

``` bash  
sudo systemctl daemon-reload  
sudo systemctl enable mediamtx  
sudo systemctl start mediamtx  
```

\------------------------------------------------------------------------

\# 9. Webcam-Dienst

Datei:

`/etc/systemd/system/webcam.service`

``` ini  
\[Unit\]  
Description=Logitech C920 RTSP Stream  
After=mediamtx.service  
Requires=mediamtx.service

\[Service\]  
ExecStart=/usr/bin/ffmpeg \\  
-f v4l2 \\  
-input\_format mjpeg \\  
-framerate 30 \\  
-video\_size 1920x1080 \\  
-i /dev/video0 \\  
-c:v libx264 \\  
-preset ultrafast \\  
-tune zerolatency \\  
-pix\_fmt yuv420p \\  
-f rtsp \\  
-rtsp\_transport tcp \\  
rtsp://127.0.0.1:8554/webcam

Restart=always  
RestartSec=5

\[Install\]  
WantedBy=multi-user.target  
```

Aktivieren:

``` bash  
sudo systemctl daemon-reload  
sudo systemctl enable webcam  
sudo systemctl start webcam  
```

\------------------------------------------------------------------------

\# 10. Funktionstest

\## Dienste

``` bash  
systemctl status mediamtx  
systemctl status webcam  
```

\## Logs

``` bash  
journalctl -u mediamtx -f  
journalctl -u webcam -f  
```

\## Port

``` bash  
ss -tulpn | grep 8554  
```

\## Kamera

``` bash  
sudo fuser -v /dev/video0  
```

\------------------------------------------------------------------------

\# 11. OBS

Quelle:

\*\*Medienquelle\*\*

URL:

``` text  
rtsp://192.168.190.69:8554/webcam  
```

Lokale Datei deaktivieren.

\------------------------------------------------------------------------

\# 12. VLC

``` text  
rtsp://192.168.190.69:8554/webcam  
```

\------------------------------------------------------------------------

\# 13. Home Assistant

``` yaml  
camera:  
\- platform: ffmpeg  
 name: Logitech C920  
 input: rtsp://192.168.190.69:8554/webcam  
```

\------------------------------------------------------------------------

\# 14. Fehlerbehebung

\## Device or resource busy

``` bash  
sudo fuser -v /dev/video0  
```

\## Prozesse

``` bash  
ps -ef | grep ffmpeg  
ps -ef | grep mediamtx  
```

\## Neustart

``` bash  
sudo systemctl restart mediamtx  
sudo systemctl restart webcam  
```

\------------------------------------------------------------------------

\# 15. Performance

CPU:

``` bash  
top  
```

Temperatur:

``` bash  
vcgencmd measure\_temp  
```

\------------------------------------------------------------------------

\# 16. Mehrere Kameras

Weitere Pfade in MediaMTX:

``` yaml  
paths:  
 webcam1:  
 webcam2:  
```

Weitere systemd-Dienste:

\- webcam1.service  
\- webcam2.service

\------------------------------------------------------------------------

\# 17. Updates

MediaMTX:

1\. neue Version herunterladen  
2\. Binary ersetzen  
3\. Dienst neu starten

``` bash  
sudo systemctl restart mediamtx  
```

\------------------------------------------------------------------------

\# 18. Backup

Sichern:

\- /etc/mediamtx  
\- /etc/systemd/system/webcam.service  
\- /etc/systemd/system/mediamtx.service

\------------------------------------------------------------------------

\# Versionshistorie

 Version Beschreibung  
\--------- -------------------------------------------------  
 1.0 Erste Version  
 2.0 Erweitertes Installations- und Wartungs-Runbook