Creating Macros in the Control Room
Overview
A Macro is a saved list of steps that runs in order with a single selection or keystroke in a Control Room. Simple Macros handle one or two actions, like starting a recording and captions together. Advanced Macros chain many steps — overrides, routing switches, recording, captioning, streaming, and post-event cleanup — so an operator can run an entire meeting with just a few selections.
This article covers how to build a Macro, what each step type does, and how to build advanced Macros that adapt to whichever event is loaded in the Control Room.
How to Create a control Room Macro
Creating a control Room
Creating a Macro
Macros belong to a Control Room. Before you begin, make sure the Control Room already includes the devices and outputs your Macro will control.
Go to Settings → Location Settings → Autopilot → Control Rooms.
Select Edit next to the Control Room you want to add a Macro to.
Select the Macros tab.
Select Add Macro.
Enter a Name for the Macro, such as "Start Meeting."
Optionally, enter a Hotkey (single letter) to use as a keyboard shortcut for this Macro. If you leave it blank, Cablecast assigns a number based on the Macro's position in the Control Room — 1 for the first Macro, 2 for the second, and so on.
Select Add Step to add the first step.
Select the pencil (edit) icon next to the new step to open Edit Step.
Enter a Name for the step and choose its Type. Additional fields appear depending on the type you choose. Step types are described in Step Types below.
Select Done to save the step.
Repeat steps 7–10 for each step in the Macro.
Select Done to close the Macro, then select Save to save the Control Room.



