IRL4YOU BOX installieren

1. Das brauchst du

• Eine BELABOX mit dem BELABOX-Image. Getestet sind die Orange Pi 5 Plus und die Radxa ROCK 5B+. Wie du das Image aufspielst, steht in der Anleitung BELABOX einrichten.
• Internet auf der Box. Die Installation lädt fehlende Pakete nach.
• Ein Terminal auf der Box. Am einfachsten per SSH von deinem Rechner. Mit Tastatur und Bildschirm direkt an der Box geht es auch.
• Ein BELABOX-Passwort. Die Oberfläche der BOX nutzt dasselbe Passwort wie die BELABOX. Hat deine Box noch keins, legst du es in Schritt 1 fest.

2. Das Video

Das Video zeigt die Installation von Anfang bis Ende, so wie sie hier beschrieben ist. Die Terminalausgabe darin ist die echte Ausgabe einer Installation, Adresse und Balken sind gekürzt. Die Oberfläche der BELABOX ist schematisch nachgezeichnet, die Bezeichnungen können je nach Version abweichen. Alle Bildschirme zeigen Beispieldaten.

Das Video trägt in Titel und Beschreibung noch das Wort „Beta“. Seit Version 1.0 gilt der Befehl auf dieser Seite. Weicht etwas im Video davon ab, gilt diese Seite.

Kapitel im Video

1. 0:00Überblick und Voraussetzungen (die Reihenfolge in 6 Schritten)
2. 0:24BELABOX-Passwort setzen
3. 0:50SSH einschalten und verbinden
4. 1:26Installieren (ein Befehl, Neustart)
5. 3:10Anmelden
6. 3:46Erste Schritte
7. 4:38Updates, Rückweg und Deinstallation
8. 5:16Hinweise und Links

3. BELABOX-Passwort festlegen

Die Oberfläche der BOX meldet dich mit dem Passwort der BELABOX an. Einen eigenen Setup-Code gibt es nicht.

1. Öffne im Browser die Oberfläche der BELABOX: http://<Adresse der Box>/. Die Adresse der Box findest du zum Beispiel in der Geräteliste deines Routers.
2. Hat die Box schon ein Passwort, bist du fertig und gehst zu Schritt 2.
3. Hat sie noch keins, zum Beispiel nach dem ersten Start eines frischen Images, legst du jetzt eines fest. Merke es dir. Du brauchst es gleich wieder.

4. SSH einschalten und verbinden

Den Installationsbefehl gibst du auf der Box ein, nicht auf deinem Rechner. Dafür verbindest du dich per SSH mit der Box.

1. SSH einschalten: In der Oberfläche der BELABOX gibt es den Bereich „Advanced / developer“. Dort startest du den SSH-Dienst („Start SSH server“). Mit „Show“ siehst du das SSH-Passwort, mit „Reset“ erzeugst du ein neues. Der Benutzername ist user. Die Bezeichnungen können je nach Version der BELABOX etwas abweichen.
2. Terminal öffnen: Unter Windows nimmst du PuTTY, unter Mac und Linux das Programm „Terminal“.
3. Verbinden: Gib ssh user@IP-DER-BOX ein und ersetze IP-DER-BOX durch die Adresse deiner Box. Dann gibst du das SSH-Passwort ein.

Mit Tastatur und Bildschirm direkt an der Box brauchst du kein SSH. Dann tippst du den Befehl im dortigen Terminal.

5. Den Installationsbefehl ausführen

Kopiere diesen einen Befehl, füge ihn im Terminal auf der Box ein und bestätige mit der Eingabetaste:

cd /tmp && rm -rf irl4you-pip-main irl4you-pip.tar.gz && wget -q -O irl4you-pip.tar.gz https://github.com/IRL4YOU/irl4you-pip/archive/refs/heads/main.tar.gz && tar xzf irl4you-pip.tar.gz && cd irl4you-pip-main && sudo sh install/setup.sh

Was der Befehl macht, von links nach rechts:

