Crestron, AirMedia 3

Description

Crestron AirMedia 3 monitoring plugin for Q-SYS.

The plugin connects to a Crestron AirMedia 3 device over HTTP.

It is intended for integrators who need a simple way to monitor connection state, presentation activity, user count, and core device information such as model, firmware, serial number, and MAC address.

Release note

2026-04: V1.0.0.1

Added Login Code controls.

2026-04: V1.0.0.0

Initial Release

Properties

License

Type: String
Default value: Empty
Description: License key activated for the main core.

Licenses are issued on a "per core" basis, as in each core needs its own license to run as many instances of the plugin as needed on this particular core and licenses are not transferable from core to core.

License keys can be added while in Offline mode, in the Properties pane on the right. To purchase licenses, go to https://ad-da.ca.

The plugin can be emulated for free, allowing you to prepare everything without requiring you to have access to a core.

License Backup

Type: String
Default value: Empty
Description: License key activated for the backup core.

If your main Q-SYS Core fails, the backup Core automatically takes over without needing a license to function as a temporary replacement. However, if the design boots from the backup Core, a valid license is required. Additionally, if the backup Core is restarted (due to power loss or other reasons), the plugin instances cannot initialize without a valid license.

Debug Print

Type: enum
Choices: None / Tx/Rx / Tx / Rx / Function Calls / All / Debug
Default Value: None
Description: Controls plugin debug output level.

Controls

Controls Page

Status

Controls name: Status
Type: Indicator-Status
Description: Displays plugin health and connection state.

OK - Connected

FAULT - Timeout, authentication error, or disconnected

Setup

IP Address

Controls name: IPAddress
Type: Text-Text Edit
Description: Target AirMedia 3 IP address or host name.

Username

Controls name: Username
Type: Text-Text Edit
Description: Login username used for authentication.

Password

Controls name: Password
Type: Text-Text Edit
Description: Login password used for authentication. Value is obfuscated in runtime and stored in secret storage.

Device Information

Device Name

Controls name: DeviceName
Type: Indicator-Text
Description: AirMedia host name reported by the device.

Device Model

Controls name: DeviceModel
Type: Indicator-Text
Description: Model value reported by the device.

Device Firmware

Controls name: DeviceFirmware
Type: Indicator-Text
Description: Firmware version reported by the device.

Serial Number

Controls name: SerialNumber
Type: Indicator-Text
Description: Serial number reported by the device.

MAC Address

Controls name: MACAddress
Type: Indicator-Text
Description: MAC address reported by the device.

AirMedia Status

State

Controls name: AirMediaStatus
Type: Indicator-Text
Description: Current AirMedia session state (example: Idle, Active or Presenting).

User Count

Controls name: TotalUsers
Type: Indicator-Text
Description: Number of active AirMedia users.

Connected

Controls name: IsConnected
Type: Indicator-Led
Description: On when state is Active or Presenting.

Presenting

Controls name: IsPresenting
Type: Indicator-Led
Description: On when state is Presenting.

Login Code

Controls name: ActiveLoginCode
Type: Indicator-Text
Description: Current Login Code (either 4 or 8 digits).