MidiWrist Logo MidiWrist Documentation

Control synths from your Watch

Quickstart

MidiWrist turns your Watch into a MIDI controller that can interact with any CoreMIDI connection that is available on your iPhone.

The MidiWrist MIDI panel on the iPhone allows you to select specific MIDI destinations. MidiWrist also creates a Virtual MIDI source 'MidiWrist' that allows you to directly interact with any synthesizer app on your iPhone.

If you don't have a synthesizer app available, AudioKit Synth One is a great open-source synth that you can download freely.

Once Synth One is installed, launch it by tapping its icon, press the Hold button and tap on a key on the keyboard to hear an arpeggio playing.

SynthOne Start

Launch MidiWrist on your Apple Watch and tap on any of the two top-most circles to activate them as virtual knobs. When you turn your Watch's digital crown, you'll see the Frequency knob or the Rez knob on SynthOne rotate.

Tip: Sometimes WiFi networks can introduce delays, disabling WiFi on your phone or your Watch to have a direct Bluetooth connection, can improve performance.

MidiWrist Icon MidiWrist Watch Start

From here onwards you can enable or disable any knob by tapping on them, or double tap a specific knob to only activate that specific one.



Reference Manual

You can find all the details about the MidiWrist app here.

Configure Your Apple Watch

In order for MidiWrist to be the most predicable and comfortable to use, there are a few Apple Watch settings that we recommend.

Connectivity

Sometimes WiFi networks can be slow or introduce delays. If you experience laggy MidiWrist behavior, disabling WiFi on your Watch will force it to connect to your phone over Bluetooth instead, which can feel more immediate.

Watch Connectivity Config

Wake Behavior

To be able to make immediate tweaks, even when a long time has passed, the following General > Wake Screen settings are a good idea to activate.

Watch Wake Config 1 Watch Wake Config 2 Watch Wake Config 3 Watch Wake Config 4 Watch Wake Config 5

Haptics

Haptic feedback makes your Watch vibrate when you interact with MidiWrist, this can be useful to make tweaks without looking or to get additional sensory confirmation of your intentions.

The following Sound & Haptics settings are a good idea to activate.

Watch Haptics Config 1 Watch Haptics Config 2 Watch Haptics Config 3

Siri

Siri allows voice control over certain MIDI commands.

Siri can be activated by long-pressing the Digital Crown, and the following settings allow you to access it hands-free:

Watch Siri Config 1 Watch Siri Config 2 Watch Siri Config 3 Watch Siri Config 4

Siri support on iPhone, iPod Touch and iPad

MidiWrist's Siri support isn't limited to the Apple Watch. All the Siri Shortcuts also work directly on other iOS devices. This opens up hands-free voice control even when you don't own an Apple Watch or want to use this on other devices.

The follow settings are recommended when you want to use MidiWrist Siri without an Apple Watch:

Note that Siri activation with "Hey Siri" might not work on the same device that is running the audio app that you want to control, due to the audio device being used for other purposes. You can still use your iOS device as a MIDI controller for other devices or your computer DAW for instance.

Phone Config Siri

Controllers Panel

The Controllers panel allows you to configure how your MidiWrist Watch controllers behave, and also allows you to monitor their behavior.

The five sections Transport, Programs, Knobs, Buttons and XY correspond to the five pages of your MidiWrist Watch app. By swiping left or right on the Watch app, you can switch between the different pages.

Tapping any of the rows in these sections in the iPhone app, allows you configure which MIDI messages should be generated by MidiWrist for each control.

Controllers Panel 1 Controllers Panel 2

Transport

Watch Transport Panel The Transport Watch panel has four icons, from top-left to bottom-right these are: Rewind, Record, Stop and Play.

When you press any of the transport buttons, the MidiWrist iPhone app will briefly display the command it received.

For example:

Transport Feedback 1 Transport Feedback 2

To be able to control your DAW with these buttons, you have to set your DAW up to accept MIDI Machine Control (MMC) or Mackie Control Universal (MCU) input over the destination MIDI ports that MidiWrist using (see the MIDI section of the iPhone app).

Selecting which protocol is used, can be done through the Transport controller configuration panel.

Transport Config 1 Transport Config 2

Siri Support

All the transport commands can be triggered through Siri Shortcuts, providing you with hands-free voice control when using the "Hey Siri" feature.

Each Siri Shortcut has to individually be configured for your voice.

Tapping the Add to Siri button next each transport command, guides you through the standard iOS procedure to set up the phrase you want to use. MidiWrist will suggest an appropriate phrase, but you can record anything you want.

