Skip to main content

Plugin Installation

This page covers how to install the vMaestro plugin into vatSys.

Prerequisites​

  • vatSys version 1.4.20 or later
  • .NET Framework 4.7.2 or later

Installation​

  1. Download the Maestro.Plugin.<version>.zip file from the latest release
  2. Extract Maestro.Plugin.<version>.zip into your vatSys plugins directory: 
    Documents\vatSys Files\Profiles\<Profile Name>\Plugins\MaestroPlugin
  3. Run unblock-dlls.bat (included in the zip) to unblock the DLL files

The zip includes a minimal example configuration (Maestro.yaml). This will need to be customised for your airport(s) before operational use.

Verification​

  1. Open vatSys
  2. Look for the TFMS menu item in the menu bar
  3. Click TFMS and select an airport
  4. If the vMaestro window appears, installation was successful

Troubleshooting​

TFMS menu item not appearing​

The DLL files may be blocked by Windows security.

  1. Locate unblock-dlls.bat in the plugin folder (or a parent folder)
  2. Run the script by double-clicking it
  3. Press Y when prompted to confirm
  4. Restart vatSys

DPI Awareness Issues​

On high-resolution displays, graphical issues may occur.

  1. Locate dpiawarefix.bat in the plugin folder
  2. Run the script
  3. Restart vatSys

Unable to locate Maestro.yaml​

The plugin cannot find its configuration file.

Ensure Maestro.yaml is placed in one of the following locations (searched in order):

  1. {ProfileDirectory}/Plugins/Configs/Maestro/Maestro.yaml
  2. {ProfileDirectory}/Plugins/Configs/Maestro.yaml
  3. {ProfileDirectory}/Plugins/Maestro.yaml
  4. {ProfileDirectory}/Maestro.yaml
  5. {PluginDirectory}/Maestro.yaml

See Plugin Configuration for configuration details.

Next Steps​

Once installation is verified, proceed to Plugin Configuration to customise vMaestro for your airport(s).