Help Center

Lightkey sends feedback to any connected MIDI controller so it can reflect the current software state through LEDs or motorized knobs, faders etc. Beyond that, some MIDI controllers can display multiple states with different colors.

Currently Lightkey supports this extended feedback for the following controllers:

MIDI controller	Feedback type
Akai APC mini	dual-color feedback
Akai APC20	dual-color feedback
Akai APC40	dual-color feedback
Akai APC40 mkII	multi-color feedback
Novation Launchpad	dual-color feedback
Novation Launchpad Mini	dual-color feedback
Novation Launchpad Mini MK3	RGB color feedback
Novation Launchpad MK2	RGB color feedback
Novation Launchpad Pro	RGB color feedback

You can set up the push buttons on a Behringer BCF2000 MIDI controller so their LED reflects the current state of the binding. For example, the LED is on when the corresponding cue is active, and off otherwise.

Program the push button (Edit button) with the following options:

• MIDI data type: CC (Control Change)
• On value: 127
• Off value: 0
• Controller mode: Toggle on

For more information see the Behringer BCF2000 User Guide.

The faders on a Behringer BCF2000 MIDI controller can send high-resolution 14-bit values to Lightkey. In this case the faders provide a range of 16384 steps as opposed to 128 steps for standard resolution.

Program the fader (Edit button) with the following options:

• MIDI data type: CC (Control Change)
• Min. value: 0
• Max. value: 16383
• Controller mode: Absolute 14-bit (“A 14”)

For more information see the Behringer BCF2000 User Guide.

To enable feedback LEDs on the Akai LPD8 controller, do the following:

• Activate the Pad button at the lower left. This makes the pads send Note On/Off messages.
• In the software editor, make sure the pads are set to “Momentary” (the default option).

To enable the feedback LEDs on Native Instruments controllers, some additional setup may be necessary in Lightkey’s DMX Output preferences:

1. Choose Lightkey > Preferences… and then click External Control.

2. Locate the output to your controller in the list and make sure it is enabled.

   

3. Control-click the input from your controller, select Send Feedback To, and then select the controller’s output.

   

Elgato Stream Deck is a popular USB controller which lets you perform various kinds of actions through a grid of freely assignable keys. You can use Stream Deck to trigger cues and other actions in Lightkey by means of either OSC or MIDI messages.

Using OSC Messages

OSC (Open Sound Control) is a quick and convenient way to trigger actions in Lightkey. You need a Stream Deck plug-in for sending OSC messages; simply search the Stream Deck Store for “OSC”. Follow these steps to toggle a cue from Stream Deck:

1. Install a Stream Deck plug-in which enables the sending of OSC messages.

2. In Lightkey, control-click a cue in the Live view and choose External Control > Copy OSC Address from the menu.

3. In the Stream Deck app, drag the OSC action from the actions list to a key.

4. Configure the action as follows:

   • Use 127.0.0.1 as the destination address. This corresponds to your Mac.

   • Set the destination port to 21600.

   • In the address field, paste the OSC address from the clipboard. Then replace the word “activate” with “toggle”. The result should look like this:

       /live/My_Control_Panel/cue/My_Cue_Name/toggle

   • The action’s value controls the fade time of the cue. For example, a value of 1 results in a 1 second fade.

5. Press the key on your Stream Deck. Each press should now toggle the cue’s state.

Many other elements in Lightkey have an OSC address—for example, the Blind Mode and Freeze buttons in the toolbar. You can find more information and the complete OSC dictionary in the Lightkey User Guide.

Using MIDI Messages

When you use MIDI (Musical Instrument Digital Interface), you bind a MIDI message (trigger) to a particular action, such as activating a cue. Lightkey can send MIDI feedback so the key on the Stream Deck will always reflect the cue’s state.

You need a Stream Deck plug-in for sending MIDI messages; simply search the Stream Deck Store for “MIDI”. Here’s how to toggle a cue from Stream Deck, including feedback when the cue changes in Lightkey:

1. Install a Stream Deck plug-in which enables the sending of MIDI messages.
2. In the Stream Deck app, drag the MIDI action from the actions list to a key. If there are multiple actions, use “Note On/Off”.
3. Configure the action as follows:
   • The action should send MIDI to “Lightkey Input” and receive MIDI from “Lightkey Output”.
   • If necessary, set the message type to “Note On/Off”. The action should send a “Note On” message when the key is pressed and “Note Off” when it’s released.
   • Select a MIDI channel in the range 1 to 15. Do not use channel 16.
   • Select a unique MIDI note.
   • You can ignore the options for velocity.
4. Change the image or title for the key’s “on” state to indicate the cue is active.
5. In Lightkey, control-click a cue in the Live view and choose External Control > Add Trigger…
6. Press the key on Stream Deck. Lightkey should capture the incoming MIDI trigger.
7. Press the key on your Stream Deck again. Each press should toggle the cue’s state, which is also reflected by the key’s image or title.

Like with OSC, you can trigger many more actions in Lightkey through MIDI. You can view and edit all assigned MIDI triggers in the External Control window. For more information refer to the Lightkey User Guide.

It’s easy to receive MIDI commands in Lightkey from other apps on the same Mac, e.g. Ableton Live or ProPresenter. If the sending app is on another computer, you need to route the MIDI commands over a local network. This is done with the app Audio MIDI Setup that comes with every Mac.

Note: If you use Live Triggers, Lightkey and Ableton Live must be on the same Mac while you create your projects. This is necessary so Lightkey can add clips to the Ableton Live library. But after everything has been set up you can run the show from separate computers.

On the computer running Lightkey:

1. Open Audio MIDI Setup and choose Window > Show MIDI Studio.

2. Choose MIDI Studio > Open MIDI Network Setup… to open the MIDI Network Setup window.

3. Click “+” in the My Sessions section. This creates a “session” which other computers can connect to.

4. On the right side of the window, change the local name and Bonjour name of the session. The Bonjour name will be visible to other computers.

5. Make sure the Enabled checkbox is selected.

6. Select “Anyone” in the menu “Who may connect to me”.

   

7. To verify that Lightkey is connected to the session, open Lightkey’s Preferences window, click External Control, and check if the network session is selected under Input.

   

On the computer running Ableton Live or another software:

1. Repeat the above steps to create a session in Audio MIDI Setup.

2. In the Directory section, select the session you first created on the destination computer.

3. Click Connect. The two computers are now connected so MIDI can be transmitted between them.

   

4. In the software which you want to use to send MIDI, select the network session as destination. In Ableton Live this is done in the Preferences window > Link/MIDI.

The Consolidate feature in Ableton Live can be used to merge multiple clips into one. This is particularly useful when you want to transfer a clip to Session view.

You can use this command with Live Triggers, but only for cues on the same Live page.