Once Siri is setup on your iPhone, your Apple Watch and any other devices that are tied to the same Apple account, will automatically understand the same shortcuts.

Siri Configuration 1 Siri Configuration 2

MIDI Machine Control (MMC)

Setting MMC up is different for each DAW, in Logic Pro X for instance, it needs to be configured both in the global preferences and the project settings, while in Reaper it's just a single preference in the MIDI settings.

The screen shots below show you how to do this for some popular DAWs.

Apple Logic Pro X 10.4
Logic MMC Config 1 Logic MMC Config 2
Cubase Pro 10
Cubase MMC Config 1 Cubase MMC Config 2
Pro Tools 2018
Pro Tools MMC Config 1 Pro Tools MMC Config 2
Harrison Mixbus32C 5
Mixbus MMC Config 1 Mixbus MMC Config 2
Cockos Reaper 5
Reaper MMC Config

Mackie Control Universal (MCU)

Watch Transport Panel The MCU protocol allows for additional capabilities that can be accessed through the Transport Force Touch menu.

These capabilities are Save, Undo, toggle Cycle and toggle Click and rely upon each DAW's individual support for these functions.

Setting MCU up is also different for each DAW, the screen shots below show some popular examples.

Apple Logic Pro X 10.4
Logic MCU Config 1 Logic MCU Config 2

Logic MCU Config 3

Logic MCU Config 4
Cubase Pro 10
Cubase MCU Config 1

Cubase MCU Config 2

Cubase MCU Config 3
Ableton Live 9
Live MCU Config
Harrison Mixbus32C 5
Mixbus MCU Config 1

Mixbus MCU Config 2
Cockos Reaper 5
Reaper MCU Config 1

Reaper MCU Config 2
Korg Gadget

MCU sometimes takes longer to configure, but it has the advantage of being just a series of MIDI note messages that are being sent out.

This allows hosts that don't explicitly support MCU to still be controllable through MIDI remapping techniques.

Below, the Midiflow iOS app with the Controller Remapping IAP, converts the MCU Notes to MIDI CCs so that Korg Gadget can learn these actions in its Transport settings section.

You can download this Midiflow preset here.

Gadget MCU Config 1 Gadget MCU Config 2 Gadget MCU Config 3

Programs

Watch Transport Panel The Programs Watch panel allows you to send MIDI program change messages, either by pressing the - and the + buttons, or by rotating the digital crown.

Tapping the program number will resend the current program.

The value of the program change that was transmitted will appear in the Controllers panel on your phone.

For example:

Programs Feedback 1 Programs Feedback 2

Tapping this row in the MidiWrist iPhone app, allows you to configure which MIDI channel the program change message will be sent out on.

You can change the channel number by using the - and + buttons, or tap the number to change it with a numeric keyboard.

Programs Config 1 Programs Config 2

Alternatively, you can press the Learn button, which will listen for MIDI program change messages on the enabled MIDI sources. The channel of the first program change message that was received will be automatically configured.

Programs Config Learn

Knobs

Watch Knobs Panel The Knobs Watch panel allows you to use the digital crown to turn up to four virtual knobs that send CC messages. Tap a knob to enable or disable it, double-tap it to only enable that knob.

Watch Knobs MenuBy using a Force Touch, a menu appears that allows you to reset all the knobs to zero, or to link them together in their current positions. By linking them, the knobs will respect their respective offsets even when they've moved to the extremes.

When you turn any of the knobs, the MidiWrist iPhone app will display the last value that was transmitted.

For example:

Knobs Feedback 1 Knobs Feedback 2

Tapping one of the rows in the Knobs section in the MidiWrist iPhone app, allows you to configure that knob in detail.

You can change the Channel and CC Number by using the - and + buttons, or tap one of the numbers to change it with a numeric keyboard.

The Minimum and Maximum values that the knob can be set at can also be changed, allowing you to focus on the control range that is most appropriate for your needs.

Knobs Config 1 Knobs Config 2

Alternatively, you can press the Learn button, which will listen for MIDI CC messages on the enabled MIDI sources. The Channel and CC Number of the first CC message that was received will be automatically configured.

Knobs Config Learn

If you want a label to be displayed for this knob on the Watch panel, you can provide it as the first option in this section. Please note that there's very little space available and longer words will be cut off. By disabling the Display MIDI Values option in the Settings, more space will be available for the label.

