Skip to content

Meld Studio sub-actions

Get current scene

Finds out which scene Meld Studio is showing and keeps it for later steps.

Variables it adds

Variable What it holds
%currentScene% The name of the live scene
%currentSceneId% Meld's id for the live scene

Type id: meldstudio.getCurrentScene

Get scenes

Reads the names of all your Meld scenes and keeps them for later steps.

Variables it adds

Variable What it holds
%meldStudio.scenes% The list of scene names, as text
%meldStudio.sceneCount% How many scenes there are

Type id: meldstudio.getScenes

Get status

Checks whether Meld Studio is connected, recording or streaming and keeps the answers for later steps.

Variables it adds

Variable What it holds
%meldStudio.isConnected% True if Cuebot is connected to Meld
%meldStudio.isRecording% True if Meld is recording
%meldStudio.isStreaming% True if Meld is streaming

Type id: meldstudio.getStatus

Media layer control

Plays, pauses or jumps within a video or sound layer in Meld Studio.

Setting What to put in
Scene The scene the layer is in, as Meld shows it. Leave empty to look in the live scene first, then in all scenes.
Layer The media layer name as Meld shows it.
Action Play, Pause, or Seek to jump to a time. Options: Play, Pause, Seek. Starts as: Play.
Seek to (seconds) Only for Seek: the time to jump to, in seconds from the start. Starts as: 0.

Type id: meldstudio.mediaControl

Record clip

Saves a short clip of the last moments in Meld Studio.

Setting What to put in
Length (seconds, 0-90) How many seconds to save, 1 to 90. Leave empty or 0 for the longest Meld can do.

Type id: meldstudio.recordClip

Recording

Starts or stops recording in Meld Studio.

Setting What to put in
State Start begins recording, Stop ends it, Toggle does the opposite of what it is doing now. Options: Start, Stop, Toggle. Starts as: Toggle.

Variables it adds

Variable What it holds
%meldStudio.isRecording% True if Meld is recording afterwards

Type id: meldstudio.recording

Replay

Shows or hides the instant replay in Meld Studio.

Setting What to put in
Action Show plays the replay, Dismiss closes it. Options: Show, Dismiss. Starts as: Show.

Type id: meldstudio.replay

Send Meld command (advanced)

Sends Meld Studio one of its own commands by name. For advanced users.

Setting What to put in
Command The command name, like "meld.screenshot" or "meld.recordClip". Pick one from the suggestions.

Type id: meldstudio.sendCommand

Set browser layer URL

Makes a browser layer in Meld open a different web page.

Setting What to put in
Scene The scene the layer is in, as Meld shows it. Leave empty to look in the live scene first, then in all scenes.
Layer The browser layer name as Meld shows it. Its id also works.
URL The web address to open, like "https://example.com/alert".

Type id: meldstudio.setBrowserLayerUrl

Set effect enabled state

Turns an effect on a Meld layer on or off.

Setting What to put in
Scene The scene the layer is in, as Meld shows it. Leave empty to look in the live scene first, then in all scenes.
Layer The layer name as Meld shows it, like "Webcam" (a layer is one item inside a scene). Its id also works.
Effect The effect name as Meld shows it. Its id also works.
State Enabled turns it on, Disabled turns it off, Toggle flips it. Options: Enabled, Disabled, Toggle. Starts as: Toggle.

Variables it adds

Variable What it holds
%meldStudio.effectEnabled% True if the effect is on afterwards

Type id: meldstudio.setEffectState

Set image/media layer source

Swaps the picture or video shown by an image or media layer.

Setting What to put in
Scene The scene the layer is in, as Meld shows it. Leave empty to look in the live scene first, then in all scenes.
Layer The image or media layer name as Meld shows it.
File The file on your computer, like "C:\Pictures\happy.png", or a web link starting with file://.

Type id: meldstudio.setLayerSource

Set item property

Changes one setting of a Meld scene, layer, effect or track. For advanced users who know the setting names.

Setting What to put in
Item The scene, layer, effect or track name as Meld shows it. Its id also works.
Property Which setting to change, like visible, x, y, width, height, url or name.
Value The new value, like true, 10 or some text.

Type id: meldstudio.setProperty

Set layer track muted state

Mutes or unmutes the sound of one layer, like a game capture.

Setting What to put in
Scene The scene the layer is in, as Meld shows it. Leave empty to look in the live scene first, then in all scenes.
Layer The layer name as Meld shows it, like "Webcam" (a layer is one item inside a scene). Its id also works.
State Muted silences it, Not Muted turns it back on, Toggle flips it. Options: Muted, Not Muted, Toggle. Starts as: Toggle.

