If you’ve ever patched a rig and discovered that your console’s fixture profile doesn’t match the firmware in the lights, or rebuilt a whole plot by hand because the CAD drawing couldn’t talk to your desk, GDTF and MVR are aimed squarely at you. They are two open file formats that let fixture data and complete rig layouts move between manufacturers, consoles, visualizers and CAD software. Here’s what each one does and why it matters to a lighting programmer.

The problem they solve
Every console and every visualizer has traditionally used its own fixture library format. That means each fixture has to be described again for each platform, by the console maker, the visualizer maker or the user. Profiles lag behind new firmware, DMX modes get mixed up, and custom profiles multiply. As the GDTF specification puts it, fixture manufacturers would otherwise need to understand how every console or visualizer works and how to provide the required data.
On top of that, a lighting plot built in a CAD program usually has to be re-entered in the console: fixture types, addresses, IDs and positions. Every manual step is a chance for error. If you want the basics of addressing first, start with our explainer on what DMX512 is.
What is GDTF?
GDTF stands for General Device Type Format. It is a standardized way of describing intelligent and complex lighting devices, published as DIN SPEC 15800 (the current edition, DIN SPEC 15800:2022-02, corresponds to GDTF version 1.2). It is a DIN SPEC, not an ESTA standard. The initiative was founded by MA Lighting, Robe and Vectorworks.
What’s inside a GDTF file
A GDTF file is a zip archive with the extension .gdtf. Inside you’ll find:
- description.xml, which describes the device type, all of its DMX modes and all of its firmware revisions
- a wheels folder with images, such as gobos
- 3D models in 3DS and glTF formats, and SVG vector graphics, at different quality levels and views
- optional thumbnails in PNG and SVG
The key idea is that one file holds everything a console needs to patch and control the fixture and everything a visualizer needs to draw it, so the same description can be used across platforms.
Where to find GDTF files
The central library is gdtf-share.com, run by VPLT. Manufacturers and users upload fixture files there. As with any library, check who created a file and which firmware and modes it covers before relying on it for a show.
What is MVR?
MVR stands for My Virtual Rig. It is a royalty-free, open standard that lets programs share the data and geometry of a scene, published as DIN SPEC 15801 (current edition DIN SPEC 15801:2023-12, corresponding to MVR version 1.6). If GDTF describes one fixture type, MVR describes the whole rig.
What an MVR file carries
According to the specification on gdtf.eu, an MVR file is a zip archive containing an XML scene description and can include:
- Parametric objects such as fixtures, trusses, video screens and other scene objects, organized in layers
- Fixture addressing: DMX addresses and network configuration
- Fixture IDs used to select fixtures for programming
- Position and orientation of every object, as transformation matrices
- The GDTF files for the fixtures used
- 3D model files in 3DS or glTF/GLB format
In practice, that means a designer can draw a rig in CAD, export an MVR, and the programmer can import it into a console or visualizer with fixture types, addresses, IDs and positions already in place.
MVR-xchange: sharing over the network
The MVR specification also defines MVR-xchange, a protocol that lets applications exchange MVR files over a network without a USB stick. It has two modes: a TCP mode that works without configuration (using mDNS for discovery) but does not support routing, and a WebSocket mode that needs minimal configuration but can be routed.
GDTF vs MVR at a glance
| GDTF | MVR | |
|---|---|---|
| Full name | General Device Type Format | My Virtual Rig |
| Standard | DIN SPEC 15800 | DIN SPEC 15801 |
| Describes | One fixture type (all modes, firmware revisions) | A whole scene or rig |
| Container | Zip archive, .gdtf | Zip archive with XML scene description |
| Contains | description.xml, wheel images, 3D and SVG models | Objects, addresses, fixture IDs, positions, GDTF and 3D files |
| Network exchange | n/a | MVR-xchange (TCP or WebSocket) |
What this means for your workflow
For programmers
- Fewer hand-built profiles: when a manufacturer publishes a GDTF, you start from their data rather than a guess.
- Faster patching: an MVR import can bring in fixture types, addresses and IDs in one step.
- Consistency between console and visualizer, because both read the same description.
For designers and production teams
- One source of truth for the rig, from CAD to console to previz.
- Easier revisions: re-export the MVR rather than re-typing changes.
Practical cautions
- Support differs between applications and versions, so check what your console and visualizer actually import and export before building a workflow around it.
- Always verify DMX modes and firmware against the real fixtures on site.
- Keep a copy of the files used for each show, so the patch can be rebuilt if needed.
For a wider view of how fixture libraries, consoles and software fit together, see our guides to DMX lighting control software and to designing a stage lighting control system. If you want a free way to explore a modern console workflow, the grandMA3 onPC guide explains what the free software can do without hardware.
Key takeaways
- GDTF (DIN SPEC 15800) describes a fixture type in one open, zipped file: DMX modes, firmware revisions, wheels and 3D models.
- MVR (DIN SPEC 15801) describes a whole rig: objects, positions, addresses, fixture IDs, plus the GDTF and 3D files.
- MVR-xchange moves MVR files between applications over the network.
- gdtf-share.com, run by VPLT, is the central fixture library, and the initiative was founded by MA Lighting, Robe and Vectorworks.
Frequently asked questions
What is the difference between GDTF and MVR?
GDTF describes a single fixture type, with its DMX modes, firmware revisions, wheels and 3D models. MVR describes a whole rig, including object positions, DMX addresses, fixture IDs and the GDTF files used.
Is GDTF an ESTA standard?
No. GDTF is published as DIN SPEC 15800, and MVR as DIN SPEC 15801.
Who created GDTF?
The GDTF initiative was founded by MA Lighting, Robe and Vectorworks. The online fixture library gdtf-share.com is run by VPLT.
What is MVR-xchange?
It is part of the MVR specification and lets applications exchange MVR files over a network without a USB stick, in a TCP mode or a routable WebSocket mode.
Sources — gdtf.eu – GDTF introduction (DIN SPEC 15800), gdtf.eu – GDTF file format definition, gdtf.eu – MVR introduction (DIN SPEC 15801), gdtf.eu – MVR file format definition, gdtf.eu – MVR-xchange.








