MOOMAH Icon

MOOMAH User Guide




1.

About MOOMAH (MIDI->OSC OSC->MIDI Application/Helper) :-

 
 


MOOMAH is a macOS App that allows you to control your OSC-controlled mixer or device (X Air, M Air, X32, M32) using a standard MIDI controller (Korg Nano, Behringer X Touch, Behringer BCF2000).

MOOMAH supports the following MIDI messages: Note on, Note off, Combi Note on/Note off, Control Change, Program Change, System Exclusive.

OSC addresses, and MIDI messages can be entered into MOOMAH either manually (by typing into the appropriate text field) or more easily by using the 'LEARN' feature available in both OSC and MIDI mapping windows.

Handshaking and syncing is available (where supported by MIDI controller).

MOOMAH Main Window (collapsed) :-

MOOMAH Window - collapsed

MOOMAH Main Window (MIDI mapping expanded) :-

MOOMAH Window - MIDI mapping expanded

 

 
  contents  

2.

Installing and using MOOMAH:-

 
 

Download MOOMAH fromthe Mac App Store

Install the Application to your 'Applications' folder (Mac)

Double click the MOOMAH icon to launch MOOMAH ...

MOOMAH Icon

 
  contents  

3.

Overview of the MOOMAH windows:-

 
 


Overview of the MOOMAH main window (collapsed):-

MOOMAH - Collapsed Window Overview

1. MIDI In / OSC Out activity indicators.

2. Connection Status Indicator.

3. IP Address of target X/M Air, X/M32, other OSC device. Click to enter value.

4. MIDI Source table view.

5. Sending to port (Tx Port). Preselected if X/M Air or X/M32 selected in 'Settings'. Otherwise, click to enter value.

6.Receiving from port (Rx Port). Default is 10000. Click to enter value.

7. MIDI Destination table view.

8. MIDI Filter controls.

9. Disclosure button. Click to expand/collapse window.



Overview of the OSC Mapping Window (expanded):-

MOOMAH - OSC Mapping Window (expanded)

1. 'Mode' segmented control. Choose between 'Log', 'OSC Mapping', 'MIDI Mapping', and 'Settings'.

2. 'Sync' Button - initiates sync amongst sync enabled devices.

3. 'Clear this bank' button. Removes stored values from this bank of text fields.

4. OSC Address text field for buttons. Displays stored OSC address for this 'slot'. Click to edit, or press 'Learn'.

5. 'Current Bank' text field. Displays currently selected Bank.

6.' Bank Select ' segmented control. Click to select Bank of Slots (8 Banks of 16 Slots available).

7. 'Learn' Button - Press to enter 'Learn' Mode. Operating a fader or button on the OSC device cause the OSC address to be learnt, and entered into the OSC Address text field.

8. OSC Button control - mimics the button corresponding to this slot on the OSC device.

9. 'Clear All' Button - clears the entire contents of all slots.

10. OSC Fader control - mimics the fader corresponding to this slot on the OSC device.

11. OSC Address text field for faders. Displays stored OSC address for this 'slot'. Click to edit, or press 'Learn'.

12. 'Load' and 'Save' buttons. Store and retrieve setups to and from disk.

13. 'Recent File' text field - displays file most recently saved or loaded.


Overview of the MIDI Mapping Window (expanded):-

MOOMAH MIDI Mapping Window (expanded)

1. 'Mode' segmented control. Choose between 'Log', 'OSC Mapping', 'MIDI Mapping', and 'Settings'.

2. 'Sync' Button - initiates sync amongst sync enabled devices.

3. 'Clear this bank' button. Removes stored values from this bank of text fields.

4. MIDI control message text field for buttons. Displays stored MIDI control message for this 'slot'. Click to edit, or press 'Learn'.

5. 'Current Bank' text field. Displays currently selected Bank.

6.' Bank Select ' segmented control. Click to select Bank of Slots (8 Banks of 16 Slots available).

7. 'Learn' Button - Press to enter 'Learn' Mode. Operating a fader or button on the MIDI controller cause the MIDI message from the controller to be learnt, and entered into the MIDI control message text field.

8. MIDI Button control - mimics the button corresponding to this slot on the MIDI Controller.

9. 'Clear All' Button - clears the entire contents of all slots.

10. MIDI Fader control - mimics the fader corresponding to this slot on the MIDI controller.

11. MIDI control message text field for faders. Displays stored MIDI messagefor this 'slot'. Click to edit, or press 'Learn'.

12. 'Load' and 'Save' buttons. Store and retrieve setups to and from disk.

13. 'Recent File' text field - displays file most recently saved or loaded.


Overview of the Settings Window (expanded):-

MOOMAH - Settings Window (expanded)

1. Set the MIDI thinning factor for faders with this control.

2. With 'Merge' selected, MOOMAH does not differentiate between 'Note on' and 'Note off'

3. Sets the Appearance of the App title bar.

4. OSC Device selector - choose between X/M Air, X/M32, or 'other' device.


Overview of the Log Window (expanded):-

MOOMAH - Log Window (expanded)

1. Log window text area - displays messages about MOOMAH status.

2. Clears the MOOMAH status log.

3. Starts or stops translation, usually prior to a port or IP address change.

 

 

 
  contents  

4.

Getting Started with MOOMAH

If one of the presets included with the App fits the bill for your setup, feel free to use that as a starting point, and edit it and re-save it once you're happy.

Otherwise, the easiest way to get started is by using the 'Learn' buttons. Make sure you are connected properly to all your devices, then:-

In the 'OSC Mapping' page, press the 'learn' button on the first slot you wish to program. Then operate the control on the OSC device that you wish to learn (NB separate banks for 'buttons' and 'faders'). The OSC address of the control you operated will appear in the corresponding 'slot' text field.

In the 'MIDI Mapping' page, press the 'learn' button on the same slot that you programmed the OSC for.. Then operate the control on the MIDI Controllerthat you wish to learn (NB separate banks for 'buttons' and 'faders'). The MIDI control message of the control you operated will appear in the corresponding 'slot' text field. The message is prepended with the type of message received. Some devices use 'Note on' for button 'on' and 'Note off' for button 'off'. In this case set the 'Merge' control in 'Settings' to 'Merge MIDI Note on/Note off'. This setting will be remembered when you next save your setup file.

Setup files are plain text files, and can be edited in your favourite text App (Text Edit by default).


contents

 


© 2019: John Milner for StrongSoft Limited

Last U/D 14/08/2019

strongsoftlogosmall.png