Comment connecter CYPAD à OBS via WebSocket

Avant de commencer

Il faut les deux programmes ouverts et une licence qui débloque le contrôle OBS. Préparez ces éléments avant de modifier quoi que ce soit :

• Un PC sous Windows 10 ou 11 avec CYPAD installé depuis le Microsoft Store
• OBS Studio ouvert sur ce même PC
• Une licence Pro dans CYPAD : les actions OBS ne font pas partie de l’offre gratuite
• Les noms exacts de vos scènes et de votre entrée audio

Activer le serveur WebSocket dans OBS

Dans OBS, ouvrez Outils → WebSocket Server Settings. Cochez Enable WebSocket server et vérifiez le port : CYPAD attend 4455, la valeur par défaut. Si vous activez l’authentification, OBS génère un mot de passe ; copiez-le.

• 1. Ouvrez OBS et allez dans Outils → WebSocket Server Settings.
• 2. Activez le serveur WebSocket.
• 3. Notez le port (4455 par défaut) et le mot de passe si vous utilisez l’authentification.
• 4. Cliquez sur Apply et laissez OBS ouvert.

Configurer la connexion dans CYPAD

Dans CYPAD, passez en mode Stream et repérez la carte OBS. Les champs reprennent ce qu’OBS vient d’afficher.

• 1. Dans la carte OBS, saisissez l’hôte : 127.0.0.1 si OBS tourne sur le même PC.
• 2. Saisissez le port : 4455, sauf si vous l’avez changé dans OBS.
• 3. Collez le mot de passe si vous l’avez activé ; sinon laissez le champ vide.
• 4. Cliquez sur Connecter ou Tester la connexion et lisez le message.

Créer vos premières touches OBS

Une fois la connexion en place, chaque action est un bouton normal du pad. Dans Nouveau → Bouton, choisissez l’action OBS puis ce qu’elle doit faire.

• 1. Choisissez l’action OBS, puis direct, enregistrement, scène ou coupure.
• 2. Pour une scène, saisissez le nom exact affiché dans OBS.
• 3. Pour couper le micro, saisissez le nom exact de l’entrée audio, par exemple Mic/Aux.
• 4. Donnez un libellé visible à la touche et enregistrez le bouton.

Vérifier que tout répond

Lancez chaque touche et regardez OBS : le direct doit démarrer, la scène changer et le micro se couper. Une seconde plus tard, la touche du pad s’allume si l’état est actif. La touche de la scène active s’allume seule quand cette scène est en programme.

Pas besoin de cliquer sur Connecter avant chaque action : quand une action OBS s’exécute, CYPAD tente une connexion avec l’hôte et le port enregistrés.

Si la connexion échoue

Le message sous le formulaire OBS affiche la dernière connexion, et Tester la connexion le rafraîchit. Voici les causes habituelles :

• « Activez obs-websocket dans OBS pour vous connecter » : le serveur est encore désactivé ; vérifiez la case dans OBS.
• Le port ne correspond pas : s’il a changé dans OBS, saisissez la même valeur dans CYPAD.
• Mot de passe incorrect : recopiez-le depuis OBS ou désactivez l’authentification pendant le test.
• OBS n’est pas ouvert ou a été fermé pendant la configuration.
• La scène ou l’entrée n’existe pas sous ce nom exact ; copiez-le depuis le panneau OBS.
• L’action est verrouillée par le cadenas Pro : sans licence, OBS n’est pas disponible.
• Si OBS tourne sur un autre PC, utilisez son adresse comme hôte et autorisez le port dans le pare-feu.