NOALBS Anleitung: Automatische OBS-Szenenwechsel

NOALBS liest die Statistik eines RTMP-, SRT- oder SRTLA-Relays und steuert OBS automatisch zwischen LIVE, LOW und OFFLINE

Was macht NOALBS?

NOALBS steht für „Nginx OBS Automatic Low Bitrate Switching“. Das Programm prüft regelmäßig die Statistik deines RTMP-, SRT- oder SRTLA-Servers und steuert OBS über die eingebaute WebSocket-Schnittstelle.

Sinkt die eingehende Bitrate oder verschwindet der mobile Stream vollständig, wechselt NOALBS automatisch auf eine vorbereitete Ersatzszene. Sobald das Signal wieder stabil ist, kann es zurück zur Live-Szene schalten.

Handy / Encoder
       ↓
RTMP-, SRT- oder SRTLA-Server → Statistik → NOALBS → OBS WebSocket
                                                    ├→ LIVE
                                                    ├→ LOW
                                                    └→ OFFLINE

Der wichtigste Vorteil: Das Publikum sieht bei einem Mobilfunkausfall nicht minutenlang ein eingefrorenes Bild, sondern automatisch eine passende Offline- oder BRB-Szene.

1. Die drei Bausteine

1. Stream-Statistik

NOALBS liest die Bitrate und den Verbindungszustand vom Ingest-Server. Dafür muss die richtige Statistikadresse sowie der richtige Streamname eingetragen sein.

2. Entscheidungslogik

Die eingelesenen Werte werden mit festgelegten Grenzen verglichen. Erst nach mehreren schlechten Messungen erfolgt ein Szenenwechsel.

3. OBS WebSocket

Über OBS WebSocket 5.x wählt NOALBS die gewünschte Szene aus. Standardmäßig verwendet OBS dafür Port 4455.

2. Szenen und Zustände

NOALBS-Zustände und die zugehörigen OBS-Szenen
NOALBS-Zustand	Typische OBS-Szene	Verwendung
`normal`	LIVE	Der mobile Stream ist stabil und oberhalb der festgelegten Bitrate.
`low`	LOW	Das Signal ist noch vorhanden, aber die Bitrate reicht nicht mehr für ein sauberes Bild.
`offline`	OFFLINE oder BRB	Der Stream ist getrennt oder praktisch ohne nutzbare Daten.

Die Namen in der Konfiguration müssen exakt mit den Namen der OBS-Szenen übereinstimmen. Groß- und Kleinschreibung sowie Leerzeichen sind wichtig.

Optionale Szenen

starting: Startbild vor dem eigentlichen Live-Signal
ending: Abschlussbild am Ende des Streams
privacy: manuell abrufbare Privatsphäre- oder Pausenszene
refresh: Szene zum erzwungenen Neustart einer Medienquelle

3. Schwellenwerte richtig verstehen

Schwellenwerte für Bitrate und SRT-Laufzeit
Einstellung	Bedeutung	Beispiel
`low`	Unterhalb dieser Bitrate gilt der Stream als beeinträchtigt.	`1000` kbit/s
`offline`	Unterhalb dieser Bitrate wird die Offline-Szene verwendet.	`100` kbit/s
`rtt`	Hohe SRT-Laufzeit, ab der der Stream als schlecht gilt.	`1500` ms
`rttOffline`	Sehr hohe SRT-Laufzeit, ab der auf Offline gewechselt wird.	`3500` ms

Nicht blind übernehmen: Die passenden Werte hängen von Auflösung, Encoder-Bitrate, Server und gewünschter Reaktionszeit ab. Ein 8-Mbit/s-Stream braucht andere Grenzen als ein 2-Mbit/s-Stream.

4. Wichtige Schalter in der Konfiguration

