Meld Studio

The Meld Studio integration connects Macro Deck to Meld Studio through its WebSocket (WebChannel) API. Your buttons switch scenes, change what is visible on screen, control audio and start your stream, and Meld Studio reports every change back, so the deck shows the current state.

What you can do

• Show a scene live, stage a scene without showing it, and show the staged scene when you are ready.
• Show, hide or toggle a layer, and enable, disable or toggle an effect.
• Mute or unmute an audio track, turn its monitoring on or off, set its volume or raise and lower it by a step.
• Start, stop or toggle streaming and recording, and take a screenshot of the program output in horizontal or vertical orientation.
• Read the state of a layer, an effect or a track into a variable for use in conditions.

Some example setups:

• A BRB button that shows your BRB scene and mutes your microphone track.
• A Go live button that toggles streaming and shows whether you are live.
• A slider bound to meld_<track>_gain of your music track, so moving the slider changes the track volume in Meld Studio.
• A flow that runs on Scene Changed and turns off a camera effect whenever you leave your main scene.

How it behaves

Meld Studio pushes its changes to Macro Deck, so variables such as meld_current_scene, meld_staged_scene, meld_is_streaming and meld_is_recording follow Meld Studio within a moment. The variable picker also lists every audio track of the session with its gain, mute and monitoring state. The gain variable, meld_<track>_gain, can be written, so a slider can control it.

The integration has a single configuration. By default it connects to Meld Studio on the same computer. You can enter another host under Advanced configuration in the setup, but Meld Studio's API has no password and no encryption, so Macro Deck asks you to confirm the risk first. When Meld Studio closes, Macro Deck keeps trying to reconnect, and the Connected and Disconnected triggers let a flow react.