Grafik: Ein Videobild mit eingeblendetem Overlay unten rechts. Balken zeigen den Anteil jeder Verbindung am Upload, eine Gesamtzeile zeigt Gesamtbitrate und SRT-RTT. Vier Markierungen erklären: Anteil je Verbindung als Kreis oder Balken, Gesamt und RTT, vier wählbare Bildecken sowie bis zu acht Verbindungen.
Orange Pi 5 Plus · ROCK 5B Plus · Version 1.2

Sieh im Stream, welche Verbindung gerade welchen Anteil trägt

Für Orange Pi 5 Plus und Radxa ROCK 5B Plus. Das IRL4YOU Netzwerk-Overlay ergänzt den BELABOX-Encoder um eine frei wählbare Kreis- oder Balkenanzeige. Alle aktiven, im Konfigurator eingetragenen Netzwerkschnittstellen werden automatisch eingeblendet – bis zu acht Verbindungen sind möglich. Die Balkenansicht zeigt zusätzlich Gesamtbitrate, SRT-RTT und auf Wunsch die Temperatur der Box. Namen, Farben, Hintergrund, Zahlenanzeige und Bildecke lassen sich weiterhin passend zum eigenen Stream einstellen.

Inhalt dieser Seite

1. Was zeigt das Netzwerk-Overlay?

Kreise oder Balken

Wähle zwischen der bekannten Kreisansicht und einer besonders kompakten Balkenansicht. Beide zeigen, wie sich der aktuelle Upload auf die aktiven Schnittstellen verteilt. Die Anzeige ist kein Geschwindigkeitstest und misst nicht die maximale Leitungskapazität.

Gesamt, RTT und Temperatur

Die Gesamtanzeige kann aktuelle Gesamtbandbreite und SRT-RTT darstellen. In der Balkenansicht lässt sich zusätzlich die Temperatur der Box einblenden. Bereits vorhandene Messwerte werden wiederverwendet; die Temperatur wird lokal aus dem System gelesen.

Dynamische Anzeige

Wird ein Kabel entfernt oder ein Hotspot unerreichbar, verschwindet die betroffene Verbindung nach kurzer Zeit. Kehrt sie zurück, wird sie ohne Stream-Neustart automatisch wieder einsortiert.

Direkt im Bild

Das Overlay wird direkt auf dem Orange Pi 5 Plus oder Radxa ROCK 5B Plus mit BELABOX-Software erzeugt und dort in das encodierte Videobild eingeblendet. In OBS sind weder eine zusätzliche Browserquelle noch ein zweiter Statistikdienst erforderlich.

2. Freigegebene Hardware und Signalwege

BereichFreigegebener StandHinweis
BoxOrange Pi 5 PlusVersion 1.2 mit Kreis- und Balkenansicht geprüft
BoxRadxa ROCK 5B PlusVersion 1.2 freigegeben; derselbe RK3588-Encoderpfad
RTMP1080p30 und 1080p60beide Darstellungen; lokaler Eingang: rtmp://BOX-IP/publish/live
HDMIBild und HDMI-TonKreis- und Balkenansicht verwenden dieselbe Pipeline
USB/UVCUSB-Kamera, 1080p30beide Darstellungen; Webcam-/UVC-Modus
AusgabeH.265 über Hardware-Encoderdie vorhandenen BELABOX-SRT-Einstellungen bleiben maßgeblich
Freigabestand 20. September 2026: Die Tests gelten für die an diesem Datum vollständig aktualisierten BELABOX-Systeme. Orange Pi 5 Plus und ROCK 5B Plus verwenden denselben Installationsbefehl, denselben Overlay-Baustein und dieselbe Konfiguration; der Installer erkennt das Board automatisch. Die letzte direkte Umschaltprüfung von Kreis zu Balken fand auf dem Orange Pi 5 Plus statt. Nach späteren grundlegenden Änderungen an BELABOX, Betriebssystem oder Pipelines sollte die Kompatibilität erneut geprüft werden.
Bewusst eng freigegeben: Andere BELABOX-Hardware, Kameras, Auflösungen und Bildraten können technisch möglich sein, sind in Version 1.2 aber noch nicht als geprüft gekennzeichnet.
Lokal im Browser

