Plugin Description
The Christie Digital CineLife+ Series 4 Q-SYS Plugin provides seamless integration and control of Christie Digital CineLife+ Series 4 cinema projectors within the Q-SYS ecosystem. This plugin enables cinema integrators and professionals to monitor and control the projector directly from the Q-SYS ecosystem.
By leveraging this plugin, Q-SYS users gain centralized control over power management, lamp settings, lens positioning, channel selection, and comprehensive status monitoring. The plugin streamlines workflow efficiency by providing real-time device feedback and essential configuration controls within the familiar Q-SYS environment.
Key features
Comprehensive Device Information Display - Automatic retrieval and display of device parameters including Device Model, Serial Number, Firmware Version, Build Number, and MAC Address for quick system identification and troubleshooting.
Power Control - Complete power management with toggle button, discrete on/off triggers, and power state monitoring including standby, warming up, cooling down, and powered states.
Lamp Control - Full lamp management including on/off control, brightness adjustment (0-100%), lamp hour tracking, and cooldown timer display.
Douser Control - Remote douser operation with open/close functionality and status indication.
Channel Management - View and select from available projector channels with support for up to 64 configurable channels.
Test Pattern Management - Access to internal test patterns with full-screen mode and pattern retention options.
Lens Control - Manual lens positioning controls for vertical/horizontal offset, zoom, and focus adjustments with position feedback.
Media Playback - Basic media transport controls including play, pause, resume, stop, and unload.
Automation Support - Script and macro execution capabilities for automated workflows.
Advanced Status Monitoring - Detailed system status reporting including alarms, cooling, interlock, lamp, lens, network, security, system, temperature, and version information (Advanced mode).
Configuration Overview
Plugin version
This document is written for the plugin :
Christie Digital CineLife+ Series 4 V1.0.0.0
Release note
2026-06 : V1.0.0.0
Initial release to Q-SYS Library
QDS compatibility
This plugin has been developed and tested on :
Q-SYS Designer version 9.13.1 / 10.0.x / 10.1.x / 10.2.0 and 10.2.1
Properties
Channel Count
Type: Integer
Min: 8
Max: 64
Default Value: 8
Description: Defines the number of channel selection buttons available in the Channels page.
Status Level
Type: Enum
Choices: Simple, Advanced
Default Value: Simple
Description: Determines the level of status information displayed:
Simple: Shows only alarm status for basic monitoring.
Advanced: Displays comprehensive status information including Alarm, Cooling, Interlock, Lamp, Lens, Network, Security, System, Temperature, Version, and Video status.
Debug Print
Type: Enum
Choices: None, Tx/Rx, Tx, Rx, Function Calls, All, Debug
Default: None
Description: Controls debug output for troubleshooting purposes
Show Debug
Type: Boolean
Default Value: No
Description: When Show Debug is enabled, the "Debug Print" property becomes available. Setting this property to "Debug" displays the debug screen with verbose messages, enabling detailed troubleshooting.
Controls
Status
Status
Controls name: Status
Type: Indicator-Status
Description: Indicates the current connection and operational status of the plugin. Shows OK when connected normally, or displays fault/compromised messages when issues occur.
OK - Connected : The plugin is operating normally and connected to the projector.
Fault - [Message] : A problem has occurred, refer to message details (e.g., Wrong Credentials, Permission Level too low, Not a Series 4 cinema projector).
Compromised - [Message] : A problem has occurred, refer to message details (e.g., Wrong Credentials, Permission Level too low, Not a Series 4 cinema projector).
Control Page
Power Section
Power
Controls name: Power
Type: Button-Toggle
Description: Toggle button used to turn the projector power on or off.
Power On
Controls name: PowerOn
Type: Button-StateTrigger
Min: 0
Max: 1
Description: Discrete trigger button for turning the projector power on. This button lights up when the projector is powered on.
Power Off
Controls name: PowerOff
Type: Button-StateTrigger
Min: 0
Max: 1
Description: Discrete trigger button for turning the projector power off. This button lights up when the projector is powered off or in standby.
Power State
Controls name: PowerState
Type: Indicator-Led
Description: LED indicator showing the current power state (lit when powered on).
Power Status
Controls name: PowerStatus
Type: Indicator-Text
Description: Shows the detailed power status: Powered (Light Source Off), Powered (Light Source On), Standby, Cooling Down, or Warming Up.
Lamp Section
Lamp Power
Controls name: LampPower
Type: Button-Toggle
Description: Toggle button used to turn the lamp (light source) on or off while the projector is powered.
Lamp On
Controls name: LampOn
Type: Button-StateTrigger
Min: 0
Max: 1
Description: Discrete trigger button for turning the lamp on. This button lights up when the lamp is on.
Lamp Off
Controls name: LampOff
Type: Button-StateTrigger
Min: 0
Max: 1
Description: Discrete trigger button for turning the lamp off. This button lights up when the lamp is off.
Lamp State
Controls name: LampState
Type: Indicator-Led
Description: LED indicator showing the current lamp state (lit when lamp is on).
Lamp Brightness
Controls name: LampBrightness
Type: Knob-Fader
Min: 0%
Max: 100%
Description: Adjusts the lamp brightness level as a percentage.
Lamp Brightness Level
Controls name: LampBrightnessLevel
Type: Indicator-Text
Description: Displays the current brightness level as a percentage value.
Lamp Hour
Controls name: LampHour
Type: Indicator-Text
Description: Displays the accumulated lamp usage hours.
Lamp Cooldown
Controls name: LampCoolDown
Type: Indicator-Text
Description: Displays the remaining cooldown time in MM:SS format when the lamp is cooling down.
Douser Section
Douser
Controls name: Douser
Type: Button-Toggle
Description: Toggle button used to open or close the projector douser (shutter).
Douser Open
Controls name: DouserOpen
Type: Button-StateTrigger
Min: 0
Max: 1
Description: Discrete trigger button for opening the douser. This button lights up when the douser is open.
Douser Close
Controls name: DouserClose
Type: Button-StateTrigger
Min: 0
Max: 1
Description: Discrete trigger button for closing the douser. This button lights up when the douser is closed.
Douser State
Controls name: DouserState
Type: Indicator-Led
Description: LED indicator showing the douser state (lit when closed).
Douser Status
Controls name: DouserStatus
Type: Indicator-Text
Description: Shows the douser status as Open or Closed.
Test Pattern Section
Pattern Active
Controls name: PatternActive
Type: Indicator-Text
Description: Shows the name of the currently active test pattern.
Pattern Select
Controls name: PatternSelect
Type: Text-ComboBox
Description: Dropdown list of available internal test patterns. When a pattern is selected, it is displayed on the projector.
Pattern Clear
Controls name: PatternClear
Type: Button-Trigger
Description: Clears the currently active test pattern.
Pattern Full Screen
Controls name: PatternFullScreen
Type: Button-Toggle
Description: Enables or disables full-screen mode for test patterns.
Pattern Keep
Controls name: PatternKeep
Type: Button-Toggle
Description: When enabled, the test pattern persists when changing channels.
Lens Section
Lens V Pos
Controls name: LensVPos
Type: Indicator-Text
Description: Shows the current vertical lens offset position.
Lens H Pos
Controls name: LensHPos
Type: Indicator-Text
Description: Shows the current horizontal lens offset position.
Lens Zoom Pos
Controls name: LensZoomPos
Type: Indicator-Text
Description: Shows the current zoom position.
Lens Focus Pos
Controls name: LensFocusPos
Type: Indicator-Text
Description: Shows the current focus position.
Lens Up
Controls name: LensUp
Type: Button-Momentary
Description: Momentary button for moving the lens up.
Lens Down
Controls name: LensDown
Type: Button-Momentary
Description: Momentary button for moving the lens down.
Lens Left
Controls name: LensLeft
Type: Button-Momentary
Description: Momentary button for moving the lens left.
Lens Right
Controls name: LensRight
Type: Button-Momentary
Description: Momentary button for moving the lens right.
Lens Focus In
Controls name: LensFocusIn
Type: Button-Momentary
Description: Momentary button for adjusting the lens focus inward.
Lens Focus Out
Controls name: LensFocusOut
Type: Button-Momentary
Description: Momentary button for adjusting the lens focus outward.
Lens Zoom In
Controls name: LensZoomIn
Type: Button-Momentary
Description: Momentary button for zooming the lens in.
Lens Zoom Out
Controls name: LensZoomOut
Type: Button-Momentary
Description: Momentary button for zooming the lens out.
Media Section
Media Play
Controls name: MediaPlay
Type: Button-Trigger
Description: Starts playback of loaded content.
Media Pause
Controls name: MediaPause
Type: Button-Trigger
Description: Pauses the current playback.
Media Resume
Controls name: MediaResume
Type: Button-Trigger
Description: Resumes paused playback.
Media Stop
Controls name: MediaStop
Type: Button-Trigger
Description: Stops the current playback.
Media Unload
Controls name: MediaUnload
Type: Button-Trigger
Description: Unloads the currently loaded content.
Media Duration
Controls name: MediaDuration
Type: Indicator-Text
Description: Shows the duration of the loaded content in HH:MM:SS format.
Automation Section
Automation Script
Controls name: AutomationScript
Type: Text-Text Edit
Description: Text field for entering automation script commands.
Automation Macro
Controls name: AutomationMacro
Type: Text-Text Edit
Description: Optional text field for entering a macro name. When specified, executes the specified macro from the specified script.
Automation Execute
Controls name: AutomationExecute
Type: Button-Trigger
Description: Executes the specified automation script or macro.
Channels Page
Channel Active
Controls name: ChannelActive
Type: Indicator-Text
Description: Shows the name of the currently active channel.
Channel Select
Controls name: ChannelSelect
Type: Text-ComboBox
Description: Dropdown list of available channels on the projector. When a new channel is selected, the projector switches to that channel.
Channel 1-N Name
Controls name: Channel{N}Name
Type: Indicator-Text
Description: Displays the name of each channel slot (up to Channel Count property value).
Channel 1-N State
Controls name: Channel{N}State
Type: Button-StateTrigger
Min: 0
Max: 1
Description: Trigger buttons to select each channel directly. These buttons light up when the corresponding channel is currently active.
Status Page
Device Information
MAC Address
Controls name: MACAddress
Type: Indicator-Text
Description: Shows the management MAC address of the connected projector.
Device Model
Controls name: DeviceModel
Type: Indicator-Text
Description: Shows the model number of the connected projector.
Serial Number
Controls name: SerialNumber
Type: Indicator-Text
Description: Shows the serial number of the connected projector.
Device Firmware
Controls name: DeviceFirmware
Type: Indicator-Text
Description: Shows the firmware version installed on the connected projector.
Build Number
Controls name: BuildNumber
Type: Indicator-Text
Description: Shows the build number of the firmware installed on the connected projector.
Status Indicators
Status Alarm
Controls name: StatusAlarm
Type: Indicator-Text
Description: Shows current alarm messages. Available in both Simple and Advanced modes.
Status Alarm Led
Controls name: StatusAlarmLed
Type: Indicator-Led
Description: LED indicator for alarm fault conditions. Lit when an alarm is active. Available in both Simple and Advanced modes.
Status Cooling
Controls name: StatusCooling
Type: Indicator-Text
Description: Shows cooling system status (Advanced mode only).
Status Cooling Led
Controls name: StatusCoolingLed
Type: Indicator-Led
Description: LED indicator for cooling system faults (Advanced mode only).
Status Interlock
Controls name: StatusInterlock
Type: Indicator-Text
Description: Shows interlock status (Advanced mode only).
Status Interlock Led
Controls name: StatusInterlockLed
Type: Indicator-Led
Description: LED indicator for interlock faults (Advanced mode only).
Status Lamp
Controls name: StatusLamp
Type: Indicator-Text
Description: Shows lamp status details (Advanced mode only).
Status Lamp Led
Controls name: StatusLampLed
Type: Indicator-Led
Description: LED indicator for lamp faults (Advanced mode only).
Status Lens
Controls name: StatusLens
Type: Indicator-Text
Description: Shows lens status details (Advanced mode only).
Status Lens Led
Controls name: StatusLensLed
Type: Indicator-Led
Description: LED indicator for lens faults (Advanced mode only).
Status Network
Controls name: StatusNetwork
Type: Indicator-Text
Description: Shows network status details (Advanced mode only).
Status Network Led
Controls name: StatusNetworkLed
Type: Indicator-Led
Description: LED indicator for network faults (Advanced mode only).
Status Security
Controls name: StatusSecurity
Type: Indicator-Text
Description: Shows security status details (Advanced mode only).
Status Security Led
Controls name: StatusSecurityLed
Type: Indicator-Led
Description: LED indicator for security faults (Advanced mode only).
Status System
Controls name: StatusSystem
Type: Indicator-Text
Description: Shows system status details (Advanced mode only).
Status System Led
Controls name: StatusSystemLed
Type: Indicator-Led
Description: LED indicator for system faults (Advanced mode only).
Status Temperature
Controls name: StatusTemperature
Type: Indicator-Text
Description: Shows temperature status details (Advanced mode only).
Status Temperature Led
Controls name: StatusTemperatureLed
Type: Indicator-Led
Description: LED indicator for temperature faults (Advanced mode only).
Status Version
Controls name: StatusVersion
Type: Indicator-Text
Description: Shows version status details (Advanced mode only).
Status Version Led
Controls name: StatusVersionLed
Type: Indicator-Led
Description: LED indicator for version faults (Advanced mode only).
Status Video
Controls name: StatusVideo
Type: Indicator-Text
Description: Shows video status details (Advanced mode only).
Status Video Led
Controls name: StatusVideoLed
Type: Indicator-Led
Description: LED indicator for video faults (Advanced mode only).
Setup Page
IP Address
Controls name: IPAddress
Type: Text-Text Edit
Description: Text field used to specify the IP address of the projector that you want to remotely control and/or monitor.
Port
Controls name: Port
Type: Text-Text Edit (Default: 5000)
Description: The TCP port number used for communication with the projector. Default is 5000.
Username
Controls name: Username
Type: Text-Text Edit
Description: The username credential required for authentication with the projector.
Password
Controls name: Password
Type: Text-Text Edit
Description: The password credential required for authentication with the projector. Manager or higher access level is required.
Control Pins
PIN NAME | VALUE | STRING | POSITION | PINS AVAILABLE |
|---|---|---|---|---|
Setup | - | - | - | - |
IP Address | (String) | - | - | Input / Output |
Port | (String) | - | - | Input / Output |
Username | (String) | - | - | Input / Output |
Password | (String) | - | - | Input / Output |
Status | - | - | - | - |
MAC Address | (String) | - | - | Output |
Device Model | (String) | - | - | Output |
Serial Number | (String) | - | - | Output |
Device Firmware | (String) | - | - | Output |
Build Number | (String) | - | - | Output |
Status | - | - | - | Output |
Power Controls | - | - | - | - |
Power | 0 | false | 0 | Input / Output |
Power On | 0 | false | 0 | Input / Output |
Power Off | 0 | false | 0 | Input / Output |
Power State | 0 | false | 0 | Output |
Power Status | (String) | - | - | Output |
Lamp Controls | - | - | - | - |
Lamp Power | 0 | false | 0 | Input / Output |
Lamp On | 0 | false | 0 | Input / Output |
Lamp Off | 0 | false | 0 | Input / Output |
Lamp State | 0 | false | 0 | Output |
Lamp Brightness | 0-100 | (Percent) | 0-1 | Input / Output |
Lamp Brightness Level | (String) | - | - | Output |
Lamp Hour | (String) | - | - | Output |
Lamp Cooldown | (String) | - | - | Output |
Douser Controls | - | - | - | - |
Douser | 0 | false | 0 | Input / Output |
Douser Open | 0 | false | 0 | Input / Output |
Douser Close | 0 | false | 0 | Input / Output |
Douser State | 0 | false | 0 | Output |
Douser Status | (String) | - | - | Output |
Channels | - | - | - | - |
Channel Select | (String) | - | - | Input / Output |
Channel Active | (String) | - | - | Output |
Channel N Name | (String) | - | - | Input / Output |
Channel N State | 0 | false | 0 | Input / Output |
Test Pattern | - | - | - | - |
Pattern Select | (String) | - | - | Input / Output |
Pattern Active | (String) | - | - | Output |
Pattern Clear | (Trigger) | - | - | Input / Output |
Pattern Full Screen | 0 | false | 0 | Input / Output |
Pattern Keep | 0 | false | 0 | Input / Output |
Lens Controls | - | - | - | - |
Lens V Pos | (String) | - | - | Output |
Lens H Pos | (String) | - | - | Output |
Lens Zoom Pos | (String) | - | - | Output |
Lens Focus Pos | (String) | - | - | Output |
Lens Up | (Momentary) | - | - | Input / Output |
Lens Down | (Momentary) | - | - | Input / Output |
Lens Left | (Momentary) | - | - | Input / Output |
Lens Right | (Momentary) | - | - | Input / Output |
Lens Focus In | (Momentary) | - | - | Input / Output |
Lens Focus Out | (Momentary) | - | - | Input / Output |
Lens Zoom In | (Momentary) | - | - | Input / Output |
Lens Zoom Out | (Momentary) | - | - | Input / Output |
Media Controls | - | - | - | - |
Media Play | (Trigger) | - | - | Input / Output |
Media Pause | (Trigger) | - | - | Input / Output |
Media Resume | (Trigger) | - | - | Input / Output |
Media Stop | (Trigger) | - | - | Input / Output |
Media Unload | (Trigger) | - | - | Input / Output |
Media Duration | (String) | - | - | Output |
Automation | - | - | - | - |
Automation Script | (String) | - | - | Input / Output |
Automation Macro | (String) | - | - | Input / Output |
Automation Execute | (Trigger) | - | - | Input / Output |
Status Indicators | - | - | - | - |
Status Alarm | (String) | - | - | Output |
Status Alarm Led | 0 | false | 0 | Output |
Status Cooling | (String) | - | - | Output |
Status Cooling Led | 0 | false | 0 | Output |
Status Interlock | (String) | - | - | Output |
Status Interlock Led | 0 | false | 0 | Output |
Status Lamp | (String) | - | - | Output |
Status Lamp Led | 0 | false | 0 | Output |
Status Lens | (String) | - | - | Output |
Status Lens Led | 0 | false | 0 | Output |
Status Network | (String) | - | - | Output |
Status Network Led | 0 | false | 0 | Output |
Status Security | (String) | - | - | Output |
Status Security Led | 0 | false | 0 | Output |
Status System | (String) | - | - | Output |
Status System Led | 0 | false | 0 | Output |
Status Temperature | (String) | - | - | Output |
Status Temperature Led | 0 | false | 0 | Output |
Status Version | (String) | - | - | Output |
Status Version Led | 0 | false | 0 | Output |
Status Video | (String) | - | - | Output |
Status Video Led | 0 | false | 0 | Output |
Note: Status Alarm controls are available in both Simple and Advanced modes. All other status controls (Cooling, Interlock, Lamp, Lens, Network, Security, System, Temperature, Version, Video) are only available when Status Level property is set to "Advanced".
support@ad-da.ca | Copyright © 2026 AD-DA.CA