Midi Translator Reference

Rules and Variables

Help Contents

Help Contents

Terminology
Keyboard Shortcuts
Command Line Switches

Menu System Reference

• Project: A Project is a collection of Presets, grouped by a set of common attributes such as MIDI in/out/thru settings, appearance settings, and other common application-wide attributes.
• Preset: [ref:presets] A Preset is a collection of Translators. There are individually named Presets, which may be switched and activated separately, as well as an '[always active]' preset, which is perpetually active.
• Translator: [ref:translators] A Translator is an individual "rule" defining the translation of a single 'Incoming Action' event through to a single 'Outgoing Action' event.
• Name: The Name refers to the unique name given to an individual Translator.
• Incoming Trigger: [ref:translators:incoming] An Incoming Trigger event is an event that causes an associated Translator to start. Incoming Trigger events can be one of the following:
  • MIDI message [ref:translators:incoming:midi]
  • Keystroke [ref:translators:incoming:keys]
  • Timer [ref:translators:incoming:timer]
  • Preset Change [ref:translators:incoming:preset]
  • Special [ref:translators:incoming:special]
• Outgoing Action: [ref:translators:outgoing] An Outgoing Action event is an event associated with a translator that has been activated. Bomes MIDI Translator will generate an Outgoing Action event depending on the Trasnalator Rules, and if certain criteria are met. An Outgoing Action event may be one of the following:
  • None [ref:translators:outgoing:none]
  • MIDI message [ref:translators:outgoing:midi]
  • Key Stroke Emulation [ref:translators:outgoing:keys]
  • Mouse [ref:translators:outgoing:mouse]
  • Timer [ref:translators:outgoing:timer]
  • Preset Change [ref:translators:outgoing:preset]
  • Special [ref:translators:outgoing:special]
  • WM_Messages [ref:translators:outgoing:wm]
• Timer: A Timer is an internal function of Bome's MIDI Translator that will generate repeated Incoming Triggers depending on the Timer properties.
• Options: [ref:translators:options] The options available to change the behavior of a Translator object. Options pertaining to a Translator event are comprised of the following:
  • Name [ref:translators:options:name]
  • Active [ref:translators:options:active]
  • Stop Processing [ref:translators:options:stop]

Global:

Shift+Esc: MIDI Panic - Stops all MIDI information immediately
Ctrl-O: Open Project - Opens an existing MIDI Translator project file
Ctrl-S: Save Project - Saves current project, prompting for a name if first save
Ctrl-F12: Save Project As... - Saves current project as a new file name
Ctrl-F4: Close Project - Closes current project, prompting for save if applicable
Ctrl+E: Show Edit Window - Shows the Translator edit window

Preset/Translator Interface:

Del: Delete currently selected object
F2: Rename currently selected object
Ctrl+A: Select All objects in active viewing area
Ctrl+D: Duplicate selected object
Ctrl+Up/Ctrl+Down: move selected object up/down in list view

Translator Interface only:

Ctrl+C: Copy Translator to clipboard
Ctrl+V: Paste Translator from clipboard
Ctrl+X: Cut Translator to clipboard

Edit Translator Window:

Ctrl+N: Move to next Translator in preset
Ctrl+P: Move to previous Translator in preset
Ctrl+A: Apply edits to Translator
Ctrl+R: Revert edits to state prior to editing
Alt+C: Midi Capture (for MIDI as Incoming or Outgoing Action)
Ctrl+PageDown: Cycle to next tab
Ctrl+PageUp: Cycle to previous tab
F5: Jump directly to the General tab
F6: Jump directly to the Edit Incoming Action
F7: Jump directly to the Edit Rules (Pro+ version)
F8: Jump directly to the Edit Outgoing Action

/debug: debugging output through OutputDebugString
/nosilent: more debugging output
/nodebug /silent: reverse the meaning

/settings <filename>: load .bmts file instead of loading settings from registry.

/project <filename>: load .bmtp file at startup
/midiin <MIDI dev>: select the named MIDI device on startup for input
/midiout <MIDI dev>: select the named MIDI device on startup for output

/autostart: add MT Player to hidden autostart group
/noautostart: remove from hidden autostart

• File
• Open: Open Project - Opens an existing MIDI Translator project file
• Save: Save Project - Saves current project, prompting for a name if first save
• Save As: Save Project As... - Saves current project as a new file name
• Close: Close Project - Closes current project, prompting for save if applicable
• Import Settings: Import previously exported program settings file
• Export Settings: Export program settings to text file for transfer or archive
• Exit: Exit Bomes MIDI Translator, prompting for save if applicable
• MIDI In
• None: Select no MIDI device port for input into Bomes MIDI Translator
• Variable: Displays list of available MIDI ports to map into Bomes MIDI Translator. Only one may be selected
• MIDI Out
• None: Select no MIDI device port for translation output
• Variable: Displays list of available MIDI ports to map out of Bomes MIDI Translator. Only one may be selected
• Preset
• New: Create a new preset in currently open program template
• Rename: Rename currently selected preset
• Delete: Delete currently selected preset
• Duplicate: Create an identical copy of currently selected preset
• Edit "Always Active" Preset: Create an 'always active' preset that will be available despite preset deactivation rules
• Save As Text File: Save currently selected preset as text file for transfer or archive
• Translator
• Add: Add new blank translator to currently active preset
• Edit: Edit currently selected translator
• Rename: Rename currently selected translator
• Duplicate: Create an identical copy of currently selected translator in current preset
• Activate: Enable currently selected translator to process incoming and outgoing events
• Deactivate: Disable currently selected translator from process incoming and outgoing events
• Move
• Up: Move currently selected translator up one entry in preset list
• Down: Move currently selected translator down one entry in preset list
• Top: Move currently selected translator to top of preset list
• Bottom: Move currently selected translator to bottom of preset list
• Cut: Remove currently selected translator and place in program clipboard
• Copy: Copy currently selected translator to program clipboard
• Paste: Create a new translator identical to translator previously 'cut' or 'copied' to program clipboard
• Delete: Remove currently selected translator from preset
• Options
• MIDI Thru: Pass all unprocessed MIDI signals from the selected MIDI input to the MIDI output uneffected
• Enable Active Sensing: Pass MIDI Active Sensing information, allowing MIDI panic modes, etc
• Enable MIDI Time Code: Pass MIDI MTC clock signals from the selected MIDI input to the MIDI output uneffected
• Appearance
• Show Event Monitor: Show program event monitor in display [ref:interface:monitor]
• Show Tray Icon: Show program tray icon in Windows system tray
• Animate Tray Icon:Show activity lights in program system tray icon
• Minimize To Tray:Minimize program to system tray icon rather than standard program
• Friendly Descriptions: Show standard MIDI channel and CC numbers instead of HEX code
• Settings
• Supress outgoing keystroke when active: Do not transmit keystroke messages when activated
• Ignore keystroke as Incoming Action when active: Do not recognize keystroke input when activated
• Confirm program exit: Display warning message before allowing Bomes MIDI Translator to close
• Startup
• Start Minimized: Start program minimized by default
• Autostart with Windows: Start program automatically when Windows starts
• Show Splash Screen: Show Bomes MIDI Translator splash screen when program starts
• Log Window: Show program log windows, which displays detailed information about incoming and outgoing actions, as well as letting you display all global system variables
• Help
• Purchase Midi Translator: Open web browser page detailing purchasing information
• Other products at bome.com: Open web browser page showing other products from Bome.com
• About: Show program license, version and copyright information

Rules and Variables

Help Contents

Help Contents