Chapter 48. Using MagicQ with other Visualisers

In addition to its own free MagicVis visualiser, MagicQ supports connection with other Visualisers via network protocols. MagicQ supports transfer of patch, XYZ and head selection information to and from Visualisers. The protocol used to communicate between MagicQ and the Visualiser depends on the particular Visualiser.

The simplest way to connect is using the Art-Net protocol in the same way as you would connect to Art-Net to DMX interfaces. Art-Net does not support transfer of patch, XYZ or head selection information, so for this you will need to use a Visualiser specific protocol.

It is possible to run MagicQ PC/Mac on the same system that is running the Visualiser. For best performance it may be better to run them on separate PCs linked via Ethernet.

48.1. Connecting to a Visualiser

MagicQ PC outputs up to a maximum of 64 universes for real control of lighting rigs configured in the Status, Out Type, Out Uni fields in Setup, View DMX I/O.

From V1.9.6.0 MagicQ PC supports external Visualisers for up to 400 universes via direct links to the Visualiser. When using more than 64 universes direct Visualiser links must be used.

When in MQ250M Previs, MQ500 Previs and MQ500M Previs panel modes normal lighting output is inhibited and Visualisers must also be connected with direct visualiser links.

These are configured in the Visualiser field in Setup, View DMX I/O.

The options are:



Capture (rem)

Capture (same PC)



Art/sACN(same PC)


When set to Art/sACN MagicQ sends directly over Art-Net or sACN to the Visualiser using the settings in Out Type and Out Uni. The universe does not need to be enabled.

In Setup, View Settings, Network set Visualiser IP to the required IP address of the Visualiser system. Art-Net and sACN data sent to Visualisers via the Visualisers field is always unicast - it is never broadcast or multicast.

To run both MagicQ PC and Visualiser on one PC set the option Setup, View Settings, Network, Net host options to Normal + Loopback IP.

To run MagicQ PC and a Visualiser on two different systems then you need to ensure that both systems have their IP address and Subnet Address set up to be on the same network range - e.g. set one to subnet and the other to subnet

When MagicQ PC sends to an external Visualiser the data for universes 65 to 400 will have occasional breaks to prevent it being used to control real lighting rigs. When MagicQ PC is in the MQ250M, MQ500 or MQ500M Previs modes all universes have these breaks. These breaks are not present on MQ500 200 universe or MQ500M+ consoles which output full 400 universes.

48.2. Capture

MagicQ supports connections to Capture visualiser (

There are two protocols for communication between MagicQ and Capture – Art-Net and CITP. Art-Net is a standard protocol used to carry DMX over Ethernet and enables control of the lighting.

CITP is an open protocol specific to Capture which enables both control of lighting and the transfer of the show patch between MagicQ and Capture. ChamSys provides executable files for both protocols.

To communicate using Art-Net simply set the required universes to Output Type of Art-Net in Setup, View DMX I/O and enable the universes. To use CITP simply set the Visualiser field for all required universes to Capture.

48.2.1. Receiving Patch Data from Capture

It is possible for patch data to be transmitted from Capture to MagicQ when connected via CITP protocol. Start a new show on MagicQ and then in the Patch Window press the Visualiser Patch soft button. This will download the Patch information from Capture to MagicQ. MagicQ uses a fields in the personality to specify the Capture manufacturer name (Make) and Capture moving light name).

Note that when receiving patch data from Capture, along with DMX addresses set in Capture, the channel number must also be set in Capture. Capture channel numbers = head numbers in MagicQ


MagicQ interfaces to the CAST WYSIWYG visualiser using a special driver file.

WYSIWYG and MagicQ can be on the same PC, or connected via network cable to another PC or console.

From MagicQ v1.9.0.5, the WYSIWYG driver is automatically installed when MagicQ PC is installed. Just install MagicQ v1.9.0.5 or later on the same PC as WYSIWYG. You can install a previous version of MagicQ afterwards if needed; the WYSIWYG driver will stay.

There is a WYSIWYG demo show at show/demos/magicqwysiwyg.wyg.

48.3.1. Enabling MagicQ to output WYSIWYG data

Now you need to configure the outputs. Go to the Setup, View DMX I/O window.