Wichtige NOALBS-Schalter
Funktion	Was sie bewirkt
`bitrateSwitcherEnabled`	Aktiviert oder deaktiviert den automatischen Szenenwechsel.
`onlySwitchWhenStreaming`	Wechselt Szenen nur, während OBS selbst zu einer Plattform streamt. Für Tests ist `false` oft einfacher.
`instantlySwitchOnRecover`	Wechselt nach der Erholung sofort zurück zur Live-Szene, ohne erneut alle Prüfversuche abzuwarten.
`retryAttempts`	Anzahl aufeinanderfolgender schlechter Messungen vor dem Wechsel. Bei einer Prüfung pro Sekunde entsprechen fünf Versuche ungefähr fünf Sekunden.
`autoSwitchNotification`	Erlaubt Benachrichtigungen über automatische Wechsel, wenn die Chat-Anbindung eingerichtet ist.
`offlineTimeout`	Kann den ausgehenden OBS-Stream nach längerer Offline-Zeit automatisch beenden.
`recordWhileStreaming`	Startet eine lokale OBS-Aufzeichnung zusammen mit dem Livestream.

5. Welchen Stream-Server überwacht NOALBS?

NOALBS unterstützt verschiedene Statistikquellen. Entscheidend ist immer, dass die Adresse vom NOALBS-Rechner oder -Container erreichbar ist.

Nginx-RTMP aus unserer Anleitung

"streamServer": {
  "type": "Nginx",
  "statsUrl": "http://SERVER-IP:8081/stat.xml",
  "application": "live",
  "key": "DEIN_STREAM_KEY"
}

SRT-Live-Server im glowf1sh-Container

"streamServer": {
  "type": "SrtLiveServer",
  "statsUrl": "http://127.0.0.1:8181/stats",
  "publisher": "publish/live/DEIN_LANGER_KEY"
}

SRTLA über Redefined Streaming

NOALBS kann auch zusammen mit einem SRTLA-Relay von Redefined Streaming verwendet werden. Der mobile Stream läuft dabei über den Redefined-Streaming-Dienst zu OBS, während NOALBS die für den eigenen Relay beziehungsweise Feed bereitgestellten Statistikdaten überwacht.

In NOALBS werden dafür die Statistikadresse und Streamkennung aus dem Redefined-Streaming-Bereich eingetragen. Sobald NOALBS daraus Bitrate und Verbindungszustand lesen kann, funktionieren die automatischen Wechsel zwischen LIVE, LOW und OFFLINE genauso wie bei einem eigenen SRTLA-Server.

Wichtig: Nicht die normale Wiedergabeadresse für OBS als Statistikadresse verwenden. Maßgeblich sind die NOALBS- beziehungsweise Statistikdaten, die Redefined Streaming für den jeweiligen SRTLA-Feed bereitstellt.

Weitere unterstützte Quellen sind unter anderem Node Media Server, Nimble, BELABOX, MediaMTX und WebSocket-basierte Statistiken.

6. Verbindung zu OBS

OBS-Produktionsplatz für automatisierte Szenenwechsel

In OBS wird unter Werkzeuge → WebSocket-Servereinstellungen der WebSocket-Server aktiviert. NOALBS benötigt Host, Port und Passwort.

"software": {
  "type": "Obs",
  "host": "127.0.0.1",
  "password": "DEIN_OBS_WEBSOCKET_PASSWORT",
  "port": 4455
}

Läuft NOALBS auf demselben Rechner wie OBS, ist 127.0.0.1 die einfachste Wahl. Bei einem anderen Rechner muss OBS WebSocket über das Netzwerk erreichbar und durch ein starkes Passwort geschützt sein.

7. Chat-Befehle und Zusatzfunktionen

Die Chat-Anbindung ist optional. Der automatische Szenenwechsel funktioniert grundsätzlich auch ohne Chatbot. Mit eingerichteter Twitch- oder Kick-Anbindung können je nach Plattform und Version zusätzliche Befehle verwendet werden.