3. Darstellung, Namen, Farben und Position vorbereiten

Übernimm für jede Verbindung den vorhandenen Schnittstellennamen deiner BELABOX, zum Beispiel eth0 oder wlan0. Du findest ihn in der BELABOX-Weboberfläche oder zuverlässig per SSH mit ip -br link. Anschließend wählst du Kreise oder Balken, Anzeigenamen, einzelne Farben, Schriftfarbe, Hintergrund-Deckkraft und eine der vier Bildecken. Empfohlen sind 40 Prozent Deckkraft. Die Balkenansicht kann Gesamtbitrate, RTT und Temperatur oben zusammenfassen. Über das Plus lassen sich bis zu acht Schnittstellen ergänzen. Fällt eine Verbindung weg, schließen die übrigen Anzeigen automatisch die Lücke. Deine Angaben verlassen den Browser nicht.

Vorbereitung per SSH:
  1. SSH in der BELABOX-Oberfläche einschalten.
  2. macOS oder Linux: Terminal öffnen und mit ssh user@IP-DER-BELABOX anmelden.
  3. Windows: denselben Befehl in PowerShell oder Windows Terminal verwenden. Alternativ PuTTY öffnen, unter Host Name die IP-Adresse der BELABOX eintragen, Port 22 und Verbindungstyp SSH wählen, Open anklicken und sich als user anmelden.
  4. Nach der Anmeldung sudo -i eingeben und mit dem Passwort des Benutzers bestätigen.
  5. Mit whoami prüfen: Als Ausgabe muss root erscheinen.
  6. Mit ip -br link die tatsächlichen Schnittstellennamen anzeigen. Typische Namen sind eth0, wlan0 oder wlan1; lo wird nicht eingetragen.
  7. Danach Darstellung, Namen, Farben und Bildecke im Konfigurator festlegen, den persönlichen Installationsbefehl kopieren und in derselben SSH-Konsole ausführen.

Wer bereits einen SSH-Schlüssel für den Root-Zugang eingerichtet hat, kann sich alternativ direkt mit ssh root@IP-DER-BELABOX anmelden.

Wichtig – Linux-Namen exakt aus deiner Box übernehmen: In das Feld „Linux-Name der Box“ gehört genau der Name, den ip -br link auf deiner BELABOX ausgibt, zum Beispiel eth0, eth1, wlan0 oder wlan1. Nicht übersetzen, nicht umbenennen und lo nicht verwenden. Nur der danebenstehende Anzeigename wie „Starlink“, „LAN“ oder „Telekom“ ist frei wählbar.

Darstellungen vergleichen

Beide Varianten verwenden dieselben Verbindungsdaten. Wähle hier oder später im Dropdown die gewünschte Darstellung. Darunter erscheint anschließend die gewählte Variante als große Vorschau.

Auswahlmenü

Gewählte Vorschau

Persönlicher wget-Installationsbefehl

Dieser Befehl wird automatisch aus der gewählten Darstellung, den aktivierten Schnittstellen, Namen, Farben, Schriftfarbe, Hintergrund-Deckkraft, Zahlenanzeige, Bildecke, Gesamtanzeige und Aktualisierungszeit erzeugt. Klicke auf „Persönlichen Installationsbefehl kopieren“, füge ihn in die bereits geöffnete SSH-Konsole der BELABOX ein und bestätige mit Enter. Download, Prüfung, Installation und Übernahme deiner Auswahl laufen anschließend automatisch.

