Jump to content

XMidiCtrl - A MIDI Controller Plugin for X-Plane 1.12

About This File



About this plugin
You have a MIDI Controller at home with lots of buttons and knobs? Why not use it with your favourite aircraft to control the autopilot and many other functions! XMidiCtrl is a plugin for X-Plane 11, which allows you to connect MIDI controllers to X-Plane commands and datarefs without the need of additional software.

The plugin was developed for X-Plane 11.50+ / 12 and supports Microsoft Windows, Linux and macOS (universal build).

The following devices are officially supported:

  • Behringer X Touch Mini

The following devices are known to work:

  • Behringer BCR2000
  • Behringer X-Touch Compact
  • Loupedeck Live

XMidiCtrl is open source: GitHub page



  • Create different profiles for your aircrafts
  • Bind knobs and buttons of your controller to X-Plane Commands and DataRefs
  • Simulate push and pull functions for buttons (normal button press = push, long botton press = pull)
  • Send MIDI messages to the MIDI device to illuminate buttons when certain modes are active (e.g. autopilot, heading mode, ...)
  • Developed in C++ with no performance impact in your simulator


If you like XMidiCtrl and want to support its further development then you can donate.


Detailed documentation of the plugin and all mapping options can be found here.


If you need support or want to chat about the plugin then please visit the official support forum.


Extract the ZIP file and move its entire XMidiCtrl folder into your ..\X-Plane\Resources\plugins directory.


I have included the following examples as well as overlays to print out in the examples folder:

  • ToLiss A321
  • Hot Start TBM 900
  • Hot Start Challenger 650
  • IXEG 737-300
  • ZIBO 737-800
  • iniBuilds A310
  • Felis Boeing 747-200


I included a template for the Behringer X-Touch Mini in the templates folder of the installation package. This template includes an example mapping and further information about the supported mapping options. I have also included my hardware configuration of the Behringer X-Touch Mini in the same folder. You can apply those settings using the X-Touch Editor from Behringer.

To use the template file, simply copy it into your aircraft folder and start adding commands and/or datarefs for your buttons and encoders.


When a new aircraft is loaded, the plugin will search in the aircraft directory for a file called XMidiCtrl.toml. The profile uses the TOML language and holds information about the MIDI devices to be used and the mappings of the encoders and buttons. Further information about the TOML syntax can be found here. The configuration of XMidiCtrl might be a bit intimidating at the beginning, but it is quite straight forward. Please don't hesitate to contact me if you run into problems.














Edited by VirtualCPT
Release of Version 1.00

What's New in Version 1.00   See changelog


+ Some minor logging improvements
+ Added new mapping type to send init messages once after the aircraft profile has been loaded
+ Added test function when setting up the info window to check the window position immediately
+ Added reset button for info window settings
+ Info window position will be saved correctly now
+ Info window will not block input for other windows
+ Added label to display messages on the screen
+ Added dataref support for Push&Pull mappings
+ Added new parameters send_on / send_off for outbound messages
+ Complete rewrite of the logging
+ Rewrite of settings, profile and messages windows
+ Added example for iniBuilds A310 and Felis B747-200
+ Updated example for ToLiss A321
+ Added support for note, pitch bend and program change midi messages
+ Enhanced mapping for outbound messages (value arrays)
+ Added new mode (momentary) for inbound dataref mappings
+ Improved documentation
+ Fixed mapping problem in ZIBO Boeing 738 example
+ Added new parameters value_min and value_max for encoder dataref mappings
+ Added option to disable the common aircraft profile

  • Like 1
  • Upvote 1

  • Recently Browsing   0 members

    • No registered users viewing this page.
  • Create New...