Automation15 min read

NOALBS guide de configuration

NOALBS (Nginx OBS Automatic Low Bitrate Switching) surveille l’état de votre stream et change automatiquement de scène OBS lorsque votre connexion coupe ou que le bitrate devient trop faible. Vous gardez ainsi vos spectateurs engagés même en cas de problèmes de connexion.

Que fait NOALBS ?

Surveillance du bitrate

Surveille le bitrate de votre stream en temps réel. Lorsqu’il passe sous votre seuil, NOALBS bascule automatiquement vers votre scène LOW ou BRB.

Détection des déconnexions

Détecte lorsque votre encoder se déconnecte complètement et bascule vers une scène BRB pour que les spectateurs voient autre chose qu’une image figée.

Commandes de chat

Contrôlez OBS depuis le chat Twitch/Kick. Changez de scène, vérifiez le bitrate et gérez votre stream sans toucher à votre ordinateur.

Rétablissement automatique

Revient automatiquement à la scène LIVE lorsque votre connexion est rétablie, avec une logique de réessai configurable.

Prérequis

  • OBS Studio avec WebSocket activé (OBS 28+ l’intègre nativement)
  • Scènes créées dans OBS : LIVE, LOW, BRB (et, en option, REFRESH, STARTING, ENDING)
  • Un endpoint IRLServer avec une URL de statistiques (disponible dans votre tableau de bord)
  • Un ordinateur Windows, macOS ou Linux pour exécuter NOALBS

Étapes de configuration

1

Download NOALBS

Téléchargez la dernière version de NOALBS depuis GitHub. Choisissez la version correspondant à votre système d’exploitation :

Télécharger depuis GitHub
Extrayez le fichier ZIP téléchargé dans un dossier sur votre ordinateur. Vous devriez voir l’exécutable NOALBS et un fichier config.json.
2

Enable OBS WebSocket

NOALBS communique avec OBS via WebSocket. Activez-le dans OBS :

  1. Ouvrez OBS Studio
  2. Allez dans Outils → WebSocket Server Settings
  3. Cochez « Enable WebSocket server »
  4. Définissez un mot de passe (vous en aurez besoin pour la configuration de NOALBS)
  5. Notez le port (4455 par défaut)
3

Create Your Scenes

Créez les scènes suivantes dans OBS :

  • LIVEVotre scène principale de streaming avec la source média
  • LOWAffichée en cas de bitrate faible (peut inclure le flux + un avertissement)
  • BRBAffichée en cas de déconnexion (lecteur de clips, image fixe, etc.)
  • REFRESH(Facultatif) Affiché pendant l’actualisation de la source média
Les noms de scène sont sensibles à la casse. Assurez-vous qu’ils correspondent exactement à ce que vous avez indiqué dans la config.
4

Configure NOALBS

Modifiez le fichier config.json avec vos paramètres. Utilisez notre générateur de configuration pour une configuration facile :

Ouvrir le générateur de configuration NOALBS

Paramètres clés à configurer :

  • Hôte, port et mot de passe d’OBS WebSocket
  • Votre URL de statistiques depuis le tableau de bord IRLServer
  • Déclencheurs de bitrate (p. ex. : passer à LOW en dessous de 800 kb/s)
  • Noms de scène correspondant exactement à vos scènes OBS
5

Setup Chat Integration (Optional)

Pour les commandes de chat Twitch, vous avez besoin d’un jeton OAuth Twitch. Créez un fichier .env dans le dossier NOALBS :

TWITCH_BOT_USERNAME=your_bot_username
TWITCH_BOT_OAUTH=oauth:your_token_here

Obtenez votre OAuth token sur twitchtokengenerator.com

6

Run NOALBS

Lancez l’exécutable NOALBS. Vous devriez le voir se connecter à OBS et commencer à surveiller les statistiques de votre stream.

Laissez NOALBS en cours d’exécution pendant vos streams. Vous pouvez le réduire dans la zone de notification ou l’exécuter en tant que service.

Commandes de chat

NOALBS prend en charge différentes commandes de chat organisées par niveau d’autorisation. Le préfixe par défaut est "!".

Commandes administrateur

!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

Commandes modérateur

!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

Commandes publiques

!bitrate

Show current stream bitrate

Public

Dépannage

NOALBS ne parvient pas à se connecter à OBS: Vérifiez que WebSocket est activé dans OBS et que le mot de passe et le port de votre configuration correspondent aux paramètres d’OBS.
Le changement de scène ne fonctionne pas: Vérifiez que les noms de scène dans config.json correspondent exactement à ceux de vos scènes OBS (respect de la casse).
L’URL des statistiques renvoie des erreurs: Assurez-vous que votre encoder streame vers l’endpoint. Vérifiez l’URL des statistiques dans votre navigateur : vous devriez voir des données JSON.
Besoin d’aide ? Rejoignez notre Discord ou consultez le wiki NOALBS.

Ressources

Générateur de configuration

Créez votre config.json

GitHub de NOALBS

Code source et versions

Guide de configuration d’OBS

Configurez OBS pour vos streams IRL

Générateur de tokens OAuth

Générez vos jetons OAuth Twitch