• cd /tmp && rm -rf irl4you-pip-main irl4you-pip.tar.gz: wechselt in den Ordner /tmp und räumt Reste eines früheren Versuchs weg.
• wget -q -O irl4you-pip.tar.gz https://github.com/…/main.tar.gz: lädt das Paket von GitHub.
• tar xzf irl4you-pip.tar.gz && cd irl4you-pip-main: entpackt es und wechselt in den entpackten Ordner.
• sudo sh install/setup.sh: startet die Installation.

Zuerst aktualisiert die Installation das Grundsystem der Box. Das kann je nach Stand lange dauern und bringt oft einen neuen Kernel mit. Danach installiert sie die IRL4YOU BOX.

Varianten

• Ohne Systemupdate: sudo sh install/setup.sh --ohne-systemupdate statt des letzten Teils.
• Klassisch, ohne Hilfsskript und mit voller Ausgabe: Das Paket wie oben laden und entpacken, dann sudo sh install/install.sh ausführen. Das macht kein Systemupdate und zeigt keinen Fortschrittsbalken.

6. Das siehst du dabei

1. Schritt 1 von 2: Grundsystem. Du siehst nur einen Fortschrittsbalken. Das Skript macht dasselbe wie die Update-Funktion der BELABOX (apt-get update, dann dist-upgrade). Die Paketliste steht später im Protokoll.
2. Schritt 2 von 2: Installation. Je Schritt eine Zeile: Pakete prüfen, Benutzer und Daten anlegen, Programme kopieren, Bild-in-Bild-Baustein, SRTLA-Sender und Encoder bauen, Dienste starten. Das Bauen dauert einige Minuten.
3. Ergebnis. Am Ende steht in Grün „Alles fehlerfrei installiert.“ und ein Link zur Oberfläche. Gibt es Hinweise, stehen sie dort.

Das Protokoll: Alles, was bei der Installation ausgegeben wurde, steht in ~/install-ausgabe.txt. Lesen kannst du es mit cat ~/install-ausgabe.txt. Harmlose Zeilen aus Ubuntu-Paketen, zum Beispiel „rehash: warning: skipping ca-certificates.crt“, stehen nur dort.

Gelingt die Installation der Bluetooth-Bibliothek bleak nicht, die der DJI-Dienst braucht, bricht sie mit einer Meldung ab, bevor etwas verändert wurde.

7. Oberfläche öffnen und anmelden

1. Öffne im Browser http://<Adresse der Box>:8780 (oder den Link, den die Installation am Ende anzeigt). Wichtig ist die Endung :8780.
2. Melde dich mit dem BELABOX-Passwort an. Mit dem Haken Angemeldet bleiben bleibst du 30 Tage angemeldet, auch über Updates hinweg.
3. Beim ersten Öffnen wählst du die Sprache. Es gibt 14 Sprachen. Außer Deutsch sind sie maschinell übersetzt und nicht von Muttersprachlern geprüft.

Ist noch kein Passwort gesetzt, sagt dir die Seite, dass du es zuerst in der BELABOX-Oberfläche festlegen musst. Die Anmeldung erscheint dann von selbst.

Die Oberfläche nimmt nur Anfragen aus privaten Netzen, von der Box selbst und über Tailscale an. Öffentliche Adressen werden abgewiesen. Nach 5 Fehlversuchen bei der Anmeldung gibt es eine Sperre.

8. Wie geht es weiter?

Jetzt läuft die BOX. Die nächsten Schritte machst du in der Oberfläche. Die Anleitungen im Projekt führen dich durch die einzelnen Bereiche:

• Kameras anschließen: RTMP, DJI, HDMI und USB, dazu GoPro
• Senden: SRTLA, Sendewege, Bildaufbau, Live und Vorschau
• Twitch-Chat, Moderation und Akku-Warnung
• Betrieb und Pflege: Update, Sicherung, Protokolle, Fehler melden
• Fernzugriff über Tailscale
• Hardware: Bluetooth- und WLAN-Stick, WLAN der Kameras

Für das Senden brauchst du einen Server, der die Wege wieder zusammenführt. Dafür passen der SRTLA-Server mit Docker und der SRTLA-Relay-Server.

9. Updates, Sicherung und Rückweg

Software-Update der BOX

