Automation15 min read

NOALBS setupgids

NOALBS (Nginx OBS Automatic Low Bitrate Switching) bewaakt de kwaliteit van je stream en schakelt automatisch OBS-scènes wanneer je verbinding wegvalt of je bitrate te laag is. Zo blijven je kijkers betrokken, zelfs als je verbindingsproblemen hebt.

Wat doet NOALBS?

Bitratebewaking

Bewaakt de bitrate van je stream in realtime. Zakt die onder je drempelwaarde, dan schakelt NOALBS automatisch over naar je LOW- of BRB-scène.

Detectie van verbindingsuitval

Detecteert wanneer je encoder volledig wegvalt en schakelt over naar een BRB-scène, zodat kijkers iets zien in plaats van een bevroren beeld.

Chatcommando's

Bedien OBS vanuit de Twitch/Kick-chat. Schakel tussen scènes, controleer je bitrate en beheer je stream zonder je computer te hoeven gebruiken.

Automatisch herstel

Schakelt automatisch terug naar de LIVE-scène zodra je verbinding is hersteld, met instelbare logica voor nieuwe pogingen.

Vereisten

  • OBS Studio met WebSocket ingeschakeld (in OBS 28+ is dit ingebouwd)
  • Scènes aangemaakt in OBS: LIVE, LOW, BRB (en optioneel REFRESH, STARTING, ENDING)
  • Een IRLServer-endpoint met stats URL (beschikbaar in je dashboard)
  • Een computer met Windows, macOS of Linux om NOALBS op uit te voeren

Installatiestappen

1

Download NOALBS

Download de nieuwste NOALBS-release van GitHub. Kies de versie voor je besturingssysteem:

Pak het gedownloade ZIP-bestand uit in een map op je computer. Je ziet dan het uitvoerbare bestand van NOALBS en een config.json-bestand.
2

Enable OBS WebSocket

NOALBS communiceert met OBS via WebSocket. Schakel dit in OBS in:

  1. Open OBS Studio
  2. Ga naar Tools → WebSocket Server Settings
  3. Vink "Enable WebSocket server" aan
  4. Stel een wachtwoord in (dit heb je nodig voor de NOALBS-configuratie)
  5. Noteer de poort (standaard is dit 4455)
3

Create Your Scenes

Maak de volgende scènes aan in OBS:

  • LIVEJe hoofdstreamingscène met de mediabron
  • LOWWordt getoond bij lage bitrate (kan de feed + een waarschuwing bevatten)
  • BRBWordt getoond wanneer de verbinding is verbroken (clipspeler, statische afbeelding, enz.)
  • REFRESH(Optioneel) Wordt weergegeven tijdens het vernieuwen van de Media Source
Scenenamen zijn hoofdlettergevoelig. Zorg dat ze exact overeenkomen met wat je in de config hebt ingevuld.
4

Configure NOALBS

Bewerk het bestand config.json met je instellingen. Gebruik onze config-generator voor een eenvoudige setup:

Belangrijke instellingen om te configureren:

  • OBS WebSocket-host, -poort en -wachtwoord
  • Je stats URL uit het IRLServer-dashboard
  • Bitrate triggers (bijv. overschakelen naar LOW onder 800 kbps)
  • Scènenamen die exact overeenkomen met je OBS-scènes
5

Setup Chat Integration (Optional)

Voor Twitch chatcommando heb je een Twitch OAuth-token nodig. Maak een .env-bestand aan in de map NOALBS:

TWITCH_BOT_USERNAME=your_bot_username
TWITCH_BOT_OAUTH=oauth:your_token_here

Haal je OAuth token op via twitchtokengenerator.com

6

Run NOALBS

Start het uitvoerbare bestand van NOALBS. Je zou moeten zien dat het verbinding maakt met OBS en je streamstatistieken begint te monitoren.

Laat NOALBS draaien wanneer je streamt. Je kunt het minimaliseren naar het systeemvak of als service uitvoeren.

Chatcommando's

NOALBS ondersteunt verschillende chatcommando, ingedeeld op permissieniveau. Het standaardvoorvoegsel is "!".

Admin-commands

!start

Start streaming in OBS

Admin
!stop

Stop streaming in OBS

Admin
!switch [scene]

Switch to a specific scene

Admin
!live

Switch to LIVE scene

Admin
!privacy

Switch to privacy scene

Admin
!record

Toggle recording

Admin

Moderator-commands

!trigger [value]

Set low bitrate trigger threshold (kbps)

Mod
!otrigger [value]

Set offline trigger threshold (kbps)

Mod
!fix / !refresh

Try to fix the stream (refresh media source)

Mod
!sourceinfo

Show current source information

Mod

Openbare commands

!bitrate

Show current stream bitrate

Public

Problemen oplossen

NOALBS kan geen verbinding maken met OBS: Controleer of WebSocket is ingeschakeld in OBS en of het wachtwoord/de poort in je configuratie overeenkomen met de OBS-instellingen.
Schakelen tussen scènes werkt niet: Controleer of de scènenamen in config.json exact overeenkomen met je OBS-scènes (hoofdlettergevoelig).
De stats URL geeft fouten terug: Zorg ervoor dat je encoder naar het endpoint streamt. Controleer de stats URL in je browser - je zou JSON-gegevens moeten zien.
Hulp nodig? Word lid van onze Discord of bekijk de NOALBS Wiki.

Hulpmiddelen