> ## Documentation Index
> Fetch the complete documentation index at: https://docs.visualradioassist.live/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Use the names from the glossary at https://docs.visualradioassist.live/glossary: Audio Manager (two words), command (never commando), on air and off air (never live) for programs and studios, and server apps for the VRA apps installed in the studio.
> Say which app an answer applies to, like VRA Cloud, the Core or the Output Player, and the version when the page names one.
> Only give settings, values and steps that are in these docs. Never invent one. If the docs don't cover it, say so.
> When the docs don't answer the question, send the user to Visual Radio Assist support at https://cloud.visualradioassist.live/support.

# Commands

> Pick the command that audio triggers, macros, automations and camera angles run: switch an input, go to a camera angle, run a macro or change a studio state.

A command is one action that Visual Radio Assist executes in your studio, like switching a video switcher input or putting a camera angle on air. You don't run a command on its own. An [audio trigger](https://docs.visualradioassist.live/audio-manager/audio-triggers.md), a [macro](https://docs.visualradioassist.live/macros.md), an [automation](https://docs.visualradioassist.live/automations.md) or a camera angle runs it for you.

## How commands work

1. Open the thing that should act, like an audio trigger or an automation.
2. Add a command and pick its type: **Switcher**, **Camera angle**, **Macro** or **Internal**.
3. Fill in the fields of that type, like the switcher, the action and the input.
4. Save. When the trigger fires or the condition is met, Core executes the command in the studio.

![Command picker with a Switcher command: switcher, action, overlay and input](https://mintcdn.com/visualradioassist/a6mIwrBIsk16oUUx/images/commands/1.png?fit=max\&auto=format\&n=a6mIwrBIsk16oUUx\&q=85\&s=59143a1737971db24ece7aaf0d446fe1)

## Where you add commands

Every place that runs a command uses the same command picker:

* **Audio triggers** - Commands run when the audio goes above the threshold, **Release Commands** when it drops back. See [Audio Triggers](https://docs.visualradioassist.live/audio-manager/audio-triggers.md).
* **Audio Manager fallback** - Fallback commands run when every human speaker trigger is inactive. See [Fallback scenarios](https://docs.visualradioassist.live/audio-manager/fallback-scenarios.md).
* **Macros** - Each macro item runs one command. See [Macros](https://docs.visualradioassist.live/macros.md).
* **Automations** - The **Activate command** runs when the condition becomes active, the **Release command** when it becomes inactive. See [Automations](https://docs.visualradioassist.live/automations.md).
* **Camera angles** - The **Core command** puts the angle on air. A virtual angle also has a **Pre-command** that moves the camera into position first. See [Camera Editor](https://docs.visualradioassist.live/cameras/camera-editor.md).

The **Commands** section in the sidebar holds the things that run commands: **Camera angles**, **Macros**, **Automations** and **GPIO**.

## Command types

The command type decides what Visual Radio Assist does and which fields you fill in.

| Type | What it does | Fields |
| - | - | - |
| **Switcher** | Sends an action to a connected video switcher. | **Switcher**, **Action**, and an input, overlay, layer or macro depending on the action |
| **Camera angle** | Moves a camera to a saved angle and puts it on air. | The angle, from **Cameras** or **Legacy** |
| **Macro** | Runs one of your macros, with all its items. | **Macro** |
| **Internal** | Changes a state inside Visual Radio Assist. | **Type** and **Action** |

### Switcher actions

A **Switcher** command runs one action on the switcher you select.

| Action | What it does |
| - | - |
| **Set program input** | Cuts the input to program. |
| **Set preview input** | Puts the input in preview. |
| **Go / cut** | Takes preview to program. |
| **Toggle overlay**, **Overlay in**, **Overlay out** | Shows or hides an overlay or keyer, with an optional input. |
| **Input layer in**, **Input layer out** | Adds or removes an input on a layer. |
| **Switcher macro** | Runs a macro stored on the switcher itself, not a Visual Radio Assist macro. |
| **Other** | Runs a switcher specific action, like start recording or start streaming on vMix. |

The actions and fields depend on the switcher. A switcher with more than one output or M/E shows an **Output** or **M/E** field.

### Camera angle commands

![Command picker with the Camera angle type and three PTZ cameras](https://mintcdn.com/visualradioassist/a6mIwrBIsk16oUUx/images/commands/2.png?fit=max\&auto=format\&n=a6mIwrBIsk16oUUx\&q=85\&s=86c0e6387d59a79dfcaf484cbf6a18a6)

A **Camera angle** command needs the Camera Assist app running on the studio machine. Without it the picker shows **Camera Assist app not running** and the command can't be executed. A studio with both camera setups shows a **Cameras** tab for [Cameras](https://docs.visualradioassist.live/cameras.md) and a **Legacy** tab for the older camera angles.

### Internal commands

An **Internal** command changes the state of Visual Radio Assist itself instead of studio hardware.

![Command picker with an Internal command that sets the studio state](https://mintcdn.com/visualradioassist/a6mIwrBIsk16oUUx/images/commands/3.png?fit=max\&auto=format\&n=a6mIwrBIsk16oUUx\&q=85\&s=4f09739c58ee4e0768595946f9a8326a)

| Type | Actions |
| - | - |
| **Core state** | **Set to active**, **Set to deactivated**, **Set to available**, **Set to on air**, **Toggle** |
| **Studio state** | **Set to on air**, **Set to off air**, **Set to recording**, **Toggle**. **Set to recording** only shows when the studio can record. |
| **Switcher controller** | **Set active M/E**, for a switcher with more than one M/E |
| **Audio Manager** | **Trigger fallback**, **Override active human and trigger fallback** |
| **No action** | Does nothing. Use it as a placeholder, like a release that leaves the shot as it is. |

## Force a command while off air

**Force command execution** runs the command even when the studio is off air or Core is deactivated. Without it, Visual Radio Assist skips the command in those states, so nothing switches while you are off air. Turn it on for a command that must always run, like a command that sets the studio on air.

## Limitations

* The command picker does not create HTTP actions or PTZ preset commands. A command of a type the picker can't show reads **This command can't be edited here**.
* The **Macro** type only shows when your license includes macros.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.