The color of the knob can be selected in the color picker, and a Reset button underneath allows you to revert it back to its standard color.

Knobs Config Color

Buttons

Watch Buttons Panel The Buttons Watch panel provides four buttons that can either be stateful or momentary. When the button is stateful, tapping it will toggle between CC value 0 (off) and 127 (on). When the button is momentary, it will automatically turn back off after 100ms.

Watch Buttons MenuBy using a Force Touch, a menu appears that allows you to reset all the buttons to their off state.

When you tap any of the buttons, the MidiWrist iPhone app will display the last value that was transmitted.

For example:

Buttons Buttons 1 Buttons Buttons 2

Tapping one of the rows in the Buttons section in the MidiWrist iPhone app, allows you to configure that button in detail.

You can change the Channel and CC Number by using the - and + buttons, or tap one of the numbers to change it with a numeric keyboard.

Enable the Momentary option to make this button turn automatically back off 100ms after it was pressed.

The Minimum and Maximum values that the button can be set at can also be changed.

Buttons Config 1 Buttons Config 2

Alternatively, you can press the Learn button, which will listen for MIDI CC messages on the enabled MIDI sources. The Channel and CC Number of the first CC message that was received will be automatically configured.

Buttons Config Learn

Each button can be triggered through a Siri Shortcut, providing you with hands-free voice control when using the "Hey Siri" feature.

Tapping the Add to Siri button, guides you through the standard iOS procedure to set up the phrase you want to use. MidiWrist will suggest an appropriate phrase, but you can record anything you want.

Once Siri is setup on your iPhone, your Apple Watch and any other devices that are tied to the same Apple account, will automatically understand the same shortcuts.

Siri Configuration 3 Siri Configuration 4

If you want a label to be displayed for this button on the Watch panel, you can provide it as the first option in this section. Please note that there's very little space available and longer words will be cut off. By disabling the Display MIDI Values option in the Settings, more space will be available for the label.

The color of the button can be selected in the color picker, and a Reset button underneath allows you to revert it back to its standard color.

Buttons Config Color

XY

Watch XY Panel The XY Watch panel provides a two-dimensional pad where different CC numbers can be used for the X and the Y axis. By dragging your finger over the XY pad, you change the position of the dot and the values that correspond to it.

Watch XY MenuBy using a Force Touch, a menu appears that allows you to reset the dot to the pad's origin or to the maximum top-right position.

When you change the position of the dot, the MidiWrist iPhone app will display the last X and Y values that were transmitted.

For example:

XY Feedback 1 XY Feedback 2

Tapping one of the rows in the XY section in the MidiWrist iPhone app, allows you to configure that axis in detail.

You can change the Channel and CC Number by using the - and + buttons, or tap one of the numbers to change it with a numeric keyboard.

The Minimum and Maximum values of each axis can also be changed, allowing you to focus on the control range that is most appropriate for your needs.

XY Config 1 XY Config 2

Alternatively, you can press the Learn button, which will listen for MIDI CC messages on the enabled MIDI sources. The Channel and CC Number of the first CC message that was received will be automatically configured.

XY Config Learn

Presets Panel

The Presets panel allows you to save and load all the Controllers configurations, the enabled MIDI ports and the Settings. This allows you to fine-tune your needs for specific scenarios and to easily recall them later.

The top toolbar provides New, Save and Save As buttons.

Once a preset is saved, it will appear in the list below, and tapping it will load its settings.

By swiping to the left on a preset, a Share button appears that allows you to share this preset with other people or to save it outside the app. The Delete button that appears, allows you to remove the preset from the list.

Presets Panel 1 Presets Panel 2

MIDI Panel

The MIDI panel allows you to configure which MIDI destinations MidiWrist will send its messages to, and also which MIDI sources it will listen to.

When messages are received from MIDI sources that correspond to the configured CC messages, they will automatically change the state of the appropriate Controllers. This is very convenient for MIDI devices that broadcast the state of their presets over MIDI, since your virtual knobs will be exactly where they should be.

MIDI Panel 1 MIDI Panel 2

Before being able to connect to Bluetooth LE MIDI devices, you need to either first setup a Bluetooth MIDI Central or Peripheral. The Central finds and connects to other devices, while the Peripheral advertises MidiWrist as an available Bluetooth LE MIDI device. Once either is configured, the corresponding MIDI ports will appear. Don't forget to enable them if you want to use them.


Settings Panel

The Settings panel provides configurable options for the MidiWrist Watch app.

Settings Panel 1 Settings Panel 2