OBS einrichten: Overlay erfassen + WebSocket

Zappify hat keine Browser-Quellen und keine URLs pro Modul. Stattdessen rendern alle Overlay-Module in ein gemeinsames transparentes Fenster („Zappify - Overlay"), das du einmal als Fensteraufnahme in OBS ziehst. Getrennt davon steuert Zappify über den in OBS eingebauten WebSocket-Server (v5) Szenen, Quellen und Audio und erkennt laufende Aufnahmen — das ist die Grundlage für ClipModule, ReplayModule und die Facecam-Steuerung. Der Ersteinrichtungs-Assistent kann die Fensteraufnahme des Overlays beim ersten Start automatisch in OBS anlegen und auf Leinwandgröße ziehen. Für OBS-Filter (z. B. Weichzeichner), die synchron mit einem Modul ein-/ausgeblendet werden sollen, gibt es einen zentralen „OBS-Filter“-Tab statt Einstellungen in jedem Modul einzeln.

Auslöser Fensteraufnahme einmalig in OBS anlegen; WebSocket einmalig im Control-Panel unter Einstellungen → OBS.

Voraussetzungen

• OBS Studio 28 oder neuer (WebSocket v5 ist dort bereits eingebaut).
• Zappify läuft. Das Overlay-Fenster startet automatisch mit und liegt unsichtbar am Bildschirmrand, bis ein Modul etwas anzeigt.
• Für den WebSocket: OBS und Zappify auf demselben Rechner (oder einem im Netzwerk erreichbaren). Die Fensteraufnahme selbst funktioniert nur lokal auf dem Zappify-PC.
• Die einzige echte Browser-Quelle ist der optionale Facecam-Rahmen — dessen URL steht im Facecam-Tab.

Schritt für Schritt

1. Overlay erfassen: In OBS eine Quelle „Fensteraufnahme" hinzufügen und das Fenster „Zappify - Overlay" wählen.
2. Aufnahmemethode auf „Windows 10 (1903 und neuer)" bzw. „Windows Graphics Capture" stellen — nur so werden Transparenz und das am Bildschirmrand liegende Fenster korrekt übernommen.
3. Die Quelle auf 1920×1080 ziehen und in der Szene ganz oben halten. Die Position einzelner Module stellst du im Positionen-Tab in Zappify ein, nicht in OBS.
4. WebSocket (optional, für Clips, Replay, Facecam-Steuerung, Audio-Mixer): In OBS Werkzeuge → WebSocket-Server-Einstellungen öffnen, „WebSocket-Server aktivieren" anhaken, Port notieren (Standard 4455), optional Authentifizierung + Passwort setzen.
5. Im Control-Panel unter Einstellungen → OBS Host (localhost), Port und Passwort eintragen und auf „Verbinden" klicken — der Status wechselt auf „verbunden".
6. Optional: Haken bei „Audio über OBS steuern" setzen, um die Overlay-Lautstärke getrennt im OBS-Audio-Mixer zu regeln.
7. Einige Module öffnen ein eigenes Fenster (THE DROP, Infection-Game, Replay-Slider, Screen Picker) — bei Bedarf jeweils eine zusätzliche Fensteraufnahme dafür anlegen.

Wenn's nicht klappt

• Fensteraufnahme ist schwarz oder undurchsichtig: Aufnahmemethode auf „Windows Graphics Capture" umstellen — die alte BitBlt-Methode erfasst das randlose transparente Fenster nicht zuverlässig.
• „Zappify - Overlay" fehlt in der Fensterliste: Zappify muss laufen und das Fenster muss schon einmal etwas angezeigt haben — im Positionen-Tab oder mit einer Modul-Testanzeige einmal einblenden.
• „Connection refused" (WebSocket): Server in OBS nicht aktiviert oder falscher Port.
• „Authentication failed": Passwort stimmt nicht — in OBS erneut anzeigen lassen und exakt übernehmen.
• Anderer Rechner: In den OBS-Einstellungen von Zappify statt localhost die LAN-IP eintragen und Port 4455 in der Windows-Firewall freigeben. Das betrifft nur den WebSocket — das Overlay lässt sich nicht über das Netzwerk in ein OBS auf einem zweiten PC holen.

Zuletzt aktualisiert: 19. September 2026