Move to the Visualiser row and select WYSIWYG for the universes you wish to use. There is no need to change the Status column to enabled - WYSIWYG is automatically enabled when you select WYSIWYG as the visualiser.


If you are using WYWISYG on the same PC as MagicQ then set the Visualiser to WYSIWYG (same PC) – otherwise, set it to WYSIWYG (remote). When connecting to WYSIWYG using a MagicQ console, always use WYSIWYG (remote).

When using WYSIWYG and MagicQ on different PCs it is important to ensure that MagicQ PC knows the IP address to use to communicate with WYSIWYG.

In Setup, View Settings, Network set the IP Address and Subnet Mask to be the same as the IP address of your network port in use on your PC.

The WYSIWYG driver installed by MagicQ v1.9.0.5 and later allows up to 256 universes, depending on the universe count of the connected MagicQ PC or console.

48.3.2. Running WYSIWYG

Start up WYSIWYG.

To get WYSIWYG to respond to data received you need to set up the ports in Device Manager. Go to LIVE mode, then MANAGERSDevice Manager…. If MagicQ is not already in the list, click on New, search for and add "ChamSys MagicQ". Select ChamSys MagicQ and then Connect.

Make sure you have installed the MagicQ WYSIWYG driver on the WYSIWYG PC. MagicQ will not connect to WYSIWYG without it.


The universes in WYSIWYG must be bound to the ChamSys MagicQ device in order for communication to occur with MagicQ. Select ChamSys MagicQ and click on Properties to setup universe mapping.


48.3.3. Auto Patch

MagicQ supports the WYSIWYG Auto Patch protocol, which transfers the patch from WYSIWYG to MagicQ. To transfer a new show to MagicQ first erase the show in MagicQ, then in WYSIWYG go to LIVE mode, then LIVEAutoPatchSend Patch.

Make sure that you have defined a Spot Number to each of your heads in WYSIWYG, otherwise WYSIWYG will not send the head over Auto Patch.

MagicQ identifies the fixtures in WYSIWYG and maps the names to the MagicQ heads using a mapping table and a matching algorithm. If MagicQ can not identify a head it may patch the wrong head or not patch it at all.

In the MagicQ personality it is possible to specify the WYSIWYG Auto Patch name that it should map to this MagicQ personality.

When performing an Auto Patch, MagicQ will report any heads that it can not match. To fix a personality, edit the head in the Head Editor, setting the correct WYSIWYG name. If the WYSIWYG name is empty then pressing ENTER will fill in with the name received from WYSIWYG for the last mismatch.

When using WYSIWYG with a separate MagicQ console make sure that on the console, Setup, View Settings, Multi Console, Enable Remote Access = Yes. This ensures the patch can be transferred correctly to the console.

48.3.4. Auto Focus

MagicQ supports the WYSIWYG Auto Focus protocol. If you turn Auto Focus on for the ChamSys port in the Device Manager on WYSIWYG then changes made in WYSIWYG design mode will be relayed to the programmer in the console.

48.3.5. Troubleshooting

Problem: WYSIWYG does not receive any data.

Solution: Check that you have installed the MagicQ WYSIWYG driver on the WYSIWYG PC. Check that the connection is connected in WYSIWYG device manager. Check that you have configured the correct MagicQ universes to use WYSIWYG as their Vsualiser.

Problem: WYSIWYG will not connect on the same PC as MagicQ.

Solution: Check that you have configured the Visualiser to be WYSIWYG (same PC) in the Setup Window.

Problem: WYSIWYG will not connect between two separate PCs.

Solution: Check that the network interfaces on the two PCs are configured to the same IP subnet, that they are enabled, and that you have configured MagicQ to use the correct network port (Setup, View Settings, IP address). Check any firewall settings.

Problem: WYSIWYG connects but no control of the lamps

Solution: Check the MagicQ Universe in WYSIWYG is bound to the MagicQ device.

48.4. Vision, Depence, L8

Vision, Depence and L8 all support Art-Net control. Simply set the required universes to Out Type of Art-Net and enable them. The Visualiser field should be set to "None".

For greater than 64 universes or when in Previs mode set the Visualiser field to Art/sACN (remote) or Art/sACN (same PC) and configure the Visualiser IP in Setup, View Settings, Network.