Perastage

Perastage is a free, cross-platform desktop viewer for MVR files.

It is designed to open an MVR project quickly, inspect its contents in a clear visual way, and make it easier to review fixtures, trusses, hoists, objects, and general scene structure without needing a full real-time DMX visualizer.

Perastage is not a real-time DMX visualizer. Its main purpose is to provide a fast and practical way to view, check, and work with MVR files that use GDTF libraries.

What Perastage is for

Perastage focuses primarily on viewing and working with MVR files. It uses GDTF fixture libraries to represent lighting devices and supports personal dictionary workflows so you can build and maintain your own GDTF library.

If you have a free GDTF Share account, Perastage can also connect to the official API to download GDTF files and help you complete your local library.

The goal is simple: make MVR files easy to open, understand, review, and present.

Highlights

• Fast and practical MVR viewer for lighting and show files.
• Free and cross-platform desktop application.
• Uses GDTF libraries to represent fixture data.
• Can connect to the official GDTF API to download fixture profiles if you have an account.
• Lets you maintain your own custom GDTF dictionary/library.
• Includes both 3D viewing and plan-focused 2D workflows.
• Supports importing and exporting MVR scenes.
• Can create elements directly from text using Tools → Create from text.
• Includes some distinctive workflow tools, such as the ability to create, modify, adjust, and distribute MVR elements from the command line.
• Helps review scene content quickly in a comfortable visual way.

Installation

The recommended way to install Perastage is to download the latest release from GitHub:

• Go to the latest release in this repository and download the package for your platform.

If you want to build from source, setup and dependency notes are available in the documentation under docs/.

Basic usage

• Open an existing .mvr file to inspect its content quickly.
• Review fixtures, trusses, hoists, objects, and scene structure.
• Use Tools → Create from text to generate elements from rider-style notes.
• Use the available tools to adjust and organize scene data more comfortably.

Documentation

The README is intentionally kept fairly compact. More detailed documentation lives in docs/:

• Documentation policy
• Feature overview
• Changes since beta 0.1.0
• Build and dependency guide
• Windows installation notes
• Packaging and platform integration
• Troubleshooting
• Repository structure
• Text-to-scene parsing rules
• GDTF mutation policy
• GUI shortcut architecture

Contributing

Feedback is very welcome.

If you try Perastage, it would be especially helpful if you:

• report bugs or unexpected behaviour
• suggest ideas for improving workflows or usability
• share edge cases or MVR/GDTF files that help improve compatibility

This is particularly useful for keeping Perastage as compatible and practical as possible across files created by different applications.

License

Perastage is distributed under the GNU General Public License v3.0. See LICENSE.txt.

Author

Perastage is developed and maintained by Luisma Peramato (GitHub: PeramatoG).