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