Note: Your Macro isn't saved until you select Save on the Edit Control Room screen. Selecting Cancel discards any changes you made to the Control Room and its Macros.
Managing Steps
Steps run from top to bottom. Use the controls on each step row to manage them:
Control | Description |
|---|---|
Up and down arrows | Move the step earlier or later in the Macro. |
Pencil (edit) icon | Open Edit Step to change the step's name, type, or settings. |
Trash (delete) icon | Remove the step from the Macro. |
The same controls appear on the Macros tab. There, the arrows set the order Macros appear in the Actions menu and the keyboard shortcut list.
Step Types
Each step has a Name, a Type, and any settings that type requires.
Step Type | What It Does | Settings |
|---|---|---|
Begin Automation Override | Stops Autopilot from controlling the selected outputs and devices, so the schedule doesn't interrupt your live event. | Override Source |
Device Action | Sends a command to a device, such as Record, Play CG, or Start Transcribing. | Device Source, Device, Action, plus action-specific fields |
Enable VOD | Enables Video on Demand for the loaded event's Show Record. | None |
End Automation Override | Returns the selected outputs and devices to Autopilot control. | Override Source |
Mark Event End | Records the time the event actually ended. | None |
Mark Event Start | Records the time the event actually started. | None |
Queue Autopilot Send | Queues an Autopilot send using your location's default Autopilot settings. This forces out whatever should be happening on the schedule right now. It doesn't add or remove runs. | None |
Set Format | Changes the format of the loaded event's Show Record — for example, from Live to Video Server so it's ready to replay. | Format |
Set Total Run Time | Sets the Show Record's run time using the times recorded by Mark Event Start and Mark Event End. | None |
Switch | Routes a device (router input) to an output (router output). Only needed if your system includes a video router. | Device Source, Device, Output Source, Output |
Wait | Pauses the Macro before running the next step. | Duration (ms) |
Steps That Require a Scheduled Event
Some steps act on the event loaded in the Control Room, so they only work when a scheduled event is selected from the event menu at the top of the Control Room:
Device Action and Switch steps with Device Source set to Event Encode Device or Event Playout Device
Begin Automation Override and End Automation Override steps with Override Source set to Event
Switch steps with Output Source set to Channel Output
Mark Event Start and Mark Event End
Set Format
Set Total Run Time
Enable VOD
If your live events aren't on the schedule, build your Macros with Specific Device and Specific Output instead, and leave out the event-only steps.
Device Actions
The actions available in a Device Action step depend on the device you choose. Common actions for encoders (such as VIO Encode devices), network encoders, video server playback devices, and live stream devices include:
Device | Action | Additional Settings |
|---|---|---|
Encoder | Record | File Name |
Encoder | Pause | None |
Encoder | Stop / Stop Recording | None |
Encoder | Start Transcribing | Source Language |
Encoder | Stop Transcribing | None |
Encoder | Start Passthrough | Output — the server output to pass video through to |
Network encoder | Record | IP Stream, File Name |
Video server playback device | Play | File Key |
Video server playback device | Play CG | None |
Video server playback device | Play Stream | IP Stream |
Video server playback device | Start Passthrough | Input — the encoder to pass through |
Video server playback device | Stop | None |
Live stream device | Start RTMP Output | Network Stream Destination |
Live stream device | Stop RTMP Output | Output (for example, Stop All Outputs) |
RTMP output comes from whichever server generates your channel's live stream. If you have a standalone live streaming server, choose that device. On an all-in-one server, such as a VIO Omni, the live stream is generated on the video server, so choose the video server.
Tip: Leave File Name blank in Record steps. A Macro uses the same file name every time it runs, so a fixed name overwrites the previous recording. When it's blank, Cablecast names each recording with the unnamed record format and a date and time stamp, so every file name is unique. You can rename the file after the recording is complete.
Note: Stop and Stop Recording both stop a recording on a Cablecast encoder. Some third-party recorders, such as Blackmagic HyperDecks, require Stop Recording.
Tip: Not sure which action you need? Select the Action button next to a device in the Control Room. Any action listed there can also be used in a Macro step.
Building Advanced Macros
Choosing Specific or Event-Based Sources
Several step types ask which device or output to act on. You can pick one directly, or let Cablecast choose based on the event loaded in the Control Room.
Device Source (used by Device Action and Switch steps):
Option | Uses |
|---|---|
Specific Device | The device you choose in the Device field. |
Event Encode Device | The encoder assigned to the loaded event. |
Event Playout Device | The playback or live source device assigned to the loaded event. |
Override Source (used by Begin Automation Override and End Automation Override steps):
Option | Overrides |
|---|---|
Specific Output | The output you choose in the Output field. |
Event | The outputs and devices used by the loaded event. |
All Outputs and Devices | Every output and device in the Control Room. |
Output Source (used by Switch steps):
Option | Uses |
|---|---|
Specific Output | The output you choose in the Output field. |
Channel Output | The channel output for the loaded event. |
Use Specific options when a Macro always controls the same equipment — for example, a Control Room built for a single council chamber. Use Event options when one Macro needs to work for any meeting, on any channel. An event-based Macro only needs to be built once, but it only works when an event is selected in the Control Room.
Warning: If a Macro uses an event-based source and no event is loaded, that step fails because Cablecast has no event to pull the device or output from. See Steps That Require a Scheduled Event above.
Adding Delays with Wait Steps
Some devices need a moment to finish one command before they're ready for the next. Add a Wait step between them to give the device time to respond.
Duration (ms) is in milliseconds: 1000 is one second, and 5000 is five seconds.
Common places to add a Wait step:
After a Switch, before starting a recording, so the encoder records the new source from the first frame.
After Begin Automation Override, before sending device commands.
After Stop Recording, before Set Total Run Time, so the recorded file has a moment to finish processing.
Example: Starting an Unscheduled Meeting
Use this pattern when a meeting isn't on the schedule, and the operator needs to put it on air by hand. Because there's no event to pull devices from, every step uses Specific Device or Specific Output.
Step | Type | Settings | Purpose |
|---|---|---|---|
1 | Begin Automation Override | Override Source: Specific Output, Output: your channel output | Keeps the schedule from taking over the channel. |
2 | Switch | Device: your live source, Output: your encoder output | Routes the live feed to the encoder. Only needed if you have a video router — skip it if your source is wired directly to the encoder. |
3 | Wait | Duration (ms): 2000 | Gives the router time to complete the switch. Skip it if you skipped step 2. |
4 | Device Action | Device: your encoder, Action: Record, File Name: leave blank | Starts recording. |
5 | Device Action | Device: your encoder, Action: Start Transcribing, Source Language: English | Starts live captions. |
6 | Device Action | Device: your video server, Action: Start Passthrough, Input: your encoder | Sends the live feed to air through the video server. |
Example: Starting a Scheduled Meeting
Use this pattern when the meeting is already on the schedule. Load the event in the Control Room first, and the Macro pulls its devices and outputs from that event.
Step | Type | Settings | Purpose |
|---|---|---|---|
1 | Begin Automation Override | Override Source: Event | Prevents automation from interrupting the meeting if it runs long. |
2 | Switch | Device Source: Event Playout Device, Output Source: Channel Output | Puts the event's live source on the channel. Only needed if you have a video router. |
3 | Device Action | Device Source: Event Encode Device, Action: Record | Starts recording on the event's encoder. |
4 | Device Action | Device Source: Event Encode Device, Action: Start Transcribing | Starts live captions. |
5 | Mark Event Start | None | Records when the meeting actually started. |
Example: Pausing and Resuming a Meeting
A pair of short Macros lets operators handle recesses and executive sessions without stopping the recording entirely.
Pause Meeting
Step | Type | Settings |
|---|---|---|
1 | Device Action | Device: your encoder, Action: Pause |
2 | Device Action | Device: your encoder, Action: Stop Transcribing |
Resume Meeting
Step | Type | Settings |
|---|---|---|
1 | Device Action | Device: your encoder, Action: Record |
2 | Device Action | Device: your encoder, Action: Start Transcribing, Source Language: English |
Note: Running Record on a paused encoder resumes the paused recording.
Tip: Add a Play CG step to Pause Meeting to put the channel on Cablecast CG during the break, and a Start Passthrough step to Resume Meeting to bring the live feed back. Play CG only switches the channel to Cablecast CG. To show a message like "We'll be right back," create an alert bulletin with that text in Cablecast CG and put it up before or during the break.
Example: Ending a Meeting and Preparing the Replay
This Macro wraps up a scheduled meeting and gets the recording ready to air again — all in one step. Load the event in the Control Room before running it.
Step | Type | Settings | Purpose |
|---|---|---|---|
1 | Mark Event End | None | Records when the meeting actually ended. |
2 | Device Action | Device Source: Event Encode Device, Action: Stop Recording | Stops the recording. |
3 | Device Action | Device Source: Event Encode Device, Action: Stop Transcribing | Stops live captions. |
4 | Device Action | Device: your video server, Action: Play CG | Puts the channel on the bulletin board. |
5 | Set Format | Format: Video Server | Changes the Show Record from live to a playable file format. |
6 | Set Total Run Time | None | Sets the run time from the marked start and end times. |
7 | Enable VOD | None | Makes the recording available on demand. |
8 | End Automation Override | Override Source: Event | Returns the channel to Autopilot control. |
9 | Queue Autopilot Send | None | Forces out whatever should be happening on the schedule right now, including any router switches. |
Note: Keep End Automation Override before Queue Autopilot Send. While the override is active, an Autopilot send can't make router switches or control the overridden devices, so the send has no effect on the channel.
Example: Streaming to Social Media
If you've set up a network stream destination for YouTube, Facebook, or another RTMP service, a Macro can start and stop it alongside the rest of your meeting. See Getting Started with Social Streaming for requirements and setup.
Macro | Type | Settings |
|---|---|---|
Start Stream | Device Action | Device: your live stream device, Action: Start RTMP Output, Network Stream Destination: your stream |
Stop Stream | Device Action | Device: your live stream device, Action: Stop RTMP Output, Output: Stop All Outputs |
Add these as steps in your Start and End Macros, or keep them as separate Macros so the operator can control the stream on its own.
Running Macros
To run a Macro:
Open Control Rooms from the left-hand menu.
Select Change Control Room and choose the Control Room that contains your Macro.
If the Macro uses event-based sources, select the event from the event menu at the top of the screen.
Select Actions, then select the Macro.

