OBS Studio
Meegeleverd met Macro DeckWissel van scène, bedien je stream, opname en audio, en reageer op wat er in OBS Studio gebeurt.
Het dialoogvenster OBS Studio verbinden met de naam van de configuratie, host, poort en wachtwoord
- Wissel van scène, profiel en scènecollectie
- Start en stop streaming, opname, replaybuffer en virtuele camera
- Demp invoer, stel volumes in en schakel bronnen en filters
- Live variabelen voor scènes, tijdcodes, FPS en verloren frames
- Verbind meerdere OBS-instanties tegelijk
De integratie OBS Studio verbindt Macro Deck met OBS via de WebSocket-server die in OBS is ingebouwd (obs-websocket 5). Zodra de verbinding staat, kunnen je knoppen bijna alles bedienen wat je tijdens een stream in OBS doet, en OBS meldt wat er verandert, zodat je deck altijd de actuele status toont.
Wat je kunt doen
- Wissel de programmascène, de voorbeeldscène in de studiomodus, het profiel of de scènecollectie.
- Start, stop of wissel streaming, opname, de replaybuffer en de virtuele camera, sla een replay op, pauzeer een opname, splits het opnamebestand of voeg een hoofdstukmarkering toe.
- Toon of verberg een bron in een scène, schakel een filter in of uit, demp een invoer of wijzig het volume in procent of dB.
- Wijzig een instelling van een bron, bijvoorbeeld de tekst van een tekstbron, het bestand van een afbeeldings- of mediabron of de URL van een browserbron.
- Start en stop elke OBS-uitvoer op naam, ook uitvoer die door plugins wordt toegevoegd.
Een paar voorbeelden:
- Een knop BRB die naar je BRB-scène wisselt en je microfoon dempt.
- Een knop Opnemen die de opname wisselt en toont of OBS opneemt, gepauzeerd is of gestopt is.
- Een schuifregelaar die aan de variabele
obs_<input>_volumevan je muziekinvoer is gekoppeld, zodat het bewegen van de schuifregelaar het volume in OBS wijzigt. - Een actiestroom die wordt uitgevoerd wanneer OBS Streaming gestart meldt en je een melding stuurt.
Hoe het werkt
Macro Deck luistert naar de gebeurtenissen die OBS verstuurt, zodat variabelen zoals de huidige scène, dempstatussen en filterstatussen binnen een fractie van een seconde bijwerken nadat je ze in OBS wijzigt. Wisselknoppen lichten op zolang hun status actief is, ook wanneer je die in OBS zelf wijzigt. Statistieken zoals FPS, CPU-gebruik, bitrate en verloren frames worden elke één à twee seconden uitgelezen.
Naast de vaste variabelen toont de variabelenkiezer elke invoer, scène, elk scène-item en filter van de verbonden OBS, met het volume, de dempstatus, de zichtbaarheid of de ingeschakelde status. Triggers reageren op scènewissels, wijzigingen in opname en streaming, opgeslagen replays en screenshots, invoer die actief wordt en aangepaste gebeurtenissen die je eigen OBS-scripts uitzenden.
Je kunt meer dan één configuratie toevoegen, bijvoorbeeld een voor je streaming-pc en een voor je gaming-pc. Elke configuratie krijgt een eigen set variabelen, en elke actie heeft een veld Configuratie waarmee je kiest welke OBS ze bedient. Wanneer OBS wordt gesloten of het netwerk wegvalt, blijft Macro Deck proberen opnieuw te verbinden en worden de triggers Niet verbonden en Verbonden geactiveerd.
Wat je nodig hebt
- Macro Deck 3 op Windows, macOS of Linux
- OBS Studio 28 of nieuwer (met obs-websocket 5)
- De WebSocket-server ingeschakeld in OBS onder Tools > WebSocket Server Settings
- Uitvoer op naam starten en stoppen vereist obs-websocket 5.7 of nieuwer
Instellen
Stap 1: Schakel de WebSocket-server in OBS in
Open in OBS Tools > WebSocket Server Settings en vink Enable WebSocket server aan. Noteer de Server Port (standaard
4455). Als Enable Authentication is aangevinkt, klik je op Show Connect Info om het wachtwoord te zien.Stap 2: Open OBS Studio in Macro Deck
Klik in Macro Deck in de zijbalk op Integraties en daarna op OBS Studio. Klik op het tabblad Overzicht in de sectie Configuratie op Configuratie toevoegen. De schakelaar rechtsboven aanzetten opent hetzelfde dialoogvenster, en de integratie wordt ingeschakeld zodra het instellen klaar is.
Stap 3: Vul de verbindingsgegevens in
Vul het dialoogvenster OBS Studio verbinden in:
- Naam configuratie: een naam naar keuze, bijvoorbeeld
Streaming PC. - Host:
127.0.0.1als OBS op dezelfde computer draait, anders het IP-adres van de computer waarop OBS draait. - Poort: de serverpoort uit OBS, standaard
4455. - Wachtwoord: het wachtwoord uit OBS. Laat het leeg als authenticatie is uitgeschakeld.
Klik op Doorgaan. Macro Deck test de verbinding voordat de configuratie wordt opgeslagen.
- Naam configuratie: een naam naar keuze, bijvoorbeeld
Stap 4: Voeg een OBS-actie aan een knop toe
Klik op de pagina Deck op de knop die je wilt gebruiken. Het deck moet ontgrendeld zijn: als op de knop rechtsboven Vergrendelen staat, is het ontgrendeld. De editor opent met Kort indrukken geselecteerd. Klik op + Actie toevoegen, selecteer links in het dialoogvenster Actie toevoegen OBS Studio en kies een actie zoals Scène instellen. Selecteer de Configuratie en de Scène en klik daarna op Opslaan.
Stap 5: Druk op de knop
Druk op de knop op je telefoon, tablet of in de webclient. OBS wisselt naar de scène die je hebt gekozen. Gebeurt er niets, controleer dan of OBS draait en of de configuratie op de pagina OBS Studio onder Integraties Verbonden toont.
Acties35
Zet deze op een knop of voer ze uit vanuit een actiestroom.
- Scène instellen
- Wisselt de actieve programmascène.
- Voorbeeldscène instellen
- Wisselt de voorbeeldscène in de studiomodus.
- Profiel instellen
- Zet OBS over op een ander profiel.
- Scènecollectie instellen
- Zet OBS over op een andere scènecollectie.
- Opname starten
- Start de opname.
- Opname stoppen
- Stopt de opname.
- Opname wisselen
- Start of stopt de opname en toont of OBS opneemt, gepauzeerd is of gestopt is.
- Opname pauzeren/hervatten
- Pauzeert of hervat de huidige opname.
- Streaming starten
- Start de stream.
- Streaming stoppen
- Stopt de stream.
- Streaming wisselen
- Start of stopt de stream.
- Virtuele camera starten
- Start de virtuele camera.
- Virtuele camera stoppen
- Stopt de virtuele camera.
- Virtuele camera wisselen
- Start of stopt de virtuele camera.
- Replaybuffer starten
- Start de replaybuffer.
- Replaybuffer stoppen
- Stopt de replaybuffer.
- Replaybuffer wisselen
- Start of stopt de replaybuffer.
- Replaybuffer opslaan
- Slaat de huidige replaybuffer op schijf op.
- Opnamebestand splitsen
- Start een nieuw opnamebestand terwijl de opname doorloopt.
- Opnamehoofdstuk maken
- Voegt een hoofdstukmarkering toe aan het bestand dat wordt opgenomen (alleen Hybrid MP4-formaat).
- Opnamemap instellen
- Stelt de map in waarin OBS nieuwe opnames opslaat.
- Uitvoer starten
- Start een OBS-uitvoer op naam, ook uitvoer die door plugins wordt toegevoegd.
- Uitvoer stoppen
- Stopt een OBS-uitvoer op naam, ook uitvoer die door plugins wordt toegevoegd.
- Uitvoer wisselen
- Start of stopt een OBS-uitvoer op naam, ook uitvoer die door plugins wordt toegevoegd.
- Uitvoerstatus ophalen
- Leest in een variabele of een OBS-uitvoer actief is.
- Bronzichtbaarheid instellen
- Toont, verbergt of wisselt een bron in een scène.
- Invoer dempen
- Dempt een audio-invoer, heft de demping op of wisselt die.
- Invoervolume instellen
- Stelt het volume van een audio-invoer in procent of dB in, of verhoogt of verlaagt het.
- Bronfilter instellen
- Schakelt een filter op een bron in, uit of wisselt het.
- Invoerinstelling instellen
- Wijzigt één instelling van een bron, bijvoorbeeld de tekst van een tekstbron of de URL van een browserbron.
- Invoervolume ophalen
- Leest het volumepercentage van een audio-invoer in een variabele.
- Filterstatus ophalen
- Leest in een variabele of een bronfilter is ingeschakeld.
- Dempstatus van invoer ophalen
- Leest in een variabele of een audio-invoer gedempt is.
- Bronzichtbaarheid ophalen
- Leest in een variabele of een bron in een scène zichtbaar is.
- Studiomodus wisselen
- Schakelt de studiomodus in of uit.
Triggers24
Een knop of actiestroom kan op deze gebeurtenissen reageren.
- Scène gewijzigd
- De programmascène (live) is gewijzigd. Optioneel alleen voor één scène.
- Voorbeeldscène gewijzigd
- De voorbeeldscène in de studiomodus is gewijzigd.
- Opname gestart
- OBS is begonnen met opnemen.
- Opname gestopt
- OBS is gestopt met opnemen.
- Opname gepauzeerd
- De opname is gepauzeerd.
- Opname hervat
- De opname is hervat.
- Opnamebestand gewijzigd
- De opname is gestart, naar een nieuw bestand gegaan of gestopt, met het bestandspad.
- Streaming gestart
- OBS is begonnen met streamen.
- Streaming gestopt
- OBS is gestopt met streamen.
- Replaybuffer gestart
- De replaybuffer is gestart.
- Replaybuffer gestopt
- De replaybuffer is gestopt.
- Replaybuffer opgeslagen
- Een replayclip is op schijf opgeslagen, met het bestandspad.
- Screenshot opgeslagen
- OBS heeft een screenshot op schijf opgeslagen, met het bestandspad.
- Virtuele camera gestart
- De virtuele camera is gestart.
- Virtuele camera gestopt
- De virtuele camera is gestopt.
- Studiomodus gewijzigd
- De studiomodus is in- of uitgeschakeld.
- Demping invoer gewijzigd
- Een audio-invoer is gedempt of niet meer gedempt. Optioneel alleen voor één invoer.
- Invoer werd actief
- Een invoer wordt nu in de programma-uitvoer weergegeven, bijvoorbeeld een webcam die live gaat.
- Invoer werd inactief
- Een invoer wordt niet meer in de programma-uitvoer weergegeven.
- Invoer wordt getoond
- Een invoer wordt nu in de programma- of voorbeelduitvoer weergegeven.
- Invoer wordt niet meer getoond
- Een invoer wordt niet meer in de programma- of voorbeelduitvoer weergegeven.
- Aangepaste gebeurtenis
- Een OBS-script of -plugin heeft een aangepaste gebeurtenis uitgezonden. Optioneel alleen voor één gebeurtenisnaam.
- Verbonden
- Macro Deck heeft verbinding gemaakt met OBS en OBS is klaar met laden.
- Niet verbonden
- De verbinding met OBS is verbroken.
Variabelen14
Toon deze waarden op knoppen en widgets, of gebruik ze in voorwaarden.
obs_<configuration>_is_connected- Of Macro Deck met deze OBS verbonden is.
obs_<configuration>_current_scene- De actieve programmascène.
obs_<configuration>_preview_scene- De voorbeeldscène in de studiomodus.
obs_<configuration>_current_profile- Het actieve profiel.
obs_<configuration>_current_scene_collection- De actieve scènecollectie.
obs_<configuration>_is_recording,obs_<configuration>_recording_paused,obs_<configuration>_recording_timecode- Of OBS opneemt of gepauzeerd is en hoe lang de opname al loopt.
obs_<configuration>_is_streaming,obs_<configuration>_streaming_timecode- Of OBS streamt en hoe lang al.
obs_<configuration>_virtual_camera_active,obs_<configuration>_replay_buffer_active,obs_<configuration>_studio_mode_active- Of de virtuele camera, de replaybuffer en de studiomodus aan staan.
obs_<configuration>_fps,obs_<configuration>_max_fps,obs_<configuration>_cpu_usage- Prestatiecijfers die OBS doorgeeft.
obs_<configuration>_streaming_bitrate,obs_<configuration>_recording_bitrate- De huidige bitrates van de uitvoer in kbps.
obs_<configuration>_dropped_frames,obs_<configuration>_dropped_frames_percent,obs_<configuration>_skipped_frames,obs_<configuration>_skipped_frames_percent- Verloren frames van de stream en door de encoder overgeslagen frames, als aantal en in procent.
obs_<configuration>_last_recording_file,obs_<configuration>_last_screenshot- Het pad van het laatste opnamebestand en de laatste screenshot.
obs_<input>_volume,obs_<input>_muteden meer- Per invoer die je kiest: volume in dB (beschrijfbaar, zodat een schuifregelaar het kan instellen), gedempt, actief, getoond, audiosporen (
obs_<input>_track_1tot_6), monitortype, synchronisatieverschuiving en de instellingen. De kiezer stelt deze namen voor, en je kunt ze wijzigen. obs_<scene>_<source>_visible,obs_<source>_<filter>_enabled- Of een bron in een scène zichtbaar is en of een filter is ingeschakeld. De kiezer stelt deze namen voor, en je kunt ze wijzigen.
Veelgestelde vragen
Werkt het als OBS op een andere computer draait?
Ja. Vul het IP-adres van de computer waarop OBS draait in als Host en laat de poort (standaard 4455) door in de firewall van die computer. Paden in acties zoals Opnamemap instellen of Invoerinstelling instellen zijn paden op de computer waarop OBS draait.
Kan ik meer dan één OBS bedienen?
Ja. Voeg met Configuratie toevoegen een configuratie per OBS-instantie toe. Elke configuratie heeft eigen variabelen, en elke actie heeft een veld Configuratie om de OBS te kiezen die ze bedient.
Wat gebeurt er als OBS wordt gesloten of de verbinding wegvalt?
Macro Deck blijft op de achtergrond proberen opnieuw te verbinden en maakt weer verbinding zodra OBS terug is. Tot die tijd mislukken acties met OBS is niet verbonden., en de triggers Niet verbonden en Verbonden worden geactiveerd, zodat een actiestroom kan reageren.
Waarom mislukt een actie?
De actie toont de reden, bijvoorbeeld dat een scène of bron niet meer bestaat, dat OBS nog een scènecollectie laadt of dat OBS niet opneemt (bij Opnamebestand splitsen en Opnamehoofdstuk maken). Als je iets in OBS hebt hernoemd, kies het dan opnieuw in de actie.
Waar wordt het WebSocket-wachtwoord opgeslagen?
Macro Deck slaat het wachtwoord versleuteld op de computer op waarop Macro Deck draait en gebruikt het alleen om verbinding te maken met OBS.
Meer in Streaming
Meld Studio
Meegeleverd met Macro DeckWissel scènes en zet ze klaar, bedien lagen, effecten en audiotracks, en ga live in Meld Studio.
Streamlabs Desktop
Meegeleverd met Macro DeckWissel van scène, bedien je stream, opname en audiobronnen in Streamlabs Desktop.
Streamer.bot
Meegeleverd met Macro DeckVoer Streamer.bot-acties uit, verstuur chatberichten en reageer op elke gebeurtenis die Streamer.bot meldt.
Twitch
Meegeleverd met Macro DeckToon je Twitch-chat en streamstatistieken, modereer, start polls en reclame, en reageer op follows, subs en raids.
YouTube
Meegeleverd met Macro DeckToon je YouTube-livechat en streamstatistieken, wijzig titel en tags, en reageer op Super Chats en leden.