Variables it adds

Variable What it holds
%meldStudio.trackMuted% True if the sound is muted afterwards

Type id: meldstudio.setLayerTrackMuted

Set layer visibility state

Shows or hides a layer (like a camera or image) in a Meld scene.

Setting What to put in
Scene The scene the layer is in, as Meld shows it. Leave empty to look in the live scene first, then in all scenes.
Layer The layer name as Meld shows it, like "Webcam" (a layer is one item inside a scene). Its id also works.
State Visible shows it, Hidden hides it, Toggle flips it. Options: Visible, Hidden, Toggle. Starts as: Toggle.

Variables it adds

Variable What it holds
%meldStudio.layerVisible% True if the layer is shown afterwards

Type id: meldstudio.setLayerVisibility

Set track gain

Sets the volume of an audio track.

Setting What to put in
Track The audio track: a global track name like "Microphone", or a layer name for that layer's sound. Its id also works.
Gain (0-1) The volume from 0 (silent) to 1 (full), like 0.5 for half. Starts as: 1.

Type id: meldstudio.setTrackGain

Set track monitoring state

Turns on or off listening to an audio track through your headphones (monitoring).

Setting What to put in
Track The audio track: a global track name like "Microphone", or a layer name for that layer's sound. Its id also works.
State Monitoring starts listening, Not Monitoring stops, Toggle flips it. Options: Monitoring, Not Monitoring, Toggle. Starts as: Toggle.

Variables it adds

Variable What it holds
%meldStudio.trackMonitoring% True if monitoring is on afterwards

Type id: meldstudio.setTrackMonitoring

Set track muted state

Mutes or unmutes an audio track, like your microphone.

Setting What to put in
Track The audio track: a global track name like "Microphone", or a layer name for that layer's sound. Its id also works.
State Muted silences it, Not Muted turns it back on, Toggle flips it. Options: Muted, Not Muted, Toggle. Starts as: Toggle.

Variables it adds

Variable What it holds
%meldStudio.trackMuted% True if the track is muted afterwards

Type id: meldstudio.setTrackMuted

Show scene

Switches Meld Studio to another scene, live.

Setting What to put in
Scene The scene name as Meld Studio shows it, like "Just Chatting". Its id also works.

Variables it adds

Variable What it holds
%meldStudio.sceneName% The scene that was shown

Type id: meldstudio.showScene

Show staged scene

Shows the scene you staged earlier in Meld Studio.

Type id: meldstudio.showStagedScene

Stage scene

Puts a scene in the "up next" spot in Meld, so you can show it later with "Show staged scene". Vertical scenes cannot be staged.

Setting What to put in
Scene The scene name as Meld Studio shows it, like "Just Chatting". Its id also works.

Type id: meldstudio.stageScene

Streaming

Starts or stops your stream in Meld Studio.

Setting What to put in
State Start begins streaming, Stop ends it, Toggle does the opposite of what it is doing now. Options: Start, Stop, Toggle. Starts as: Toggle.

Variables it adds

Variable What it holds
%meldStudio.isStreaming% True if Meld is streaming afterwards

Type id: meldstudio.streaming

Take screenshot

Takes a screenshot in Meld Studio. Meld saves the picture itself.

Setting What to put in
Orientation Horizontal is the normal wide picture, Vertical is the tall (phone) one. Options: Horizontal, Vertical. Starts as: Horizontal.

Variables it adds

Variable What it holds
%screenshotSuccess% True if Meld took the screenshot

Type id: meldstudio.takeScreenshot

Take vertical screenshot

Takes a tall (phone-shaped) screenshot in Meld Studio.

Variables it adds

Variable What it holds
%screenshotSuccess% True if Meld took the screenshot

Type id: meldstudio.takeVerticalScreenshot

Toggle virtual camera

Turns the Meld Studio virtual camera on if it is off, and off if it is on.

Type id: meldstudio.toggleVirtualCamera

Widget event

Presses a button on a Meld widget, like firing confetti, resetting a countdown or adding time to a subathon timer.

Setting What to put in
Event The widget event name, like "CONFETTIPOP_TRIGGER" or "COUNTDOWN_RESET". Pick one from the suggestions. Starts as: CONFETTIPOP_TRIGGER.
Amount (seconds) Only for SUBATHONTIMER_ADDTIME: how many seconds to add.

Type id: meldstudio.widgetEvent