Virtual Wing logoVirtual Wing
Free TrialDemoSetupPlugins

Virtual Wing › Setup guide

Control grandMA3 onPC with a virtual command wing

grandMA3 onPC is free and powerful, but with only a mouse, programming is slow: one fader at a time, no encoders under your fingers, no dedicated keys. Virtual Wing adds a full control surface on screen — executors, faders, encoders, command keys and the command line — on Mac or Windows, with mouse or touchscreen. It talks to grandMA3 onPC over OSC, with two-way feedback: what you change in grandMA3 shows up in Virtual Wing too.

This guide explains the whole setup, on one computer or on two computers on the same network. It takes about 10 minutes.

What you need

1. Install Virtual Wing

At first launch, enter your licence key or the trial code. An Internet connection is needed once, for activation; after that Virtual Wing works offline.

2. Copy the plug-in into the grandMA3 plug-in folder

The plug-in is two files that must stay together: Virtual_Wing_Plugin_V161.xml and Virtual_Wing_Plugin_V161.lua (folder Plugin grandMA3 of the DMG or ZIP). Copy them, on the computer that runs grandMA3 onPC, into:

3. Import the plug-in in grandMA3 onPC

Load your show and open a Plugins window. Edit an empty pool slot, tap Import, choose Virtual_Wing_Plugin_V161.xml from the folder of step 2 and confirm. Close the editor and save the show (Menu › Quick Save).

Important: import it only from the folder of step 2. grandMA3 then stores the plug-in inside your show and it is still there after every restart. If you import it from grandMA3’s own resource folders, grandMA3 only keeps a link and the plug-in is empty after a restart.

4. Start the plug-in

Tap Virtual Wing Plugin V161 in the Plugins pool and choose your mode: Computer Local (one computer) or Computer Remote (two computers). After each grandMA3 onPC launch, just tap it again in the pool: no need to import it again. Choose Install / Keep to install the macro used by the Backup key.

5. Set up OSC in grandMA3 onPC

Open Menu › In & Out › OSC. For every row: Mode UDP, Prefix empty, Data Pool / Page / Fader / Executor Knob / Key ticked, Fader Range 100, Echo Input and Echo Output No.

A. One computer (Local)

Virtual Wing and grandMA3 onPC on the same Mac or the same PC. In Virtual Wing Settings choose Local — Same Computer. Plug-in mode: Computer Local. OSC: Enable Input On, Enable Output Off. One row is enough:

NoNameDestination IPPortReceiveSendReceive CommandSend Command
1Wing Commands127.0.0.18000YesNoYesNo

B. Two computers on the same network (Remote)

Mac to Mac, Mac to Windows, Windows to Mac or Windows to Windows. In Virtual Wing Settings choose Remote — Network Connection, enter the grandMA3 IPv4 address and save. Plug-in mode: Computer Remote, then enter the Wing IPv4 address (the computer running Virtual Wing). OSC: Enable Input On and Enable Output On, with two rows:

NoNameDestination IPPortReceiveSendReceive CommandSend Command
1Wing CommandsgrandMA3 IPv48000YesNoYesNo
2Wing FeedbackWing IPv48001NoNoNoYes

The plug-in sends feedback to the Wing computer on UDP port 8001. Keep row 2: it is used by the return test and as a fallback.

Find an IPv4 address: Mac — System Settings › Network › your connection › Details › TCP/IP. Windows — Settings › Network & Internet › connection properties › IPv4.

6. Test the connection

If something does not work

Using a touchscreen

On a touchscreen, Virtual Wing works like a real wing: move faders and turn encoders with your fingers, with two-finger multitouch on compatible screens. A second screen next to your laptop turns grandMA3 onPC into a comfortable programming station at home, in the studio or on tour.

Virtual Wing is a control surface. It does not unlock DMX output or parameters: DMX output remains subject to MA Lighting’s hardware requirements. Official MA Lighting documentation: OSC in grandMA3 ↗.

Try it on your own show

Free 24-hour trial for Mac and Windows. Full licence USD $45 with free updates.

← Back to Virtual Wing