Die Werte der Vorschau sind Beispieldaten. Prozent- und Kilobitwerte entstehen auf der Box aus den tatsächlich übertragenen Bytes der aktiven Schnittstellen. Im Statusmodus bleiben Farben, Namen und Balken beziehungsweise Kreise sichtbar, während die Zahlen entfallen. Die Temperatur gehört ausschließlich zur Balkenansicht.

Download · Version 1.2

4. Installationspaket herunterladen

Das Paket enthält den gemeinsamen Kreis-/Balken-Renderer, Installer, Rücksetzung, Deinstallation, vier Pipelines, Standardkonfiguration, Prüfsummen, Testbericht, GPL-Lizenz und den geänderten Quellcode.

Datei: irl4you-belabox-netzwerk-overlay-1.2.zip
SHA-256: 53a60256bf40bd1370babee53bd4e26646594c135814a8ab6df91d5015cbaa84

Version 1.2 herunterladen
Vor der Installation: Das BELABOX-Grundsystem vollständig aktualisieren, den laufenden Stream stoppen und eine funktionierende Speicherkarte als Rückfallebene behalten. Der Installer legt zusätzlich automatisch eine Sicherung des vorherigen Softwarestands an.

5. Installation auf einer frischen BELABOX

  1. BELABOX-Grundsystem vollständig aktualisieren und SSH aktivieren.
  2. Über Terminal, Windows Terminal, PowerShell oder PuTTY anmelden und zu root wechseln.
  3. Im Konfigurator Darstellung, Schnittstellen, Bezeichnungen, Farben, Schriftfarbe, Deckkraft, Bildecke und Aktualisierung festlegen.
  4. Den dort erzeugten persönlichen wget-Befehl kopieren und auf der Box ausführen.
  5. Nach dem automatischen Neustart der Oberfläche die BELABOX-Seite neu laden.
  6. Eine der vier neuen Pipelines unter custom/ auswählen und zuerst privat testen.

Der persönliche Befehl ist auf Orange Pi 5 Plus und ROCK 5B Plus identisch. Er lädt das ZIP-Paket herunter, kontrolliert die SHA-256-Prüfsumme, startet den Installer und schreibt anschließend genau die im Browser erzeugte Konfiguration nach /etc/irl4you-net-overlay.conf. Der Installer erkennt das Board selbst, prüft Architektur, Paket-Prüfsummen, Laufzeitbibliotheken und benötigte GStreamer-Module. Fehlende GStreamer-Laufzeitpakete werden gezielt ergänzt; Compiler und Entwicklungspakete werden bei einer normalen Installation nicht installiert. Die vorhandenen Originalpipelines werden nicht überschrieben.

Schnelltest nach der Installation:
  1. Eine der neuen custom/-Pipelines auswählen und den Stream starten.
  2. Im Videobild prüfen, ob alle aktiven und im Konfigurator eingetragenen Verbindungen angezeigt werden.
  3. Eine Verbindung kurz trennen. Die zugehörige Anzeige soll verschwinden und nach dem Wiederverbinden automatisch zurückkehren.

Bleiben Videobild und Ton dabei flüssig, arbeitet das Overlay wie vorgesehen. Vor einem öffentlichen Stream empfiehlt sich trotzdem ein kurzer privater Probelauf.

Standardinstallation ohne eigene Auswahl

Wer die mitgelieferte Balkenansicht mit Standardfarben verwenden möchte, kann alternativ genau einen der beiden folgenden Befehle nutzen. wget ist der empfohlene Weg. Fehlen wget, curl oder unzip, installiert der gewählte Befehl nur das benötigte Werkzeug.

Empfohlen: mit wget

set -e; command -v unzip >/dev/null || { apt-get update && apt-get install -y unzip; }; command -v wget >/dev/null || { apt-get update && apt-get install -y wget; }; IRL4YOU_TMP="$(mktemp -d)" && cd "$IRL4YOU_TMP" && wget -O overlay.zip https://irl4you.de/downloads/irl4you-belabox-netzwerk-overlay-1.2.zip && echo "53a60256bf40bd1370babee53bd4e26646594c135814a8ab6df91d5015cbaa84  overlay.zip" | sha256sum -c - && unzip -q overlay.zip && cd BELABOX-NETZWERK-OVERLAY-1.2.0 && bash ./INSTALLIEREN.sh