Running Macros with Keyboard Shortcuts
Press A in a Control Room to open Macros: Keyboard Shortcuts. The list shows each Macro and its key. Press the key to run that Macro. Macros without a hotkey use their position in the list instead — press 1 for the first Macro, 2 for the second, and so on.

Tip: If you assign hotkeys, give each Macro in a Control Room its own letter. If two Macros share the same letter, operators can't tell from the list which one the key will run.
Macros can also be run from a Stream Deck or the Bitfocus Companion app. See BitFocus Companion & Cablecast for setup steps.
Tips for Reliable Macros
Test before you go live. Run each new Macro on a test event and watch every device respond before using it in a real meeting.
Name every step. Use descriptive step names, like "Start Captions" instead of "Step 4," to make Macros easier to troubleshoot later.
Start with the override. Put Begin Automation Override first in any Macro that starts a live event, so the schedule can't interrupt the steps that follow.
Build a separate Macro for each phase. Start, Pause, Resume, and End need to be separate Macros. Every step in a Macro runs each time it's triggered, so a combined Macro would start and end the event at the same time.
Summary
Macros turn multi-step live event workflows into a single selection or keystroke. Build them from the Macros tab of a Control Room, choose specific or event-based sources depending on whether the Macro serves one setup or many events, and use Wait steps where devices need time to respond. With Start, Pause, Resume, and End Macros in place, an operator can run an entire meeting — including recording, captions, and replay setup — in just a few steps.
If you have any questions, contact support@cablecast.tv.
