OverviewBome MIDI Translator Pro is a popular MIDI and keystroke mapping tool: use it for controlling arbitrary software by way of MIDI and keystrokes. Its rich feature set also allows it to be used for general Windows automation.
With Bome MIDI Translator Pro you can control your computer from MIDI or other devices. For example: you can control your favorite software with a MIDI control surface, use MIDI turntables with arbitrary DJ software, map MIDI messages to other MIDI messages, and much more.
You can create your own mappings by defining the translations, or use one of the many pre-existing translation presets. We are constantly working on new presets, and the active community continually expands the available pool of presets.
MIDI Translator Pro works by specifying mappings for different input and output types. Below is a list of different trigger types (Incoming) and action types (Outgoing). You can combine them as you wish (e.g. do keystroke-to-MIDI conversion, or MIDI-to-mouse mapping).
Incoming ActionsMIDI messages
keystrokes
timer
enable/disable the current preset
opening a project file
bytes or text on a serial port
Processing ("Rules")
A sequence of rules can be defined to be processed if the incoming action matches:
assignments of variables, e.g. pp = 20
simple expressions, e.g. pp = og + 128
labels and goto, e.g. goto "2nd Options"
conditional execution, e.g. IF pp < 20 THEN do not execute Outgoing Action
Outgoing ActionsMIDI messages
keystrokes
mouse movements
create/start/stop timer
change active preset
enable/disable the current preset
execute program
send bytes or text to serial ports
execute AppleScript (macOS only)
Version 1.8.4
New Features
Multi-monitor support for mouse emulation: target specific display number, or the global “virtual” desktop
Mix&Match Modifiers: modifier keys like shift/control/command now also work globally on macOS. You can mix & match emulated modifiers with “physical” keystrokes and mouse buttons (that has already worked on Windows)
MPE Support: new dedicated MIDI message type: MPE Configuration Message
HUI Ping message: new dedicated MIDI message type: HUI Ping
Raw MIDI action: now you can format it in a multi-line edit field
Preset Comments: enter arbitrary comments in every preset
Windows: Hi-DPI support for mouse emulation
RawMIDI to SimpleMIDI converter in MIDI menu: use it to convert your entire project. It converts single messages with up to 3 bytes.
Automatic Virtual Ports: when loading a project, detect virtual ports used in the project and offer to adjust the number of installed virtual ports as needed. New option in settings dialog.
MacOS 10.15 Catalina support (build 962)
Bug fixes
fixed: loading a project with square brackets [ or ] in filename causes problems
fixed: -multiinstance parameter was ignored when given as first parameter
fixed: crash when using % in certain names
fixed: problem when loading preset change action when preset name has a space at the end of the name
fixed: focus jump when a field inside an edit section was focused, or when switching between simple and raw MIDI
fixed: when renaming a preset in editor panel, it’ll be renamed to “(unnamed)” when removing all letters
fixed: under certain conditions, creating an action from scratch (AppleScript, SerialPort) might not work
fixed: edit preset name, then add a translator via T+ button: the new translator should now be focused and in “edit name” mode in the translator list, but it’s not.
fixed: change (N)RPN reception logic: allow both LSB first or MSB first. Do not reset on reception of MSB Param.
fixed: cannot re-use MIDI capture selection when translator changes
fixed: MIDI lists are not immediately updated when device state changes
fixed: adding a MIDI alias by typing into the alias list text field will add it, but clear the text field afterwards.
fixed: crash when executing an malformed outgoing raw MIDI message like “F0 h1 0h F7”
fixed: when checking a project/preset/translator MIDI port, the current selection in the MIDI port list is cleared
fixed: when renaming a serial port alias with SerialMIDI port, the corresponding MIDI port is not renamed
fixed: macOS: cannot use Num1 for Keystroke Input
fixed: selecting a special key in keystroke action will not update translator list
fixed: Outgoing Keystroke log text in Log Window does not say which keystroke is emulated
fixed: macOS: capturing mouse position yields wrong values for y coordinate
fixed: AppleScript does not work when using Unicode letters (umlauts) in AppleScript code
fixed: erroneous error message “ignored tag: Script” when loading a project with AppleScript (this was just a cosmetic bug)
fixed: in Rules, cannot use value -2147483648
fixed: Windows installer: all virtual MIDI ports are reset to one misnamed virtual port
fixed: Windows installer: URL’s are not shown (.url shortcut does not always work on Windows 10)
fixed: Order of auto-aliases Bome Virtual Port X is synchronized with order of underlying virtual ports (build 962)
Minor Changes
AppleScript action: include description in log message in Log Window
AppleScript action: hide handler name in an advanced section, plus warning text
MIDI port lists: non-existing ports are displayed in gray
MIDI port lists: edit aliases on double-click (in previous versions that was: open/close port)
MIDI ports and serial ports are strictly only opened when in use by project, closed otherwise. No way anymore to manually open/close ports
display disabled checkboxes and radiobuttons in gray
double click in MIDI Capture list to close capture
enable undo/redo in AppleScript text editor
Enhanced macOS installer: double-click the MIDI Translator Pro icon in the DMG window. Detect fresh install / upgrade / re-install / downgrade and prompt for sensible actions.
using the mouse wheel on a closed drop down will scroll the underlying panel
replace old virtual MIDI port names (from MIDI Translator Pro 1.7.2 or older) during loading
when MT is minimized to tray, and another instance is started, show the main screen
when a device can be opened and a “pending” error message was shown earlier, show a message that the device became available now
Windows installer: don’t allow installation on Windows XP
by default, main window will not minimize to tray / menubar icon (but to task bar / dock)
macOS 10.13 and later: if the project is simulating keystrokes or mouse, show an error message if MT Pro is not selected for Assistive Device Access
macOS: minimum required version is now 10.7
new layout for preset change action
no more instructions texts in Simple MIDI panels
trial version: added button “enter license key” to the demo splash screen, and a corresponding menu item. When clicked, it merely instructs the user to download and install the full version.
updated look of timer action panels
improved look&feel on HiDPI / retina screens
