Rig Sets from an MVR file
How do I import an MVR file and patch my fixtures from it?
Import the MVR file as a Rig Set and follow the four steps under "Set up the rig": pair the planned fixtures with live devices, check the pairings, apply DMX modes and start addresses, and save the rig as built.
Plan: Free
On this page
Short answer
Rig Sets, "Choose an MVR file to import", "Create set from MVR". Then follow the four steps under "Set up the rig": pair fixtures, check pairings, apply to devices, save as built.
What this is for
MVR files carry a fixture plan out of lighting design and visualisation software. QubiSet reads the plan, pairs each planned fixture with a real device on your network, and sets the DMX mode and start address from the plan. Device names can be set from the plan as well. At the end you save the finished rig as a normal Rig Set. MVR import is marked "Experimental".
Before you start
- Plan: Free keeps one Rig Set per Rig, and the imported plan is one. To save the rig as built in step 9 on Free, delete the plan Set after step 8 first. Freelance keeps 10 per Rig, Freelance Pro and Venue as many as you need.
- An
.mvrfile exported from your planning software. - A Rig is open, the fixtures are connected and discovered, and they answer RDM.
Steps
-
Choose the file. Go to Rig Sets. Under "From an MVR file" press "Choose an MVR file to import" and pick the file.
-
Check the preview. "Import preview" lists the planned fixtures in a table with "ID", "Fixture", "Mode" and "Universe.Address", for example "13.33" for universe 13, address 33. Adjust the "Set name" if you like and press "Create set from MVR". "Cancel import" stops here.
-
Find your way around. The plan appears under "MVR plans" in the sidebar, is marked "MVR plan", and opens on "Set up the rig". Four numbered steps run across the top: "Pair fixtures", "Check pairings", "Apply to devices" and "Save as built". Nothing has been sent to any device yet.
-
Pair fixtures. QubiSet pairs each planned fixture with a live device of the same model. Tiles show the result, for example "8 fixtures matched" and "3 fixtures need a choice". Click a tile to jump to that list. "Match again" repeats the pairing after you changed something in the rig.
-
Answer "Needs a choice". Here several live devices of the same model could be the planned fixtures. How you choose depends on how many there are:
- Several fixtures of the same type on one universe are put in order together under "Put these fixtures in order". The left column, "Live devices, in your order", lists the devices; the right column, "Plan, by DMX address", shows which planned fixture each one is paired with. Switch on "Identify while stepping", step through the devices with the Up and Down keys or by clicking them, and watch which fixture lights up. Press "Place as number ..." to put the highlighted device in the next place, so that the list matches where the fixtures hang. "Set as first" moves it to the top, "Reset order" starts again, and you can also drag a device to its place. Then press "Pair ... fixtures in this order". If you have not placed every device, QubiSet asks "Pair in the order shown?" first.
- A single fixture lists its candidates under "Which of these live devices is this fixture?". Switch on "Identify" next to a device and press "This is the fixture" on the one that hangs where the plan puts it. "Pair these fixtures one by one instead" switches a group of fixtures to this way of pairing.
When you are done, press "Continue to check pairings". You can also continue with open choices; those fixtures are simply left out.
-
Check pairings. "Matched" lists every planned fixture with its device and why they were paired, for example "Same device label" or "Same universe and address". "Unassign" undoes a pairing. Automatic pairings can shift when addresses or labels change: press "Save these ... pairings" to keep them fixed in the Set. Then press "Continue to apply".
-
Apply to devices. QubiSet lists each device with its current and planned value, for example "DMX address: 21 → 33". Tick "Also set device labels to the fixture IDs from the plan" if the fixtures should be renamed too. Press "Apply changes to ... devices". "Skip and continue without applying" moves on without touching the devices.
-
Wait for "All changes were applied." Then press "Continue to save as built".
-
Save as built. Press "Save as device capture". The Create Set form opens with a name such as "Demo Venue as built"; press "Create set". You now have a normal Rig Set of the finished rig that you can compare with and restore later. If "Create set" shows a lock, the Rig already holds the Rig Sets your plan includes; delete the plan Set or another one you no longer need, then save again.
Good to know
- Pairing does not change devices. Only "Apply changes to ... devices" in step 7 does.
- "Pair ... fixtures in this order" also keeps the order as the device order of that node port, the order the Network page shows.
- Universes are not changed. A fixture's universe is decided by the node port it is plugged into.
- MVR counts universes from 1, Art-Net from 0. "How fixtures are matched" explains this ("MVR universe 1 corresponds to Art-Net universe 0 and sACN universe 1") and the order in which QubiSet looks for a device: a pairing you saved, the same universe and address, the same device label, and last the only device of that model on the planned universe.
- "Saved content" shows the plan itself: the fixtures are marked "Planned" and the line above reads "... fixtures planned in an imported MVR file".
- The plan stays in the list under "MVR plans". You can come back to it, and "Back" at the bottom of each step returns to the step before.
If something is not as expected
- "Not found on the network". No discovered device has that model. Check the fixture is powered, connected and answering RDM, then press "Match again".
- "Fixture type unknown". The plan names a fixture type QubiSet cannot pair with an RDM model. Patch this one by hand.
- "On the network, not in the plan". Devices the plan does not mention. They are left alone.
- Many fixtures "need a choice". The plan and the rig share neither addresses nor names yet. Giving the fixtures the labels used in the plan first makes QubiSet pair them by "Same device label".
- "Choose an MVR file to import" shows a lock. The Rig already holds the Rig Sets your plan includes. Delete a Set you no longer need, or press the button to see which plans keep more.
- A step shows nothing to apply. The matched devices already have the planned mode and address ("devices already match the plan").
Related guides
Still stuck?
Ask us on Discord or write to support@qubicast.com. Tell us what you did and what you saw, and we will help.











