Difference between revisions of "Supported plug & play MIDI controllers"

From ZynthianWiki
Jump to navigation Jump to search
Line 25: Line 25:
  
 
* Use track buttons to '''perform a function''' on chains. The function is chosen by pressing <code>SHIFT</code> + one of <code>SELECT</code>, <code>MUTE</code> or <code>SOLO</code> scene buttons. Press and hold <code>SHIFT</code> to see current selected function on scene buttons (in green). Functions are:
 
* Use track buttons to '''perform a function''' on chains. The function is chosen by pressing <code>SHIFT</code> + one of <code>SELECT</code>, <code>MUTE</code> or <code>SOLO</code> scene buttons. Press and hold <code>SHIFT</code> to see current selected function on scene buttons (in green). Functions are:
** <code>SELECT</code>, used to change the selected chain. The keybed (black and white keys) will play on that chain.
+
** <code>SELECT</code>, used to change the selected chain. The key bed (black and white keys) will play on that chain.
 
** <code>MUTE</code>, used to mute the corresponding chain.
 
** <code>MUTE</code>, used to mute the corresponding chain.
 
** <code>SOLO</code>, used to enable solo in the corresponding chain.  
 
** <code>SOLO</code>, used to enable solo in the corresponding chain.  
 +
 +
* Use knobs to modify '''chains' volume or balance'''. The value modified is given by current KNOB CTRL selected: <code>VOLUME</code> or <code>PAN</code> (for balance). To change the function, press <code>SHIFT</code> + <code>VOLUME</code> or <code>SHIFT</code> + <code>PAN</code>. The knobs are also affected by current controller's bank.
 +
 +
* Use <code>SHIFT</code> + <code>KNOB k1</code> to change volume or balance for main chain (will change the current KNOB CTRL function).
 +
 +
* '''Toggle audio playback''' with <code>PLAY/PAUSE</code> button. If Zynthian's Alt mode is active, it will '''toggle MIDI playback'''.
 +
 +
* '''Toggle audio record''' with <code>RECORD</code> button. If Zynthian's Alt mode is active, it will '''toggle MIDI recording'''.
 +
 +
* Tap a pad to '''start/stop a sequence'''. The status codes are as follows (pad color will always match the sequence color):
 +
** Dim solid: Stopped sequence without content (no notes in patterns).
 +
** Bright solid: Stopped sequence with content.
 +
** Blinking slow: Playing sequence.
 +
** Blinking fast: Recording sequence.
 +
** Pulsing: Syncing to play/stop.
  
 
====The Device mode====
 
====The Device mode====

Revision as of 20:31, 16 January 2024

Zynthian can be connected to almost any existing MIDI device and you can use the MIDI learning mechanism, as described in the [Zynthian_UI_User_Guide_-_V1/V4|UI user's guide], to assign parameters to faders and knobs in your MIDI controller, for instance. You could also assign pad trigger to notes, etc. But MIDI learning process takes time, it's limiting and you can't get feedback easily. Sometimes it's a lot better to plug a well-known (supported) MIDI controller and get everything mapped automatically. For having this, zynthian implements a controller driver API that allows developers to create specific drivers for specific devices.

This section contain documentation for some of this controller drivers.

Note:

This documentation is valid for the "chain_manager" development branch. It's only partially valid for the current testing branch so you could find some differences.


1 Akai APC Key25 MK2

This device supports two operation modes:

  1. The default mode (called "Mixpad" in this section), which controls the ZynMixer and the ZynPad.
  2. The "Device" mode, which handles the Zynthian UI.

1.1 Key notation

Akai apc key25 mk2.png

1.2 The Mixpad mode

This is the default mode, selected automatically on start. You can also change to it pressing SHIFT + VOLUME or SHIFT + PAN. In this mode you can perform the following actions:

  • Change controllers' bank. There are two banks (1 and 2), which are used to handle up to 16 chains (with the eight track buttons/knobs). Bank 1 is for chains 1 to 8 and bank 2 manage chains 9 to 16. To show current selected bank, press and hold SHIFT, and then one of the track buttons LEFT arrow or RIGHT arrow will light up in red. LEFT arrow is bank 1 and RIGHT arrow is bank 2. You also can press one of these buttons while holding SHIFT to change the bank.
  • Use track buttons to perform a function on chains. The function is chosen by pressing SHIFT + one of SELECT, MUTE or SOLO scene buttons. Press and hold SHIFT to see current selected function on scene buttons (in green). Functions are:
    • SELECT, used to change the selected chain. The key bed (black and white keys) will play on that chain.
    • MUTE, used to mute the corresponding chain.
    • SOLO, used to enable solo in the corresponding chain.
  • Use knobs to modify chains' volume or balance. The value modified is given by current KNOB CTRL selected: VOLUME or PAN (for balance). To change the function, press SHIFT + VOLUME or SHIFT + PAN. The knobs are also affected by current controller's bank.
  • Use SHIFT + KNOB k1 to change volume or balance for main chain (will change the current KNOB CTRL function).
  • Toggle audio playback with PLAY/PAUSE button. If Zynthian's Alt mode is active, it will toggle MIDI playback.
  • Toggle audio record with RECORD button. If Zynthian's Alt mode is active, it will toggle MIDI recording.
  • Tap a pad to start/stop a sequence. The status codes are as follows (pad color will always match the sequence color):
    • Dim solid: Stopped sequence without content (no notes in patterns).
    • Bright solid: Stopped sequence with content.
    • Blinking slow: Playing sequence.
    • Blinking fast: Recording sequence.
    • Pulsing: Syncing to play/stop.

1.3 The Device mode


2 Akai MIDI MIX

2.1 ZynMixer driver


3 Novation LAUNCHPAD MINI MK1

3.1 ZynPad driver

Novation launchpad mini mk1 zynpad.png


4 Novation LAUNCHPAD MINI MK3

4.1 ZynPad driver

Novation launchpad mini mk3 zynpad.png


5 Novation LAUNCHPAD PRO MK2

5.1 ZynPad driver


6 Novation LAUNCHPAD PRO MK3

6.1 ZynPad driver


7 Novation LAUNCHPAD X

7.1 ZynPad driver


8 Novation LAUNCHKEY MINI MK3

8.1 ZynPad driver


9 Behringer MOTÖR 61 / 49


10 Mackie Control