About

This repo is a modified device control for LaunchKey Mini Mk3 to be used with PreSonus Studio One. This is heavily borrowed from the PreSonus ATOM controller and resembles many of the actions and controls that ATOM offers. The development of this code is not affiliated with PreSonus or Novation and had be crafted during my own spare time. A lot of the process was through trial and error while referencing other devices code and guessing/assuming what does what. There is no official documentation from PreSonus for an api; or at least publicly available. There is also little to no community support or effort with this kind of development so a lot of functions from this code relies heavily on hackable workarounds yet I had tried to keep it as simple and clean as possible.

(Changed the include references to use Studio One v5 SDK so this would load in v6. Without this, it would crash V6 and throw errors.)

Legend

Symbol	Meaning
	Any table following this will execute such commands / actions while the shift button is being held down
	Any table following this will execute such commands / actions while the scene button is being held down. The scene button will pulse green to indicate that the scene modifier is active

Installation

Clone this repo and place files into [studio one path]/devices/Novation/Launchkey MK3. Next open StudioOne and open options then ensure external devices is selected.

Click add and add the following

Basic mode

Selecting the standard Midi Port for LaunchKey MK3 Basic allows for the use of the touch controls as separate functions depending on channel selected. You will have to use different channels to those defined below if you wish to use the pitch or modulation with your instruments.

Channel	Touch Control	Command
15	Modulation	Master Fader
15	Pitch	Move transport Cursor left or right
16	Pitch	Navigate next or previous event
16	Modulation	Navigate up or down (swipe down will navigate up and vise-versa)
16	Pitch Double Tap	Deselect All

Channel	Touch Control	Command
16	Pitch	Extend selected events left or right
16	Modulation	Extend track selection

Channel	Touch Control	Command
16	Pitch	Zoom Horizontal
16	Modulation	Zoom Vertical

Extended Mode

Selecting Midi Port 2 (Both In and Out) for LaunchKey Mini MK3 Extended will give advanced controls for the DAW. Using ARP mode will act as normal as this is internally controlled. Holding ARP and using the corresponding knobs will also act natively. Fixed Chord, Octave and Transpose controls are also natively controlled.

Global Commands

Button	Action
	Toggles between play and stop
	Toggle Recording

Button	Action
	Toggles Loop (the button will light 50% if loop is enabled)
	Toggles Track Arm & Monitor for selected track (the button will light 50% if the selected track is armed)
	If loop is enabled then return time cursor to loop start otherwise set cursor to zero

Button	Action
	Activates Loop Edit Mode see Loop Editor
	Undo
	Toggles window from Editor to Console to Transport Panel

Extended Device Modes

Holding down shift will light up the pads to a mode selection (this is a native LaunchKey control). Selecting a different mode allows for different controls. The three pad modes are Session, Drum and Custom. Custom mode is set using the Novation component software.

The Session mode has separate scenes that's mostly relative to a session sense. Session Mode Scenes consists of Edit, Setup, Bank Menu and HUI.

The Drum mode is more geared towards playing an instrument. The pads will light up differently depending on the instrument and event type etc.

Drum Mode

Drum mode acts as a standard drum pad. Like the ATOM controller, drum mode will represent the pad colors to those on Impact XT.

Button	Action
	Toggle Note Repeat (the button will light blue when activated)
	Toggle Full Velocity on the pads (the button will pulse purple if activated)

Button	Action
	Changes the pad lighting mode (the button will light up reflecting the lighting mode; Off, Dimmed and Bright)

Note Repeat (Active) scene button will light blue to notify if active

Knob	Note Repeat Action
1	Rate
3	Gate

With Note Repeat active and holding down the scene button shows the following toggles

Pad	On Color	Off Color	Action
7			Quantize
8			Aftertouch

Custom Mode

Use Novation's component software to assign your own custom midi controls to this mode

Session Mode

Session mode consists of 4 different scenes. Each scene consists of different controls that's relevant for the scene. Each scene mode lights up a color on the scene button that corresponds to the scene selected.

To change scenes, simply press the scene button except for Loop Edit which is activated by pressing scene + play buttons together.

---

Edit Scene

This scene will display a mode relevant to the capabilities of the selected track or clip. When this scene is active then the editor view will automatically display and focus.

1. Step edit mode will act as a step sequencer. The pads will color to the key track color while making on values and accent values a different variation to said color. Holding down Scene then selecting a pad will place an accent for that step. This mode will automatically show when the selected event or track is a pattern event

2. Keyboard mode changes the pad's to emulate a keyboard.

3. Standard edit mode will give generic commands on pads 7, 8, 11 and 16

Pad	Color	Command
7		Velocity Increase
8		Velocity Decrease
11		Duplicate
16		Delete

Button	Action
	Toggle Show Instrument For Selected track

In step edit mode, holding down the scene button will add accents to the pad steps

Tip: If using basic device then change the channel to 16 (shift + transpose + pad 16) which will allow you to change the selected sequence by using the touch modulation (as long as the editor window is focused).

---

Loop Editor

Loop editor is activated by holding scene + play. The change scene button will skip this scene to simplify navigating modes and to provide an efficient flow. This scene can be activated from any device mode or session scene.

Pad	Color	Command
1		Zoom To Loop Selection
2		Toggle Loop Follows Selection
7		Shift Loop Selection Left
8		Shift Loop Selection Right
9		Set Loop Start
10		Transport Cursor Back
15		Transport Cursor Forward
16		Set Loop End

Due to the lack of documentations for any api for studio one, I'm unable to find a good way to get host variables like the Toggle Follows Selection etc. If I can find a solution then I'll be able to change the pad lighting depending on the value

---

Setup Scene

Setup scene gives generic setup commands. User assignable commands can be assigned to the top row pads. Open the device assignment view and right click the pads to assign a command. You can then click the pad and assign it a color.

Pad	On Color	Off Color	Command
9			Tap Tempo
11			Duplicate
13			Metronome
14			Metronome Pre-Record
16			Delete

Pot / Knob Controls

Device pot control needs to be either Device, Volume, Pan or Send. Custom uses Basic port which doesn't register for Extended Mode.

Knob	Value Type	Action
1	Absolute	Change Tempo

---

Bank Scene

Bank scene allows selection of a specific bank for selected devices. Banks are color coded from pad 1-8

---

HUI Scene

HUI scene is like a mixer console. Triggering SSM will change the lower toggle rows for the columned track to be either Monitor, Record Arm, Solo or Mute. A lighter color on the lower pad means the toggle is off for that track while a darker color is toggled on. The pads and knobs are organised in columns and each column is assigned to a track bank. This scene will automatically display the console view when active.

Color	Toggle
	Monitor
	Record Arm
	Solo
	Mute

The upper row allows for track selection which also is colored based on the track color. If the track for that bank is selected then the pad will pulse.

Pot / Knob Controls

Changing the device pot mode to either volume, pan or sends will set the knobs to that mode for the track column bank. Sends has a sub toggle that allows controlling the level of send 1 or 2 for the bank track.

Track Bank Scrolling and Bank Selection

Holding down the scene button will change the lower pads to scroll bank mode with the far right being scroll right and far left being scroll left.

Color	Action
	Step Scroll
	Page Scroll

The lower center pads will have blue toggles which are bank switches and will switch banks as follows

Pad	Bank
3	All
4	Audio Only
5	Bus Only
6	User / Remote