Skip to main content

Creating Macros in the Control Room

Last Updated:November 10, 2026
Applies to: Cablecast 7.10

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.

  1. Go to Settings → Location Settings → Autopilot → Control Rooms.

  2. Select Edit next to the Control Room you want to add a Macro to.

  3. Select the Macros tab.

  4. Select Add Macro.

  5. Enter a Name for the Macro, such as "Start Meeting."

  6. 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.

  7. Select Add Step to add the first step.

  8. Select the pencil (edit) icon next to the new step to open Edit Step.

  9. 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.

  10. Select Done to save the step.

  11. Repeat steps 7–10 for each step in the Macro.

  12. Select Done to close the Macro, then select Save to save the Control Room.

The Macros tab of the Edit Control Room screen, listing a Control Room's Macros with up and down arrows, an edit icon, and a delete icon on each row, and an Add Macro button above the list.
The Edit Macro dialog for a Macro named End Meeting/Captions, with Name and Hotkey (single letter) fields, an Add Step button, and three Device Action steps: Play CG, Stop Recording, and Stop Transcribing.
The Edit Step dialog for a Device Action step named Stop Recording, with Device Source set to Specific Device, Device set to VIO SDI Encode, and Action set to Stop Recording.

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:

  1. Open Control Rooms from the left-hand menu.

  2. Select Change Control Room and choose the Control Room that contains your Macro.

  3. If the Macro uses event-based sources, select the event from the event menu at the top of the screen.

  4. Select Actions, then select the Macro.

A Control Room with the Actions menu open, listing Force Event followed by each of the room's Macros.

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.

The Macros: Keyboard Shortcuts list, showing each Macro with its key. Macros with a custom hotkey show a letter, and the rest show a number.

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.

Did you find this article helpful?