Devices and Drivers

How to add AV equipment to your project, test connectivity, and manage drivers.

See Getting Started if you haven’t installed OpenAVC yet.

Adding a Device

Use the search box at the top of the device list to filter by name, ID, or driver.

Click Devices in the sidebar
Click Add Device
Select a driver from the dropdown (e.g., “PJLink Class 1 Projector”)
Enter a Device ID (e.g., projector_main). This is the name used in macros and scripts, so keep it short and descriptive.
Enter a display name (e.g., “Main Projector”). This is what appears in the UI.
Configure connection settings (host, port, etc.). Defaults are pre-filled from the driver.
Click Add

The Device ID is permanent and referenced everywhere. Choose a convention and stick with it. Common patterns:

Convention	Example
`type_location`	`projector_main`, `display_lobby`
`type_number`	`projector_1`, `switcher_1`
`room_type`	`br201_projector`, `br201_switcher`

Testing Commands

After adding a device, click it in the device list to open the detail panel:

Connection status: green dot = connected, red dot = disconnected
Live state: real-time values for all state variables (power, input, etc.)
Command testing: select a command from the dropdown, fill any parameters, click Send
Raw log: see the bytes sent and received for debugging

Always test commands here before using them in macros. This confirms the device is responding and the driver is parsing responses correctly.

Device State

Every device exposes state variables at device.<id>.<property>. Examples:

device.projector_main.power: “off”, “on”, “warming”, “cooling”
device.projector_main.input: “hdmi1”, “hdmi2”, “vga1”
device.projector_main.lamp_hours: integer
device.switcher_1.input_1_output: “1”, “2”, “3”
device.dsp_1.mic_1_mute: true, false

These state keys are the building blocks of your system. They appear in UI bindings, macros, triggers, and scripts. You do not need to memorize them. The IDE provides autocomplete and pickers everywhere a state key is needed.

Device Management

The device detail panel includes several management actions:

Enable/Disable. Temporarily disable a device without removing it from the project. Disabled devices do not connect or poll.
Test Connection. Test network reachability (ping/TCP connect) without using the driver, useful for diagnosing network issues.
Reconnect. Force an immediate reconnect attempt on a disconnected device.
Duplicate. Create a copy of the device with a new ID, pre-filled with the same driver and settings.
Device Log. Filtered log view showing only activity for the selected device (commands sent, responses received, errors).

Device Groups

The Groups tab in the Devices view lets you create named groups of devices. Groups serve two purposes:

Macro commands. Use a “Group Command” macro step to send a command to every device in the group at once. For example, power on all projectors with a single step instead of one step per projector. Commands are sent concurrently, and offline devices are skipped automatically.
Organization. Devices in the same group are visually grouped together in the device list.

A device can belong to multiple groups (e.g., a display might be in both “All Displays” and “Conference Room A”).

Device Settings

Some devices have configurable values that live on the hardware itself, things like NDI source name, device hostname, tally mode, or video format. These are different from connection config (which is stored in the project file).

If a driver defines device settings, they appear in a Device Settings section in the device detail panel:

Each setting shows its current value (read from the device via polling), label, and help text
Click a setting to edit it. The new value is pushed directly to the device.
If the device is offline, settings are queued as “pending” and automatically applied when the device reconnects
Settings marked as setup in the driver are prompted when you first add the device to the project

Bulk Operations

Select multiple devices using the checkboxes in the device list to perform batch operations: enable, disable, or delete several devices at once.

Driver Library

The Driver Library is inside the Devices view. Click Devices in the sidebar, then select the Drivers tab at the top. It has three sub-tabs: Installed, Create, and Browse Community.

Installed Tab

The Installed tab shows all drivers available on this system. This includes default drivers that ship with OpenAVC and any community or custom drivers you have installed.

The left panel lists all registered drivers. Click a driver to see its details. The detail header carries the per-driver actions:

Open in Builder — open a YAML driver in the Driver Builder for editing.
Customize a Copy — built-in drivers are read-only; this clones one into your library so you can edit the copy.
Open in Code Editor — open a Python driver in the script editor.
Uninstall — remove the driver from the system. The button is disabled while a device in the current project uses it; the detail panel lists those devices so you know what to move first.

The body of the detail panel shows:

Overview. What the driver controls and which devices it supports.
Setup instructions. Step-by-step guide for connecting and configuring the device.
Configuration. The settings you need to provide (IP address, port, display ID, etc.).
Commands. All available commands with descriptions.
State variables. What state the driver exposes (power, volume, input, etc.).

Create Tab

Build custom drivers without code using the visual editor:

General. Name, manufacturer, model, category, description.
Transport. TCP, serial, or HTTP connection settings (port, baud rate, auth, etc.).
State Variables. Declare what state the driver exposes with types and defaults.
Commands. Define commands with send strings and parameter substitution.
Responses. Regex-based response parsing to extract state from device replies.
Polling. Automatic status queries on a timer (power, input, lamp hours).
Device Settings. Configurable values that live on the hardware (NDI name, video format, etc.).
Simulator. Define simulated behavior for testing without real hardware.

For most IP-controlled devices with a documented protocol, the Driver Builder can produce a working driver in 15-30 minutes. For serial devices, set the transport to serial and define the baud rate, data bits, and stop bits in the Transport tab.

See Creating Drivers for the complete driver development guide covering all three methods: no-code YAML definitions, the visual Driver Builder, and Python driver classes.

Browse Community Tab

Search and install drivers from the community driver library:

Click the Browse Community tab
Search by manufacturer, model, or category
Click a driver card to see full details (description, protocols, ports, transport)
Click Install for one-click download and installation
The driver is immediately available in the Installed tab and the Add Device dropdown

Available categories include projectors, displays, matrix switchers, DSPs, cameras, lighting, and more. If a driver does not exist for your equipment, you can build one.

Uninstalling Drivers

To remove a driver you no longer need:

Open the Installed tab in Driver Library
Click the driver in the left panel
Click Uninstall in the detail header, then confirm

You cannot uninstall a driver while a device in the project is using it. The Uninstall button is disabled in that case, and the detail panel lists the devices that reference the driver. Remove or reassign those devices first, then uninstall. You can always reinstall from Browse Community.

Drivers a Project Needs

When you open a project, OpenAVC checks every device’s driver against the registered drivers on this system. Devices whose driver isn’t installed are marked orphaned — they appear in the device list grayed out, with a yellow status dot and “(not installed)” next to the driver name.

If any orphaned devices are found and their drivers are available in the community catalog, a Missing Drivers prompt appears. It lists each missing driver with the device count it affects, separated into two groups:

Available from community — checked by default. Click Install N drivers to download them all from the community library in one step. As soon as each driver is registered, every device waiting on it activates and starts connecting.
Not in community catalog — drivers the project references that aren’t in the public library (private drivers, typos, drivers from another source). These need to be reassigned to a different driver, or the driver file uploaded manually from the Drivers tab.

Click Skip to dismiss without installing — the orphaned devices stay marked, and you can install their drivers later from Browse Community or the per-device banner.

Each orphaned device also shows a Driver Not Installed banner in its detail panel with two actions:

Install from Community — installs that single driver directly. The device activates as soon as the install completes.
Reassign Driver — opens the device editor so you can switch to a driver that is installed.

If the driver isn’t in the community catalog, the banner says so and offers Browse Drivers (to upload manually) plus Reassign Driver instead of the install button.

Device Discovery

The Discovery panel is inside the Devices view. Click Devices in the sidebar, then select the Discovery tab. It scans your network for AV devices and helps you add them to your project without manually entering IP addresses and driver settings.

Running a Scan

Click Devices in the sidebar, then select the Discovery tab
Select the subnet(s) to scan (auto-detected from your network interfaces)
Click Start Scan

The scan runs through several phases: ping sweep, port scanning, device probes (TCP/UDP), passive discovery (mDNS/SSDP), SNMP queries, and hostname resolution. Progress is shown in real time.

Working with Results

Each discovered device lands in one of three states:

Identified — a fingerprint matched a driver. The device card shows the driver and a one-line evidence string (e.g. “mDNS announcement on _pjlink._tcp.local.”). Click Add to Project to add it with a pre-filled config. When more than one driver fits the same device (a cross-vendor probe matched alongside a vendor-specific peer), the card offers the alternatives in a dropdown — the best fit comes first.
Possible — hints (OUI lookup, hostname pattern, open port, manufacturer alias) narrowed the device to a candidate list, but no fingerprint identified it outright. Confirm the right driver and add.
Unknown — the device is on the network but no driver matched. The card shows what we know (IP, MAC, OUI vendor, open ports). Pick a driver manually or hide the device.

Each card also shows IP / hostname, manufacturer, open ports, model and firmware (when the device reports them), and an optional Why? reveal that lists every signal observed during the scan (mDNS announcement, SSDP NOTIFY, TCP/UDP probe response, OUI lookup, hostname match, SNMP enterprise number, manufacturer alias, port observed open) — useful for debugging.

If the suggested driver is a community driver you haven’t installed yet, click Install & Add to install it and add the device in one step.

Scan Options

Scan Depth. Choose how deep the scanner goes:
- Quick. Fast re-scan. Ping sweep, port scanning, device probes, and short passive listening window. Skips NetBIOS name resolution and SNMP Entity MIB.
- Standard (recommended). Full scan including NetBIOS/SMB for Windows device names and SNMP Entity MIB for detailed hardware info. Longer passive listening window for mDNS and SSDP devices.
- Thorough. Extended port range, longest passive listening window. Takes longer but finds everything on the network.
SNMP. Enable SNMP v2c queries for richer device identification (community string configurable).
Reduce network load. Slows down the scan to reduce traffic. Use this on networks with strict IDS/IPS policies or where IT has asked you to scan carefully.
Extra Subnets. Add subnets beyond the auto-detected ones.
Export. Download scan results as a text report.

Devices that need configuration before they show up

Some devices ship with their network control surface disabled by default. If the scan doesn’t find a device you know is on the network, check whether it needs to be enabled in the device’s setup software:

Biamp Tesira / TesiraFORTÉ. Open the device’s System Manager, go to Network Settings, and turn on both Discovery and Telnet. Both default to off. Leave System Security off too — the OpenAVC driver expects an unauthenticated Telnet session, which matches the standard Tesira deployment when the DSP is on a private AV VLAN.
QSC Q-SYS Core. External control is on by default on TCP 1702. If the design has been hardened with a username/password, enter those in the driver config.
Yamaha MTX/MRX. RCP must be enabled in MTX-MRX Editor under System → Remote Control. The device allows up to 8 simultaneous network sessions.
Symetrix Composer DSPs. Ensure the controller numbers you want to drive have the Push checkbox enabled in Tools → Controller Manager, then compile and push the design to the unit.

After enabling the relevant network feature on the device, re-run the scan. If the device still doesn’t appear, you can always click Add Device and enter the IP, port, and driver manually.