Alternative: mit curl

set -e; command -v unzip >/dev/null || { apt-get update && apt-get install -y unzip; }; command -v curl >/dev/null || { apt-get update && apt-get install -y curl; }; IRL4YOU_TMP="$(mktemp -d)" && cd "$IRL4YOU_TMP" && curl -fL --retry 3 https://irl4you.de/downloads/irl4you-belabox-netzwerk-overlay-1.2.zip -o overlay.zip && echo "53a60256bf40bd1370babee53bd4e26646594c135814a8ab6df91d5015cbaa84  overlay.zip" | sha256sum -c - && unzip -q overlay.zip && cd BELABOX-NETZWERK-OVERLAY-1.2.0 && bash ./INSTALLIEREN.sh

Die temporären Dateien liegen unter /tmp. Die eigentliche Installation und die automatische Sicherung übernimmt weiterhin INSTALLIEREN.sh.

Bei einer Aktualisierung: Der persönliche Befehl ersetzt die bisherige Overlay-Konfiguration gezielt durch die aktuelle Auswahl. Der Installer sichert den vorherigen Stand zuvor automatisch.

6. Deinstallieren und ursprünglichen Stand wiederherstellen

Vor der Deinstallation den Stream stoppen und sich per SSH als root anmelden. Der folgende Befehl stellt den ursprünglichen BELABOX-Stand vor der ersten IRL4YOU-Installation wieder her. Die IRL4YOU-Zusatz-Pipelines verschwinden damit aus der Auswahl; vorhandene Sicherungen bleiben für den Notfall erhalten.

bash /opt/irl4you/network-overlay/release-1.2.0/DEINSTALLIEREN.sh

Für das Zurückgehen auf die lediglich vorherige IRL4YOU-Version bleibt zusätzlich ZURUECKSETZEN.sh im Installationspaket enthalten.

7. Welche Pipeline passt zu welchem Eingang?

QuellePipeline in der BELABOX-OberflächeAudio
lokales RTMP, 1080p30custom/irl4you_rtmp_network_overlay_1080p30aus dem RTMP-Stream
lokales RTMP, 1080p60custom/irl4you_rtmp_network_overlay_1080p60aus dem RTMP-Stream
HDMI-Eingangcustom/irl4you_hdmi_network_overlayHDMI
USB/UVC-Kamera, 1080p30custom/irl4you_usb_network_overlay_1080p30USB-Audioquelle der Kamera

Bei RTMP sendet die Quelle an rtmp://BOX-IP/publish/live. Für USB muss ein datenfähiges Kabel verwendet und an der Kamera der Webcam-/UVC-Modus gewählt werden. Praktisch geprüft wurde der USB-Weg mit einer DJI Action 5 Pro; andere UVC-Kameras und Actioncams müssen mit ihrem jeweiligen USB-Modus getestet werden.

Geprüfter Stand · 20. September 2026

8. Was wurde praktisch getestet?

Orange Pi 5 Plus: Neuinstallation, RTMP mit 1080p30 und 1080p60, HDMI mit HDMI-Ton, DJI Action 5 Pro über USB/UVC mit 1080p30 und USB-Ton, dynamische Schnittstellenwechsel, Neustart sowie ein zehnminütiger 1080p60-Dauertest. Kreis- und Balkenansicht wurden direkt umgeschaltet und praktisch geprüft.

Radxa ROCK 5B Plus: Dieselben vier Eingangspipelines sowie zusätzlich Fehlkonfiguration, Wiederherstellung der offiziellen BELABOX-Pipelines und drei kontrollierte Stream-Neustarts. Version 1.2 verwendet dort denselben RK3588-Renderer und dieselbe Konfigurationsdatei.

