# AD-DA.ca, FlexFader ## Plugin Description --- The [AD-DA.ca](http://AD-DA.ca) FlexFader Q-SYS Plugin provides a flexible and customizable fader control interface for Matrix Mixer components within the Q-SYS ecosystem. This plugin enables system integrators and AV professionals to create intuitive audio mixing interfaces directly from the Q-SYS Designer, eliminating the need for complex scripting or external control solutions. By leveraging this plugin, Q-SYS users gain centralized control over multiple audio channels with configurable fader banks, customizable control behaviors, and optional audio metering. The plugin streamlines workflow efficiency by providing flexible channel navigation, pattern-based channel selection, and per-channel customization within the familiar Q-SYS environment. This integration is particularly valuable in professional AV installations where audio mixing interfaces need to be tailored to specific operational requirements, such as broadcast facilities, live event venues, houses of worship, and corporate environments. ### Key features * **Configurable Fader Count** - Supports 1 to 12 faders per plugin instance, allowing flexible interface sizing based on project requirements. * **Matrix Mixer Integration** - Direct connection to Q-SYS Matrix Mixer components via component name and pattern-based channel selection. * **Bank Navigation** - Navigate through multiple channel banks using Previous/Next controls with configurable scrolling behavior. * **Customizable Controls** - Per-channel customization of value ranges, control visibility, enable/disable states, and custom labels through pattern matching. * **Audio Metering** - Optional audio metering with configurable mono and stereo input/output channels for visual signal monitoring. * **Read/Write Control Modes** - Configure Value and Label controls as read-only or read/write based on operational needs. * **Mute Inversion** - Option to invert mute button logic for installations requiring inverted mute behavior. ## Configuration Overview --- ### Plugin version This document is written for the plugin : * [AD-DA.ca](http://AD-DA.ca) FlexFader 1.1.0.0 ### Release note **2026-03 : V1.1.0.0** * Minor bug fixes * Adds new bank strategy controls **2025-12 : V1.0.0.0** * Initial Release ### QDS compatibility This plugin has been developed and tested on : * Q-SYS Designer version 9.13.0 / 10.0.x, 10.1.x and 10.2.0 ## 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 . 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. ### Faders ##### Fader Count *Type: Integer (1-12)* Specifies the number of fader channels available in the plugin interface. Default value is 12. ##### Customize Controls *Type: Boolean* When enabled, reveals additional customization options for fader controls including Value, Label, and Mute behavior settings. ### Customize ##### Value *Type: Enum (Read, Read/Write)* Determines whether the fader value control is read-only or read/write. Available when Customize Controls is enabled. ##### Label *Type: Enum (Read, Read/Write)* Determines whether the channel label control is read-only or read/write. Available when Customize Controls is enabled. ##### Mute *Type: Enum (Normal, Inverted)* Configures mute button behavior. "Normal" follows standard mute logic; "Inverted" reverses the mute state. Available when Customize Controls is enabled. ### Audio ##### Metering *Type: Boolean* When enabled, adds audio metering controls and audio pins for visual signal monitoring. ##### Mono Input *Type: Integer (0-512)* Number of mono input channels for metering. Enter the same value as configured in your Matrix Mixer. Default is 12. ##### Stereo Input *Type: Integer (0-252)* Number of stereo input channels for metering. Enter the same value as configured in your Matrix Mixer. Input meters are pre-fader. ##### Mono Output *Type: Integer (0-512)* Number of mono output channels for metering. Enter the same value as configured in your Matrix Mixer. ##### Stereo Output *Type: Integer (0-252)* Number of stereo output channels for metering. Output meters are post-fader. ## Controls --- ### Status #### Status *Indicator-Status* Indicates the current operational status of the plugin. :::success OK : The plugin is operating normally. ::: :::warning Fault - [Message] : A problem has occurred, refer to message details. ::: ### Setup ##### Component *Text-Text Edit* Text field used to specify the name of the Matrix Mixer component to control. Enter the exact component name as it appears in your Q-SYS design. ##### Pattern *Text-Text Edit* Text field used to define the channel selection pattern for the Matrix Mixer. Supports pattern syntax for flexible channel targeting. ### Bank Navigation ##### Bank Previous *Button-Trigger* Button to navigate to the previous bank of channels. ##### Bank Index *Text-Text Edit* Displays and allows direct entry of the current bank index position. ##### Bank Next *Button-Trigger* Button to navigate to the next bank of channels. ### Fader Controls (per channel) ##### ChX Index *Indicator-Text* Displays the Matrix Mixer channel index currently assigned to this fader position. ##### ChX Plus *Button-Momentary* Momentary button to increment the fader value. ##### ChX Value *Knob-Integer (0-100)* Fader control for adjusting the channel level. Range is 0-100%. ##### ChX Minus *Button-Momentary* Momentary button to decrement the fader value. ##### ChX Mute *Button-Toggle* Toggle button to mute/unmute the channel. ##### ChX Label *Text-Text Edit* Text field displaying or editing the channel label. ### Metering Controls (when Metering enabled) ##### ChX Signal Left / Right *Indicator-Led* LED indicator showing signal presence on the left/right channel. ##### ChX Meter Left / Right *Indicator-Meter* Audio meter displaying signal level on the left/right channel. ## Control Pins --- | PIN NAME | VALUE | STRING | POSITION | PINS AVAILABLE | |:---------|:-----:|:------:|:--------:|:--------------:| | **Setup** | | | | | | Component | (String) | | | Input / Output | | Pattern | (String) | | | Input / Output | | **Bank Navigation** | | | | | | BankPrevious | (Trigger) | | | Input / Output | | BankIndex | (String) | | | Input / Output | | BankNext | (Trigger) | | | Input / Output | | **Faders (per channel 1-12)** | | | | | | ChX Index | (String) | | | Input / Output | | ChX Plus | (Trigger) | | | Input / Output | | ChX Value | 0-100 | (Integer) | 0-1 | Input / Output | | ChX Minus | (Trigger) | | | Input / Output | | ChX Mute | 0
1 | false
true | 0
1 | Input / Output | | ChX Label | (String) | | | Input / Output | | **Metering (when enabled)** | | | | | | ChX Signal Left | 0
1 | false
true | 0
1 | Output | | ChX Signal Right | 0
1 | false
true | 0
1 | Output | | ChX Meter Left | (dB) | | | Output | | ChX Meter Right | (dB) | | | Output | | **Status** | | | | | | Status | \- | \- | \- | Output | :::info "ChX" represents channel numbers 1 through the configured Fader Count (1-12). ::: ## Audio Pins --- When Metering is enabled, audio pins are created based on the Mono/Stereo Input/Output property values: | PIN NAME | DIRECTION | |:---------|:---------:| | Input 1 - N (Mono) | Input | | Input N Left / Right (Stereo) | Input | | Output 1 - N (Mono) | Input | | Output N Left / Right (Stereo) | Input | :::info Audio pins receive signals for metering purposes. Configure the pin counts to match your Matrix Mixer component settings. ::: --- ![](https://docs.ad-da.ca/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzM3YmU2MDE2LWVjNzktNDVlYy04YTA1LWY5ZWFmMjk0YjdiMy8zOGNiMjA2NS04MTg5LTQ4ZjYtYTIwZC05Nzk5ZmI2MTcyMjkvdGVzdC5wbmciLCJ0eXBlIjoiYXR0YWNobWVudCIsImlhdCI6MTc4OTAzMzUwMCwiZXhwIjoxNzg5MTE5OTAwfQ.j5Je-JvOO9tiEPVv16mZnUvGm1yPTmxvIYbFKe1bYFQ "left-50 =100x100") *support@ad-da.ca | Copyright © 2026* [*AD-DA.CA*](http://AD-DA.CA) --- **Documents** - [Frequently Asked Questions](https://docs.ad-da.ca/s/guide/doc/frequently-asked-questions-WYCxRgYzYg) - [Activation Portal](https://docs.ad-da.ca/s/guide/doc/activation-portal-MCuyIlFv42) - [Q-SYS Plugins](https://docs.ad-da.ca/s/guide/doc/q-sys-plugins-1ccQgVxaEF)