Skip to main content

AV Sources

AV Sources represent audio and video content sources that can be routed to AV zones. Sources include cable boxes, Blu-ray players, streaming devices, audio servers, and any equipment that provides A/V content.

Overview​

The AV Sources page manages the library of available audio/video sources in your system. Sources can be assigned to specific AV zones or left unassigned to act as global sources available in all zones.

Viewing AV Sources​

The main grid displays all configured sources with the following columns:

  • Device - Physical source device
  • AV Zone - Zone this source is assigned to (blank for global sources)
  • AV Type - Source category (audio or video)
  • Label - Display name shown to users
  • On Macro - Macro executed when source is selected
  • Off Macro - Macro executed when source is deselected
  • Address - Matrix input number or routing identifier
  • Enabled - Whether source is available
  • Sort Index - Display order

Grid Actions​

  • Add - Create a new AV source
  • Edit - Modify an existing source
  • Delete - Remove a source
  • Sort - Reorder sources
  • Reload - Refresh the grid data

Creating an AV Source​

To create a new source:

  1. Click Add in the grid toolbar
  2. The AV Source Creator opens
  3. Configure the source (see sections below)
  4. Click Save

AV Source Creator​

Device​

Select the physical device this source represents from the dropdown. This links the source to a device for transport control (play, pause, stop, etc.).

Examples: Blu-ray player, Apple TV, cable box, audio streamer

AV Zone​

Select which AV zone this source belongs to:

  • Specific Zone: Source only appears in that zone
  • Global (checkbox): When checked, the source appears in all AV zones (unless hidden via Hidden Global Sources on the zone)

AV Type​

Select the source type:

  • audio - Audio-only source
  • video - Video source

Label​

User-friendly display name shown in source selectors.

Examples: "Apple TV", "Blu-ray", "Cable TV", "Sonos"

Component​

Select the UI component used to display this source's controls. Options are populated from available AV components in the system.

Common components: Standard source view, multiview, channel guide

On Macro​

Macro executed when this source is selected in a zone. Use this to send routing commands, switch inputs, or power on equipment.

Off Macro​

Macro executed when this source is deselected (another source is chosen or zone turns off).

Rerun Macros​

When enabled, the on/off macros run every time the source is selected, even if it's already the active source. When disabled, macros only run on source changes.

Channel Provider​

Link this source to a channel provider for TV channel integration. When set, the source shows a channel lineup for channel selection.

Icon​

Icon filename used in the UI source selector. Reference icons from the active theme.

Address​

Matrix input number or routing address for this source. Used for automatic matrix routing when source is selected in a zone.

Simple address: Enter the input number (e.g., 1, 2, 3)

Advanced addressing (checkbox): Same as AV Zone advanced addressing. When enabled, separate fields appear for:

  • Video Routing Address
  • Video Endpoint Address
  • Audio Routing Address
  • Audio Endpoint Address

Enabled​

Toggle to make the source available or unavailable.

Sort Index​

Display order in source lists.

Global vs. Zone-Specific Sources​

Global Sources​

Sources with no AV zone assigned (or Global checkbox checked):

  • Appear in all AV zones by default
  • Can be hidden per-zone using Hidden Global Sources (in AV Zone configuration)
  • Useful for sources shared across rooms (e.g., Sonos, streaming services)

Zone-Specific Sources​

Sources assigned to a specific AV zone:

  • Only appear in that zone
  • Not visible in other zones
  • Useful for sources physically connected to one room (e.g., local Blu-ray player)

Source Macros​

On Macro Use Cases​

When a source is selected, the on macro can:

  • Switch a matrix input to the zone's output
  • Power on the source device
  • Select an input on a receiver
  • Adjust volume to a default level

Off Macro Use Cases​

When a source is deselected, the off macro can:

  • Power off the source device
  • Mute or reduce volume
  • Release matrix routing

Auto-Generated Macros​

When creating AV zones, you can automatically generate on/off macros for each source (via the Create Source On/Off Macros checkboxes). These macros contain basic routing steps that you can customize later in Automation > Macros.

Troubleshooting​

Source Not Routing​

Check:

  1. Address: Source has correct matrix input address
  2. Zone Address: Zone has correct matrix output address
  3. Matrix Online: Matrix device is connected
  4. On Macro: Source on macro has correct routing steps

Source Not Appearing​

Check:

  1. Enabled: Source is enabled
  2. Zone Assignment: Source is assigned to the correct zone (or is global)
  3. Hidden: Source is not in the zone's Hidden Global Sources list
  4. Local Sources Only: Zone may have Local Sources Only enabled

Source Not Controlling Device​

Check:

  1. Device Assigned: Source has a device linked
  2. Device Online: Device is connected
  3. Command Set: Device has command set configured for transport controls
  • AV Zones - Assigning sources to zones
  • Channels - TV channel lineups and providers
  • Devices - Configuring source devices
  • Macros - Source selection automation