Die Anzeige aktualisiert sich standardmäßig alle zwei Sekunden. Das Videobild läuft davon unabhängig mit seiner eingestellten Bildrate weiter.

Hinweis zu USB-LAN: Bei per USB angeschlossenen Routern kann es nach einem Neustart der BELABOX vorkommen, dass die USB-Netzwerkverbindung zunächst nicht erkannt wird. In diesem Fall das USB-Kabel einmal trennen und wieder anschließen. Sobald Linux die Schnittstelle bereitstellt, nimmt das Netzwerk-Overlay sie automatisch wieder in die Anzeige auf.

9. Lizenz, Quellcode und klare Grenzen

Der geänderte belacoder basiert auf dem offenen BELABOX-Projekt. Deshalb wird diese Erweiterung ebenfalls unter der GNU GPL Version 3 oder neuer bereitgestellt. Der vollständige Lizenztext, der geänderte Quellcode und ein reproduzierbares Build-Skript liegen direkt im Downloadpaket.

Die GPL erlaubt Nutzung, Prüfung, Veränderung und Weitergabe. Wer eine veränderte Fassung verteilt, muss dieselben Freiheiten erhalten, die Lizenzhinweise beibehalten und den zugehörigen Quellcode unter der GPL bereitstellen.

10. Rückmeldung aus weiteren Setups

Die Freigabe bleibt bewusst auf den geprüften Stand begrenzt. Ergebnisse mit anderer Hardware oder weiteren USB-Kameras können im IRL4YOU-Discord mit Quelle, Auflösung, Bildrate und Audioquelle gemeldet werden.

Mehrere Kameras in einem Bild

Für die BELABOX gibt es mit der IRL4YOU BOX ein kostenloses Zusatzpaket für Bild-in-Bild mit bis zu vier Kameras. Es ist eine Beta.

11. Häufige Fragen

Ist das Netzwerk-Overlay ein Geschwindigkeitstest?

Nein. Die Anzeige zeigt, wie sich dein aktueller Upload auf die aktiven Schnittstellen verteilt. Wie viel eine Leitung maximal schaffen würde, misst sie nicht. Und ein Prozentwert sagt dir nicht, wie viel Luft eine Verbindung noch hat.

Brauche ich in OBS eine Browserquelle?

Nein. Das Overlay entsteht direkt auf der BELABOX und steckt schon im encodierten Videobild. Eine Browserquelle oder einen zweiten Statistikdienst brauchst du nicht.

Für welche Hardware ist Version 1.2 freigegeben?

Für den Orange Pi 5 Plus und den Radxa ROCK 5B Plus mit RTMP, HDMI und USB/UVC. Die Details stehen im Abschnitt Kompatibilität. Andere BELABOX-Hardware, Kameras, Auflösungen und Bildraten gehen vielleicht auch, sind aber nicht als geprüft gekennzeichnet.

Wie viele Verbindungen kann das Overlay anzeigen?

Bis zu acht. Fällt eine weg, verschwindet ihre Anzeige nach kurzer Zeit, und die anderen rücken auf. Kommt sie zurück, wird sie ohne Stream-Neustart wieder eingereiht.

Was mache ich, wenn ein USB-Router nach dem Neustart nicht angezeigt wird?

Zieh das USB-Kabel einmal ab und steck es wieder an. Sobald Linux die Schnittstelle bereitstellt, nimmt das Overlay sie automatisch wieder auf. Mehr dazu steht im Abschnitt Teststatus. Verhält es sich anders, melde dich per Rückmeldung im Discord.

Veröffentlicht und praktisch geprüft: · Herausgegeben von IRL4YOU
BELABOX und die genannten Produktnamen dienen der eindeutigen technischen Beschreibung. IRL4YOU ist nicht der Herausgeber des ursprünglichen BELABOX-Projekts.