Jump to content

XMidiCtrl - A MIDI Controller Plugin for X-Plane


Recommended Posts

XMidiCtrl - A MIDI Controller Plugin for X-Plane

View 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+ and supports Microsoft Windows and Linux. macOS support will be added with the next version - looking for some testers since I don't own a Mac.

The following devices are officially supported:

  • Behringer X Touch Mini

Other MIDI devices should work, as long as they send MIDI Control Change (CC) messages.

XMidiCtrl is open source: GitHub page

 

Features

  • 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

 

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

 

Logging
XMidiCtrl does not log directly into Log.txt of X-Plane. Instead, it's using an own log file called XMidiCtrl_log.txt. It's located in your X-Plane base folder.

 

Templates
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 Config Tool from Behringer.

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

 

Usage
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.

 

Examples
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

 

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

 

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

XMidiCtrl_about.png

XMidiCtrl_devices.png

XMidiCtrl_documentation.png

XMidiCtrl_profile.png

XMidiCtrl_settings.png

X-Touch_Mini_CL650.png


 

Link to post
Share on other sites

Join the conversation

You can post now and register later. If you have an account, sign in now to post with your account.

Guest
Reply to this topic...

×   Pasted as rich text.   Paste as plain text instead

  Only 75 emoji are allowed.

×   Your link has been automatically embedded.   Display as a link instead

×   Your previous content has been restored.   Clear editor

×   You cannot paste images directly. Upload or insert images from URL.

Loading...
  • Recently Browsing   0 members

    No registered users viewing this page.

×
×
  • Create New...