User's Manual
Table Of Contents
- 1 Welcome
- 2 Quick Start
- 3 MIDI Setup Guide
- 4 Program Interface
- 5 MIDI Translator Concepts
- 6 The Project
- 7 The Preset
- 8 The Translator Entry
- 9 Actions
- 9.1 MIDI
- 9.2 Keystrokes
- 9.3 Timer
- 9.4 Preset Change
- 9.5 Disable/Enable Processing Actions
- 9.6 Mouse (Outgoing)
- 9.7 Execute File (Outgoing)
- 9.8 Serial Port
- 9.9 AppleScript
- 10 Rules and Variables
- 11 Settings
- 12 Behind the Scenes
- 13 Tips & Tricks
- 14 Usage Example
- 15 MIDI Translator in Hardware: the BomeBox
- 16 Reference
Bome MIDI Translator: User's Manual 9 Actions
The Script will use copies of the variables so any changes to the
variables in AppleScript code will not be reflected back to the
MIDI Translator engine. This is only possible via the
setVariable() handler (see Modifying MT Variables below).
Specifying a Unique Handler Name
You can optionally specify a handler name for the Outgoing AppleScript
action. If you do that make sure to use a unique name: you must not use
the same handler name anywhere else in an Outgoing Action or in the
Project Global AppleScript section.
As a rule of thumb, never set the handler name of an
Outgoing Action unless you want to call it from another
AppleScript section.
Call Outgoing AppleScript from other Outgoing Actions
The AppleScript outgoing action is internally implemented as a handler. For
that you must specify a unique handler name in the Outgoing Action. Now
that handler is also available from other AppleScript actions and from the
global AppleScript section.
Modifying MT Variables
From inside AppleScript code in the Outgoing Action, you can access global
variables directly:
setVariable(<Name>, <value>)
getVariable(<Name>)
For this to work, you must have installed MIDI Translator in the
Applications folder.
Example: increase iTunes volume
-- increase volume, stored in g0
set vol to getVariable("g0")
set vol to vol + 10
setVariable("g0", vol)
tell application id "com.apple.iTunes"
set the sound volume to vol
end tell
display notification "The volume is now: " & (g0 as text)
(c) 2019 by Bome Software GmbH & Co. KG page 62