Optionale Chat-Befehle
Befehl	Zweck
`!bitrate`	Zeigt die aktuell erkannte Bitrate.
`!switch SZENE`	Wechselt manuell zu einer OBS-Szene.
`!privacy`	Aktiviert die vorbereitete Privatsphäre-Szene.
`!refresh`	Versucht die Medienquelle über die Refresh-Szene neu aufzubauen.
`!trigger WERT`	Ändert den Low-Bitrate-Schwellenwert während des Betriebs.

Zugangsdaten schützen: OAuth-Token und Passwörter gehören niemals in Screenshots, öffentliche Downloads oder eine Webseite.

8. Beispiel: Was passiert bei einem Verbindungsabbruch?

Der Smartphone-Stream läuft stabil mit 6.000 kbit/s. OBS zeigt LIVE.
Die Mobilfunkverbindung wird schwach und fällt unter 1.000 kbit/s.
NOALBS wartet die eingestellten Prüfversuche ab und schaltet auf LOW.
Der Stream bricht vollständig ab. NOALBS schaltet auf OFFLINE.
Das Handy verbindet sich erneut und liefert wieder eine stabile Bitrate.
NOALBS schaltet zurück auf LIVE. Die Medienquelle wird beim Aktivieren neu gestartet.

9. So sollte die Einrichtung getestet werden

OBS öffnen und WebSocket-Verbindung prüfen.
NOALBS zunächst mit onlySwitchWhenStreaming: false starten.
Handy-Stream starten und den Wechsel zu LIVE beobachten.
Bitrate testweise stark reduzieren und LOW prüfen.
Sender vollständig beenden und OFFLINE prüfen.
Sender erneut starten und kontrollieren, ob Bild und LIVE-Szene zurückkehren.
Erst danach Chat, automatische Streamstarts oder weitere Server ergänzen.

Guter Grundaufbau: Erst Statistik → OBS → drei Szenen zuverlässig testen. Zusätzliche Bots und Befehle kommen anschließend.

10. Grenzen und wichtige Hinweise

NOALBS repariert keine schlechte Mobilfunkverbindung; es reagiert lediglich sinnvoll darauf.
Eine falsche Statistikadresse führt häufig dazu, dass dauerhaft OFFLINE erkannt wird.
Eine eingefrorene Medienquelle braucht passende OBS-Optionen wie „Wiedergabe neu starten, wenn Quelle aktiv wird“.
Zu niedrige Verzögerungen und zu aggressive Grenzwerte können unnötige Szenenwechsel verursachen.
Die im glowf1sh-Container enthaltene NOALBS-Version 2.11.2 ist älter als der aktuelle Stand des Hauptprojekts.

Aktuelle Referenz: offizielle NOALBS-Dokumentation auf GitHub.

Danke an das NOALBS-Projekt

Ein herzliches Dankeschön geht an die Entwicklerinnen, Entwickler und Mitwirkenden von NOALBS. Durch ihre Arbeit steht der IRL-Streaming-Community eine offene Lösung zur Verfügung, die Streamausfälle erkennt und OBS automatisch auf eine passende Szene umschaltet.

Wer das Projekt verwenden, den Quellcode ansehen, Fehler melden oder die weitere Entwicklung verfolgen möchte, findet alle Informationen im offiziellen Projekt:

Offizielles NOALBS-Projekt auf GitHub besuchen

IRL4YOU ist ein unabhängiges Informationsangebot und nicht offiziell mit dem NOALBS-Projekt verbunden.

NOALBS-Einrichtungsservice & Beratung

Du möchtest NOALBS einsetzen, bist dir bei der Verbindung zum RTMP-, SRT- oder SRTLA-Server aber noch unsicher? Wir unterstützen dich bei der Einrichtung und stimmen die Konfiguration auf deinen eigenen Streaming-Workflow ab.

Statistikquelle und Streamkennung richtig eintragen
NOALBS mit OBS WebSocket verbinden
LIVE-, LOW-, OFFLINE- und BRB-Szenen konfigurieren
Bitrate, Prüfversuche und Umschaltzeiten sinnvoll einstellen
Funktion mit eigenem Relay oder Redefined Streaming testen

NOALBS-Einrichtungsservice über Discord anfragen