====== Chapter 18: MIDI Designer on Mac ======

Beginning with macOS 11 (macOS Big Sur), MIDI Designer will run on Apple Silicon (M1 or higher).  This brings all the functionality of MD to your laptop or desktop computer.

===== Loading on Mac =====

<WRAP center round tip 80%>
MIDI Designer is an iOS app, even when used on the Mac. You must select the //iPhone & iPad// apps tab in the Mac App store, not the //Mac Apps// tab.  See image below.
</WRAP>

==== Option 1 ====


Open the Mac App Store, enter MIDI Designer Pro 2 in the search bar.  The search should return this screen:

{{manual:mdp2_mac_app_store.png?600|}}
 
Select the MDP2 icon to load or purchase.

==== Option 2 ====

If you already own the iOS version, in the Mac app store, click at the lower left on your user name, click on //iPhone & iPad Apps//, scroll down in your apps until you see MDP2, click on the cloud icon to download.


<WRAP center round important 80%>
If you previously purchased MDP2 for the iPad or iPhone, you must be signed in to the same Apple ID to access the prior iPadOS or iOS app purchase to use on your Mac.</WRAP>


===== 2.3200 =====

Version 2.3200 adds access to the Mac file system with traditional Mac FILE commands:

{{ manual:mac_menu.png?400 |}} 


The //MORE → CONFIG// Save and New actions have been removed.  Use the File menu to save existing layouts and create new layouts.  //MORE → CONFIG → LOAD// and //Delete// are still available to access files that remain in the sandbox, but you cannot save back to the sandbox location.

{{ manual:mac_new_config_menu.png?400 |}}

<WRAP center round tip 80%>
Starting with 2.320, you will use the Mac user file directory, allowing you to organize your MDP2 layouts in logical folders within the user directory structure.</WRAP>

You can open a ''.mididesigner'' or ''.mididesignerpage'' file by double clicking on the name (or ⌘ + O) in the Mac file manager.

//Copy Sandbox Folder Path to Clipboard// provides a link to the hidden folder used for autosave, config and other temporary files. To to view this folder, copy the link, open //File Manager,// select GO → GO TO FOLDER, paste the path ⌘+v, and press ENTER.  If you often access this location, create a //Finder// shortcut.

Prior to 2.3200, user files were stored in the Sandbox folder.  If you used an early Mac release, for easier access, move any named layouts or pages from the sandbox to a user folder. **Note**: do not move files with ''backup'', ''autosave'', ''config'', or ''hints'' in the filename.

{{ manual:finder_go.png?400 |}}

//Loading and Saving Pages// \\
- Page save will open the Mac file save dialog to allow saving the ''.mididesignerpage'' file anywhere in the file system \\
- Page Load only points to the sandbox file location.  As a workaround, use //Finder// to load ''.mididesignerpage'' files.


<WRAP center round info 80%>
If you are a Beta tester, you will have separate sandboxes for both MD Next and MIDI Designer.  Ensure you check both locations to relocate your layouts to your user folders.
</WRAP>

===== 2.3300 =====

  * The Mac window is now dynamically resizable.  Layout size follows the overall window horizontal size.  No more small layouts in big black windows.
  * iPad MORE vs Apple Mult-tasking (...) menu workaround is removed
  * MIDI Designer again generates a virtual MIDI interface, simplifying connection to other apps.  The virtual connections are switched on & off in the //MORE / CONFIG / CONNECTIONS // menu.




===== Permissions =====

MIDI Designer needs permissions to access Bluetooth (for MIDI connections) and Photos (to import images).  These settings are in //System Preferences → Security and Privacy//.

{{ manual:mac_bluetooth.png?400 |}}

{{ manual:mac_photos.png?400 |}}


===== Connections =====

When connecting via cable from an iPad to the Mac, the iPad must first be enabled in the //Audio Devices// before the MIDI connections are available to configure in //MIDI Studio.//

{{ :manual:audio_midi_setup.png?direct&400 |}}

===== Screen Zoom =====

The display has continuous zoom.  Display size is set by the horizontal size.

Display may not resize with third-party screen size utilities.  Tap on a border after using the utility, and MD should jump to correct zoom.
===== Multi-touch =====

The Mac trackpad does not normally provide multi-touch to MDP2.  

As a work around, turn on //Touch Alternative// in the MIDI DESIGNER →  PREFERENCES menu.  The trackpad becomes a virtual touch screen while the //Option// key - ⌥ - is pressed.  

{{ manual:mac_touch_alternatives.png?400 |}}

It takes a little practice to align track pad presses with the screen.

//Multi-Touch// is required to access pedal boards in //Play// mode and for horizontal scroll in //Image Manager//

Pedal boards can be accessed in //Design// mode with a single-touch action.

==== No Track Pad or Magic Mouse ====

//Multi-Touch// can assist if you do not have a touch pad or Apple Magic Mouse and need to swipe.

With //Multi-Touch// enabled, the arrow keys start a swipe from screen middle.  You need to reposition the swipe target in the middle of the screen.  With practice, you can swipe to delete subcontrols, open pedal boards, and other actions that require swipe action.

{{ :manual:mac_touch_alternatives_-_swipe.png?direct&400 |}}
 
<WRAP center round important 80%>
//Multi-Touch// can interfere with other trackpad actions, such as copying Log text or using hamburgers to rearrange menu items.  In this case, turn off Touch Alternatives for those actions.
</WRAP>

===== Future =====

Future releases may provide more Mac usability, such as ⌘ + V, C X (cut, copy and paste), mouse multi-select for move, and others.