Metagrid 1.7 User Guide
Metagrid 1.7 User Guide
User Guide
www.metasystem.io
Contents
HELLO. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
FIRST STEPS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
MAIN SCREEN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
IMPORT/EXPORT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .24
GESTURES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .30
! -2-
HELLO
Thank you for purchasing Metagrid - a flexible and powerful utility app that enables you to control
your favorite applications on your computer directly from your iPad through WiFi or USB on Mac or
PC. We hope it will find home in your creative environment!
We did our best to make Metagrid as intuitive and user friendly as possible. However, you will need a
few minutes to set it up and get familiar with its concepts and functions. To help you we have created
this manual and comprehensive video tutorials with step-by-step connection and operation instruc-
tions.
Before you start, let’s get familiar with some basic Metagrid terminology:
• Macro: a action or series of actions sent to your computer when you press a Metagrid button
to trigger specific commands in an application on your computer.
• View: the collection of buttons visible on the screen. The number of buttons depend on the
selected grid size for the view.
• Viewset: the collection of all views defined for a specific application on your computer.
• Navigation Bar: the upper section of the screen with various buttons and indicators.
Now, it is time you let Metagrid streamline your workflow! If you have some problems, questions,
feedback or feature requests, don’t hesitate to contact us at [email protected]. You can also join
our user forum where you will find useful tips, support info and custom buttons, views and viewsets
created by the Metasystem team and Metagrid user community.
METAGRID PURCHASE
1 If you haven’t already done it, purchase it from the App Store.
2 METASERVER INSTALLATION
Metagrid needs Metaserver - a small server application - to be installed on your computer to receive
and process keyboard shortcuts and MIDI messages.
1. Go to www.metasystem.io > Downloads and download Metaserver app for Windows or Mac.
2. Copy Metaserver.app/exe to the Applications (Mac)/Program Files folder (PC).
3. Launch Metaserver. You will see icon on the menu bar (Mac)/task bar (PC).
OSX 10.14 and later: you will need to give Metaserver permissions to control your computer. Go to
! System Preferences > Security & Privacy > Accessibility > Privacy and select the checkbox next to
the Metaserver icon.
On some Windows machines you may be asked to install .NET Framework 3.5 to run Metaserver. Pro-
! ceed with the installation.
Some antivirus software may identify Metaserver as a threat. Simply ignore the warning. Sometimes
! antivirus/antimalware software can add Metaserver to the black list and make Metaserver unable to
communicate with Metagrid. Remove Metaserver from the black list to enable Metagrid detect Meta-
server on your Win computer.
! Your computer and your iPad have to be connected to the same WiFi network.
! To connect your iPad to computer though USB connection, just use the Lightning to USB cable. No ad-
ditional setup is needed on Mac. For Windows you need to install Apple iTunes on your machine.
METAGRID SETUP
4
The setup in Metagrid app on your iPad is minimal:
1. Open Metagrid on your iPad.
2. You will see Available Computers screen where you can select a computer with an active
Metaserver instance. If you can’t see any computers, make sure both your computer and your
iPad are connected to the same WiFi network or is connected with the Lightning to USB cable
and swipe down to refresh the computer list.
3. If your computer is still unavailable, tap Add computer... and choose either Manual Setup or
Scan QR Code. Go to Metaserver > Setup... > Network to display the IP addresses for your
computer and the QR code with encoded network information. Enter one of the IP addresses
or scan the QR code. The computer will be added to the list of available computers.
4. Select your computer. Metagrid will display its main screen. In the middle of the navigation bar
you will see the icon of the application that is currently in focus on your computer.
Congratulations! Metagrid on your iPad is now able to send keyboard shortcuts and text to your com-
puter.
i To disconnect, tap the application icon in the center of the Navigation Screen and touch Disconnect.
The Connection screen will appear.
Metaserver can simultaneously connect to up to 4 iPads running Metagrid, which means you can con-
trol you computer from multiple iPads! No additional setup is needed - just connect your additional
iPads per instructions above.
i Metagrid also automatically reconnects to the last known host on WiFi/USB - it remembers the name
of the last connected computer and automatically reconnects on launch or after disconnection.
2 3 2
1
-7- Metagrid 1.7 User Guide
After you have established the connection with your computer, you will see Metagrid’s Main Screen,
which consists of:
Scene Bar
Scene Bar enables to you switch between scenes created for the given application, which in turn dis-
1 plays the view assigned to this scene. For more information on scenes see “SCENE EDITOR” on page
15.
SHIFT buttons
2 Shift Buttons enable you to switch between the primary and secondary view assigned to the current
scene. Both buttons have the same functionality.
OmniSpace button
3 Metagrid now offers a dedicated viewset that doesn’t react to changing app in focus on your comput-
er and can be displayed regardless of the application that is currently in focus on your computer. To
access the OmniSpace viewset, press the OmniSpace button (the second button on the left on the
Scene Bar). OmniSpace is a useful tool to create a universal workspace for system-wide commands
like app switching, opening files or commands that you want to have available in all applications.
Current view
4 The current view depends on scene selection, SHIFT buttons state, OmniSpace button space, and
Back button state on the Navigation bar
i Metagrid reacts to changing the application in focus on your computer and displays the viewset cre-
ated for this application. The Application Lock functionality enables you to prevent Metagrid from
changing the viewsets when you change the application in focus on your computer and control this
application even if it is in the background! You can also enable this functionality by swiping down with
two fingers on the button grid.
1
-10- Metagrid 1.7 User Guide
When you enter the Edit Mode, you will see the buttons wobbling gently and you can access to the
following functions:
Scene Editor
1
To access the Scene Editor press the Edit Scenes... button on the Scene Bar. For more information
on scenes see “SCENE EDITOR” on page 15.
2 View Editor
The View Editor button displays the View Editor that enables you to select and edit views.
To display the drawer, left edge swipe on your iPad screen with the Edit Mode enabled. You can se-
lect the following parameters for selective pasting: Assigned View, Macro, Repeat Action, Text, Col-
or, Icon. When you enable the Macro switch you will see two additional parameters: MIDI Param-
eter + and MIDI Value +. Turning MIDI Parameter + on enables you to increment MIDI parameter,
(for example MIDI CC parameter) for each button covered by your swipe gesture, while MIDI Value +
enables you to increment MIDI parameter value (e.g. velocity) for each button covered by your swipe
gesture.
4 Undo/Redo
Undo/Redo functionality for grid actions like rearranging, selective pasting and button swapping.
Editing buttons
To edit a button, tap the button in the Edit Mode. The Button Editor will appear, where you will be
able to assign button parameters.
i Please note that some buttons may disappear when you exit the Edit Mode. This happens when you
haven’t toggle the visibility status by switching on Hide/Show in the Button Editor or double tapping
a button in the Edit Mode.
! The Default view for each application is created with all buttons hidden.
The View Editor enables you to copy/paste/duplicate/delete/import/export your views using the
buttons in the top section of the screen.
-14- Metagrid 1.7 User Guide
SCENE EDITOR
Editing a scene
To edit a scene:
1. Touch Edit and tap Edit Scenes... on the Scene Bar (it is the last item on the list so you may
need to scroll left to display it). The Scene Editor will appear featuring the list of the available
scenes for the current viewset.
2. Touch a scene and then change its name, icon, color and assigned views.
Deleting/duplicating/creating a scene
Touch one of the corresponding buttons in the top section of the Scene Editor.
Reordering scenes
Long touch one of the scenes in the left section of the Scene Editor and drag it to the new position.
Undo/redo
You can undo/redo your actions like changing order, deletion and changing parameters by pressing
Undo/Redo buttons.
Primary/secondary views
Each scene can have two views assigned. You can switch between primary and secondary view using
SHIFT buttons.
To lock a view:
1. Display the view you want to lock.
2. Long touch the scene button. The lock icon will appear, which means that now this scene but-
ton is temporarily assigned to a subview. This subview will appear instead of the default as-
signed view when you press the scene button again.
3. To unlock the scene, long touch the scene button again. The lock icon will disappear, which
means that the scene button will now display the default assigned view.
1 3
Button Selector
1
Enables you to scroll through the list of all buttons in the current view and select them for editing.
Button Preview
2 Shows the button state corresponding to the current parameter selection choices.
Macro Preview
3
Shows the list of actions assigned to the selected button. Tap this area to display the Macro Editor.
Copy/Paste/Cut/Clear buttons
Use the corresponding buttons in the top section of the Button Editor to copy/paste/cut and clear the
button.
Import/Export buttons
Metagrid enables you to export/import buttons - for more information see “DROPBOX IMPORT/EX-
PORT” on page 24. To import/export a button, press the Import or Export button.
Undo/Redo buttons
You can undo/redo any button-related action using the Undo/Redo buttons.
The Macro Editor enables you to create a sequence of actions (a macro). You can choose from the
following actions:
Keyboard shortcuts
This action sends the user-defined combination of keystrokes to your computer app. You can create
combos combining function keys like Cmd, Option, Ctrl, Shift plus any key available on a standard
computer keyboard with a numeric keypad.
Text
This action sends the user-defined text to your favorite application running on your computer. The
text cannot contain non-English characters.
Pause
For complex macros, you will often need pauses between actions to allow time for performing specif-
ic operations. Pause action enables you to specify time in milliseconds between two actions.
When you press the button with the action queue containing pause actions, a progress bar will ap-
! pear informing you that your iOS device is sending a time-based stream of actions..
MIDI
This action sends a MIDI message to a MIDI-enabled computer application like Cubase, Logic X or
Ableton Live. You can send CC, Program Change and NoteOn and NoteOff messages with customized
parameters (for example Note, Velocity and MIDI channel for Note messages, and CC, Value and MIDI
Channel for CC messages). To enable MIDI actions, you need to configure MIDI port in your target
application. MIDI actions are sent through the Metaserver - MIDI port created on Metaserver launch
on your computer. Make sure your MIDI-enabled application is set to receive MIDI from Metaserver’s
-22- Metagrid 1.7 User Guide
Application-specific actions
Metagrid enables you to add application-specific actions based on predefined commands sets for
Logic X Pro, Cubase/Nuendo, Studio One, Digital Performer, Ableton Live and Dorico. For more in-
formation on setting up your DAW and Metagrid read Metasystem Apps MIDI & DAW Setup Guide
that can be downloaded from here.
UACC actions
These actions enable the user to add a preassigned command that will trigger a specific articulation
in Spitfire Audio’s instruments. The names of the articulations and respective commands are based
on Spitfire Audio’s specs available online.
Adding actions
To add an action, tap the Plus icon in the Button Editor and select one of the action types. The ac-
tion will be added to your macro. To test your macro, press the Play button located in the top section
of the Macro Editor.
Rearranging actions
To rearrange actions, long press an action until is lifted and drag it to the desired position.
Deleting/copying/duplicating actions
To delete an action, swipe right on the action block and press Delete. To copy or duplicate an action,
i swipe right on the action block and choose the respective action.
Pre-requisities:
/Backup
It stores global backup file called Metagrid.mbackup file.
! To restore Metagrid database from backup, touch the Import button in the View Editor and select
Restore Database from Backup.
Restore Database from Backup will overwrite entire database with all viewsets and scenes for all
applications.
/Buttons
It contains .mbutton files created when you export individual buttons from the Button Editor screen.
The file name looks as follows: <APPLICATION>_<button name>.mbutton.
/ViewSets
It contains .mvset files created when you export complete viewsets from the View Editor screen. The
file name looks as follows: <APPLICATION>.mvset
You can share the exported files with other users. To import files received from other users, place the
files in appropriate folders above - they will then appear on the Import screen in Metagrid.
! If you have an exported button, view or viewset created for the application with app-specific com-
mand support in Metagrid and try to import it for the application that doesn’t support these com-
mands, app-specific actions will be REMOVED.
Metagrid enables you to share your custom content through email, messages and Files.
To share a button/view/viewset:
1. Tap Export in the respective editor, tap respective export option and tap Share.
2. Select an app you want to share your content with or tap Save to Files.
Pre-requisites
If some of your Keyboard Maestro macros have been set to trigger only in selected applications,
please add Metaserver to “Available in these applications” list in your macro settings in Keyboard
! Maestro.