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

# Camera Editor

> Connect a camera, create angles, control pan, tilt and zoom, and set up AI framing.

The Camera Editor is where you work on a single PTZ camera: its angles on the left, the live preview and manual controls in the middle, and the configuration of the selected angle on the right. Fixed cameras have no control page, they are configured entirely from their settings sheet.

## Add and connect a camera

Click **Add New Camera** on the [Cameras](/cameras) page and choose **PTZ Camera** or **Fixed Camera**. For a PTZ camera, pick your model from the list or choose a generic option. The camera settings sheet then covers everything the camera needs:

<Steps>
  <Step title="Name and model">
    Give the camera a name and confirm the model. The model determines which
    control protocol and features are available.
  </Step>

  <Step title="Connection">
    Enter the **Host** and **Port** of the camera on your studio network. Add
    a username and password if the camera requires authentication. The
    protocol, like VISCA over IP or the Panasonic HTTP interface, follows
    your model choice.
  </Step>

  <Step title="Stream source">
    Give the camera a video feed for previews: pick an **NDI source**, enter a
    **Stream URL**, or use the camera's native MJPEG stream on supported
    Panasonic models.
  </Step>

  <Step title="Triggers">
    Set the **PGM Trigger**, the command that puts this camera into program.
    Optionally override the studio **Fallback Commando** for this camera. It
    is triggered when switching to this camera while it is already on air.
  </Step>
</Steps>

The connection panel at the top of the settings sheet shows whether the camera is reachable, its uptime and any connection errors.

<Tip>
  Turn on **Cloud Live** to stream the camera to the cloud as a live feed, or
  leave **Thumbnail generation** on for periodic preview frames. The capture
  interval is configurable at **Settings → Studio → Cameras**.
</Tip>

## Work with angles

An angle is a saved shot: a camera position plus the command that plays when the angle is activated. Angles are what your automation targets. An [Audio Manager](/audio-manager) trigger, a [Macro](/macros) or a [Dashboard](/dashboards) button executes an angle, the camera moves there and goes on air.

* Click **New** in the angles list to add an angle.
* Double click an angle card, or use **Execute** in its context menu, to run it. The card shows **Busy** while the camera moves and **Current** when it is the active angle.
* Drag angle cards to reorder them.

Per angle you configure:

* **Position** - either a **Base preset**, one of the in-camera preset slots, or a **Custom** captured position. Use **Set from camera** to capture the current camera position.
* **Command** - plays when the angle is activated. By default the angle uses the camera's own command; turn on **Override** to give this angle a custom command.
* **AI framing** - per angle framing behavior, see below.
* A custom thumbnail, if you want something other than the captured preview.

When an angle is targeted by audio trigger rules, an **Audio Triggered by** row links straight to those triggers in the Audio Manager.

<Note>
  Saving changes while the camera is on air asks for confirmation first, and
  angle settings are locked while the camera is busy moving.
</Note>

## Manual control

The control pane gives you direct PTZ control:

* **Presets** - recall or store the in-camera preset slots, 1 to 99. Storing overwrites the slot with the current camera position.
* **Custom** - a joystick for pan and tilt, plus zoom and focus sliders, touch focus and auto focus.

Manual controls lock automatically while the camera is on air, unlock deliberately if you must, and while an angle is framing or a preset is being recalled. If Camera Assist is not running or the camera hardware is unreachable, the pane tells you exactly which of the two is the problem.

## AI framing

AI framing positions the camera to frame faces automatically. It needs two things before it can be enabled in the camera settings:

1. **Lens settings** - the wide and tele horizontal field of view and the pan and tilt range of your camera, in degrees. You find these in the camera manual.
2. **PTZ calibration** - a one-time automated run that measures the camera's pan, tilt and zoom units.

<Warning>
  Calibration moves the camera live. Make sure the shot is clear before
  starting.
</Warning>

Once enabled, you set the baseline: safe pan, tilt and zoom ranges, a **Framing standard** from close up to wide shot, **Prevent blocked frame** to avoid obstructed shots, and the **Alignment TTL**, how long a framing result stays valid.

Each angle can then refine this: its own framing standard, how many **Faces in shot** to target, fine **Pan, Tilt and Zoom nudges**, and **Prevent blocked frame** to keep the camera off air when no faces are detected. Everything an angle does not override is inherited from the camera.