Ein gelber Punkt in der Kopfleiste („Update Oberfläche“) zeigt, dass eine neuere Version da ist. Kameras, Server und Einstellungen bleiben beim Update erhalten.

1. Beende eine laufende Übertragung. Während einer Übertragung ist das Update gesperrt.
2. Öffne die Karte Software-Update (IRL4YOU BOX) und klicke Nach Updates suchen.
3. Klicke Update installieren und bestätige. Die Oberfläche startet dabei kurz neu, etwa eine halbe Minute. Danach lädt die Seite von selbst neu.

Die jetzige Version wird vorher gesichert, die letzten 5 Versionen bleiben gesichert. Klappt ein Update nicht, stellt der Update-Helfer die vorige Version automatisch wieder her. Unter „Auf eine bestimmte Version wechseln“ gehst du bei Bedarf auf eine frühere Version zurück. Ein erneutes Installieren per Befehl ist dafür nicht nötig.

System-Updates der BELABOX

Die Karte System-Updates (BELABOX) installiert echte Systemupdates, auch Kernel. Nutze sie nur ohne laufende Übertragung und mit stabiler Stromversorgung. Danach ist meist ein Neustart nötig, und du solltest die Kameras neu prüfen. Ein automatisches Zurückrollen gibt es hier nicht.

Einstellungen sichern

Das hilft zum Beispiel, wenn du die Speicherkarte neu aufspielst. In der Karte Einstellungen sichern lädst du eine Datei herunter. Mit Passwörtern ist sie immer verschlüsselt (AES-256). Das Passwort für die Datei wird nirgends gespeichert, merke es dir gut. Nicht enthalten sind das Passwort der Oberfläche, SSH, Schlüssel, der Twitch-Token, Tailscale und die Bluetooth-Kopplung der DJI-Kameras. Nach dem Einspielen koppelst du die DJI-Kameras neu, meldest dich bei Twitch neu an und verbindest Tailscale neu.

Rückweg

Du kannst die BOX wieder entfernen: im Ordner irl4you-pip-main den Befehl sudo sh install/install.sh uninstall ausführen. Das entfernt Dienste und Programme. Zustand, Sicherungen, Protokolle und der Benutzer pipbox bleiben liegen. Fehlt der Ordner, lade das Paket mit den ersten drei Teilen des Befehls aus Schritt 3 noch einmal.

10. Wenn etwas nicht klappt

Fehler melden: Am einfachsten über die Box unter Optionen → Problem melden / Wunsch äußern. Die Box bereitet das Formular auf GitHub vor. Lade vorher in der Karte Protokolle das Protokoll herunter und sieh es kurz durch, bevor du es weitergibst. Fragen kannst du auch im Discord stellen.

11. Sicherheit in Kürze

• Vertraue dem Repository. Bei Updates läuft Code aus dem Repository als root auf deiner Box.
• Fremde WLANs: Im Netz, über das die Box sendet, ist die Oberfläche unverschlüsselt (HTTP). Dort kann jeder mitlesen. Nutze sie dort nur über Tailscale (HTTPS) oder schalte „Über fremde WLANs sperren“ ein.
• Von unterwegs: Nimm Tailscale statt einer öffentlichen Freigabe. Der Knopf „Funnel“ macht die Oberfläche öffentlich im Internet, geschützt nur durch das BELABOX-Passwort. Schalte ihn nur ein, wenn du das wirklich willst.
• Zugangsdaten (BELABOX-Passwort, Stream-ID, WLAN-Daten) liegen nur auf der Box mit eingeschränkten Rechten.
• SSH schaltest du nur ein, wenn du es brauchst.

12. Häufige Fragen

Mehr zur BOX

• IRL4YOU BOX: Funktionen, Teststand und getestete Hardware
• IRL4YOU BOX 1.0 ist da: das ist neu
• BELABOX einrichten: Grundlage für alles Weitere
• GitHub mit Quellcode und Anleitungen, Fragen und Ideen im Discord

Unabhängiges Zusatzprojekt: Die IRL4YOU BOX ist kein Produkt von BELABOX, Radxa oder DJI.