Native Instruments Traktor Kontrol S4 MK3

The Kontrol S4 MK3 is a 4 deck all-in-one controller with a sturdy build quality and integrated sound card. Compared to the MK2 and MK1, it also have motorised shiny aluminum jogwheels, screens and a set of pads which can be use for various features.

The S4 MK3 uses the standard HID protocol for the Buttons, Knobs, Faders and LEDs, and extends it for the motorized Jog-Wheels. The screens use a USB Bulk transfer. Mixxx doesn’t support rendering content for external screens yet. The easiest way to tell the MK3 apart from the other MK1 and 2 are these screens, displace between the “Move” and “Loop” encoder.

Unlike its predecessor, the Kontrol S4 Mk3 cannot run from USB power and the separate power supply must be used.

New in version 2.4.

Changed in version 2.6.0: Added support for screens

Changed in version 2.6.0: Added beatjump

Changed in version 2.6.0: Added stems

Compatibility

The Kontrol S4 MK3 is a USB class compliant audio and HID, so it is compatible with Mixxx without any proprietary drivers on GNU/Linux, MacOS and Windows.

With the S4 plugged in, a HID device is listed as an available controller in Mixxx’s Preferences. The controller uses HID for each components on the device, except the screens, so the mapping can only be loaded when you select the HID device on the left side of Mixxx’s Preferences.

Controller

Setup audio output

Using the S4 mixer

In order to use the audio output of the controller, select the device Traktor Kontrol S4 MK3. Channels 1 - 2 should be set as Main and Channels 3 - 4 should be set as Headphones

Using the software mixer

If you don’t want to use certain outputs of the device, you can enable the mapping of the mixer knob to the Mixxx internal mixer. Head over to the Mapping options to enable these optional mappings.

Note

The mixer knobs are physically linked to the S4 embedded mixer. This means that there is no way to prevent these buttons to adjust gains of the output, and will lead to unexpected volume mixing if the Mixxx mixer is used while also using S4 outputs.

Known bugs and limitation

Audio

During the development phase, it appears that using other Sound API than ALSA would lead the Master VU meter not to work. Furthermore, audio output power would be half as loud as it should be, which can be a problem if you are also using other software, since you audio setting will suddenly become twice as loud. It remains unclear whether or not this was a common issue or if this was specific to the used setup.

Screens

The controller screens are supported, but they require a little bit of tinkering. Due to the legacy controller engine, the screen are driven by a separate mapping, which will have to be set independently of the controller mapping.

Note

The screens rendering is done using QML and the communication is achieved via BULK USB endpoint. Both of these feature are not available out of the box on Windows and Mac for now.

By default, the screens are standalone, meaning they do not interact with the device states. This means that local state such as deck selection or shifting will not trigger any screen interaction, and thus you should expect only Deck A and B to be displayed on these screen by default, although this can be changed in the controller settings.

Note

it exists an API that was temporary parked that allows mappings to communicate. If you want, you may download <https://github.com/acolombier/mixxx/actions/runs/13751974244?pr=10> or build a version of Mixxx with this feature <https://github.com/acolombier/mixxx/pull/10> and it should automatically work on the controller.

Motors

Haptic feedback (know as Haptic Drive (TM)) are partially implemented. Supported features include jogwheel tensions and turntable mode but these features remains in beta and may sometime have unexpected behaviours. Since there is no guarantee on the long term effect to the controller of how Mixxx implements these features, they are disabled by default. You can enable them by setting UseMotors to true in Mapping options.

Mapping Description

Jogwheel modes

Jogwheel can be used to control various things, depending of the mode they are in.

  1. Vinyl mode (default): The jogwheel platter can be used for scratch. The jogwheel crown can be used to jog up or down the playback.

  2. Jog mode: The wheel platter and crown can be used to jog up or down the playback.

  3. Turntable mode: The wheel behaves as a 33.3 RPM turntable. If the platter or crown are slowed down or speeded up, then it will scratch down or up the track.

    Warning

    Because this mode relies on Mixxx’s scratch mode, if the track has been pitched up, the keylock will be ignored!

    Note

    This mode is only available if the motor features are enabled. See Motors for more details.

  4. Loop in: The wheel behaves similarly to CDJ. If the platter or crown are turned, it will move back or forth the start of the loop. Additionally, if the loop encoder is used, it will move the all loop back or forth.

  5. Loop out: Like for the loop in mode, but with the exit position of the loop. If the platter or crown are turned, it will move back or forth the end of the loop. Additionally, if the loop encoder is used in the same way than Loop in mode.

Here is how to tell what mode is on, depending the current state of the LED:

Mode

Jog

TT

Jogwheel

Others

Vinyl mode

On

Off

Circling while the track is playing/scratching

–

Jog mode

Off

Off

Circling while the track is playing/scratching

–

Turntable mode

Off

On

Circling while the track is playing/scratching

–

Loop in

–

–

The whole circle is blinking

The REV button is blinking

Loop out

–

–

The whole circle is blinking

The FLX button is blinking

Here is how to select each mode:

Mode

Vinyl mode

Press the Jog button (while the Jog button is off)

Jog mode

Press the Jog button while in vinyl mode (while the Jog button is on)

Turntable mode

Press the TT button. Pressing again while restore the Vinyl mode

Loop in

Press SHIFT + REV while a loop is enable

Loop out

Press SHIFT + FLX while a loop is enable

For all modes but Vinyl and Jog, re-selecting the mode will restore the previous one.

Move modes

Moves modes define how the “move” encoder (the one on the left) reacts when used. Here are all the various modes:

  1. Beat (default): The track will jump backward or forward by the number of beats selected. Press before turning to select the number of beats.

  2. Grid: The track’s detected beats will be move forward or backward on the waveform.

  3. BPM: The track’s detected BPM will be increased or decreased.

  4. Keyboard: The keyboard’s keys displayed on pads get moved up or down to display higher or lower keynotes.

  5. Hotcue color: When selecting a hotcue, the move encoder can be used to change the selected color.

    Note

    When using the shared data API, this will display hotcue metadata such as label (if any), timecode and type.

Here is how to tell use each modes:

Mode

Beat

This mode is enable if no other mode are enabled

Grid

This mode is enabled while GRID is held down

BPM

This mode is enabled while SHIFT + GRID are held down

Keyboard

This mode is enabled while STEM is held down

Hotcue color

This mode is enabled while HOTCUE is held down

All mapping detail

Button

Action

Lighting

Jogwheel platter

  • Scratch when in Vinyl mode and Turntable mode

  • Jog when in Jog mode

  • Move loop start when in Loop In mode

  • Move loop end when in Loop Out mode

  • Static light rotation: Vinyl, Turntable or Jog mode on

  • Ring blinking: Loop in or out mode on

Jogwheel crown

  • Jog when in Vinyl mode

  • Same as wheel platter otherwise

Flux

  • Toggle Slip mode

  • On shift, set a loop end at the current track position if no active loop, enable loop out wheel mode otherwise

  • Steady on: Reverse enabled

  • Steady on while pressing SHIFT: loop is active

  • Blinking, but flux steady off while pressing SHIFT: loop in set wheel mode

  • Blinking, with flux steady on while pressing SHIFT: loop in wheel mode active

Reverse

  • Toggle reverse mode

  • On shift, set a loop in the current track position if no active loop, enable loop out wheel mode otherwise

  • Steady on: Flux enabled

  • Steady on while pressing SHIFT: loop is active

  • Blinking, with reverse steady on while pressing SHIFT: loop out wheel mode active

Grid

  • Set the beatgrid at the current track position (on release, short press)

  • Enable grid move mode while pressed

  • Enable BPM move mode while pressed and pressing SHIFT

  • On when over a detected beat

  • Blinking when grid/BPM move is on

  • Blinking when grid move mode is enabled enabled

Turntable

  • Toggle on or off the turntable mode

  • On: Turntable mode on, otherwise jog or vinyl

Jog

  • Toggle on or off the vinyl mode

  • On: Vinyl mode on, otherwise jog or turntable

Deck Select

  • Select a deck

  • The deck’s main color will be the one of the selected deck

Shift

Shift controls for the all controller side, including effect unit

  • On or Off

Cue

  • Trigger the cue default effect

  • Start or stop the track while pressing SHIFT

  • Select the cue as the play mode when in Keyboard move mode

Depends of the cue mode

Play/Pause

  • Play/Pause the track

  • Long press: clone the playing track

  • SHIFT + Long press: eject track

On if track is playing

Move

  • Beat jump forward (right) or backward by the number of selected beats

  • Increase/Decrease the beats if turned while pressed

  • Increase/decrease pitch when pressing SHIFT

  • Move backward/forward the grid when in grid move mode

  • Increase/decrease BPM when in BPM move mode

  • Move down/up the keyboard notes when in keyboard move mode

Loop

  • Enable/disable loop when pressed

  • Reactivate exited loop/exit loop when pressed and shifted

  • Halve/double the loop size

  • Move 1 beat backward/forward when shifted

  • On loop in/out wheel mode: move the loop with precision, left precision if shifted

Master

  • Make the current deck sync leader (on release)

  • Long press: Enabled/disable full range tempo fader

  • Steady on: the deck is sync leader

  • Blinking: the tempo fader is in full range

Sync

  • Toggle the sync mode (on release)

  • Toggle the keylock (on release)

  • Long press: copy the BPM of the other deck

  • SHIFT + Long press: copy the key of the other deck

  • On while no shift: Sync is on

  • On while shift: Keylock is on

Tempo fader

While change the tempo only of the left indicator is either off or of the color of the deck.

  • If green, it means the fader is out of sync with the software, bringing it down will eventually catch up.

  • If white, it means the fader is out of sync with the software, bringing it up will eventually catch up.

Deck color: default track speed Green: out of sync (down) Green: out of sync (up)

Hotcues

  • Toggle the hotcues page

  • Shift: toggle the second hotcue page

  • Deck color with dim off: Current page isn’t related to hotcue

  • Deck color with dim on: page 1 of hotcue

  • White: page 2 of hotcue

Rec

  • Toggle the beatjump page and display jump option as defined in settings

Sampler

  • Toggle the sampler page and display samplers on the Using

  • Off: Current page isn’t related to sampler

  • On: sampler page is active

Mute

Currently unused

Stems

  • Toggle the stem page

  • Shift: toggle the keyboard (on release) while press: enable keyboard move mode

  • Deck color with dim off: Current page isn’t related to keyboard

  • Deck color with dim on: Stem page or Keyboard is active

  • Green: keyboard play mode active

Pads

  • While in hotcue:

    • press will activate

    • if preview deck is playing the loaded track (using with SHIFT) press will activate in preview deck

    • SHIFT + press will delete (hotcue)

  • While in beatjump:

    • press will activate a jump forward of 1, 2, 4, 8, 16, 32, 64 or the currently select beatjump size, or custom size if you have changed BeatJumpSize in Mapping options

    • SHIFT + press will perform the same jump backward

  • While in sample:

    • press will play (load selected track if none are)

    • SHIFT + press will stop (if playing) or eject

  • While in stem:

    • the top row can be used to select a stem for further actions (FX assignation, FX dry/run, volume or pre-mixed load)

    • the bottom row can be used for mute control

    Note

    when selecting a stem with the shared data API feature, the screen will display metadata about the selected stem such as name, color and current dry/run and select FX as well as volume

  • While in keyboard:

    • will set the key to the selected note

    • will play from the cue if in keyboard play mode

  • While in beatloop roll mode:

  • Will activate a beatloop roll of 1/16, 1/8, 1/4 , 1/2, 1, 2, 4 and 8 beats, or custom size if you have changed BeatLoopRolls in Mapping options

  • In hotcue: color of the cue. Blinking in delete (shift) mode

  • In beatjump: Green is defined jump, red is current jump value and white is selection edition

  • In Sampler: Dim on, sample is playing dim off sampler is stopped, off no sampler loaded

  • In keyboard: keyboard color on each note, if Dim on, currently active note

  • In Beatloop roll: brighter means a loop roll is active with the given size

FX 1st knob

  • Master volume/mix of the unit

FX 2nd knob

  • Meta arg of the first selected effect

  • First arg of the focused effect in effect focus mode

FX 3rd knob

  • Meta arg of the second selected effect

  • Second arg of the focused effect in effect focus mode

FX 4th knob

  • Meta arg of the third selected effect

  • Third arg of the focused effect in effect focus mode

FX 1st button

  • Trigger all effect

  • Trigger all effect

  • Assign/de-assign effect to master while pressing SHIFT and no focused effect

  • Exit focused mode while pressing SHIFT and focused effect

  • On if all effect are off and not pressing SHIFT

  • On when effect is attached to master and pressing SHIFT

  • Blinking in effect focused mode

  • Blinking in effect focused mode

FX 2nd button

  • Toggle (short press) or trigger (long press) third effect if not focused effect or if pressing SHIFT

  • Toggle first arg (short press) or trigger first arg (long press) of the focus effect if any

  • Switch to next effect available if no focus effect and SHIFT

  • On if effect is active and no focused effect or if pressing SHIFT

  • On if focused effect parameter is enable

FX 3rd button

  • Toggle (short press) or trigger (long press) third effect if not focused effect or if pressing SHIFT

  • Toggle second arg (short press) or trigger second arg (long press) of the focus effect if any

  • Switch to next effect available if no focus effect and SHIFT

  • On if effect is active and no focused effect or if pressing SHIFT

  • On if focused effect parameter is enable

FX 4th button

  • Toggle (short press) or trigger (long press) third effect if not focused effect or if pressing SHIFT

  • Toggle (short press) or trigger (long press) third arg on the focus effect if any

  • Switch to next effect available if no focus effect and SHIFT

  • On if effect is active and no focused effect or if pressing SHIFT

  • On if focused effect parameter is enable

Library knob

  • Move up/down in tracklist

  • Move up/down in tree structure while shifted

  • Move up/down in the context menu if playlist button is pressed

  • Zoom in/out the waveform when in grid move mode

  • Beatjump by 16 beats backward/forward if a track is being previewed using the button

  • Star down/up the currently playing track while pressing the star button

  • Sort by next/previous column while pressing the view button

  • Expand the context-manu item when pressed while pressing the playlist button

  • Load track when pressed or expand/collapse tree node when shifted (if view button is not pressed)

  • Inverse the column sorting if view button is pressed

Preview button

Preview the currently selected track while pressed Shift: Preview the currently playing track

Star button

Change the selected track color on short press (next color, or previous if shifted)

Playlist button

Open or close a context menu for the currently selected track

On if there is a context-menu open, off otherwise

Mixer FX button

Toggle third effect (short press) or trigger third effect (long press) or assign the quick effect of FX select buttons are pressed

  • Dim on if the effect is active

FX Select button

Apply effect to all deck on release, if no mixer FX button have been pressed

Ext

Apply the current gain as default. This will reset the gain knob.

Master

If enabled in the Mapping options, change the main gain

Booth

If enabled in the Mapping options, change the booth gain

Cue

If enabled in the Mapping options, adjust the headphone mix

Headphone volume

If using Mixxx internal mixer, change the headphone gain

Looping

Control

Description

Right Encoder (turn)

Double/halve loop size.

Right Encoder (press)

Activate/exit loop of set size from current position

SHIFT + REV (while no loops are enabled)

Set the loop in point. This will reset the loop out point as well.

SHIFT + REV (while a loop is enabled)

Toggle the loop in jogwheel mode. See Jogwheel modes for more details.

SHIFT + FLX (while no loops are enabled)

Set the loop out point.

SHIFT + FLX (while a loop is enabled)

Toggle the loop out jogwheel mode. See Jogwheel modes for more details.

Mapping options

There are various option that can be used to change some behavior:

Setting

Default

Description

Deck colors

red, blue, yellow, purple

Define the leading colors for each decks. Note that some buttons have only one color

Sortable column in the library

Artist, Title, BPM, Key, DatetimeAdded

Define the list of columns on which it possible to sort the library using the library encoder and the view button

Loop In/Out jogwheel sensitivity

50

Define the sensitivity when moving the loop start or end point using the loop jogwheel mode. Negative value will reverse the order

Loop encoder sensitivity

500

Define the sensitivity when moving the loop with the encoder when using the loop jogwheel mode. Negative value will reverse the order

Loop encoder sensitivity (Shifted)

2500

Define the sensitivity when moving the loop with SHIFT + the encoder when using the loop jogwheel mode. Negative value will reverse the order

Color of the tempo led when on low takeover

white

Define the color of tempo LED when the tempo fader is out of sync, and the actual value is less than on the controller

Color of the tempo led when on high takeover

green

Define the color of tempo LED when the tempo fader is out of sync, and the actual value is more than on the controller

Keep transport and play button dimmed when off

true

Having this setting on will keep LED always dimmed, even when off, although they may not have a matching color with the deck’s color

Keep the unselected deck button off rather than show its deck color

true

Having this setting on will keep the LED of the unselected deck dimmed instead of off.

Keylock on SHIFT + MASTER instead of SHIFT + SYNC

false

Use SHIFT + MASTER to toggle the keylock instead of SHIFT + SYNC

Make the grid button blink when over a detected beat

false

Make the GRID button blinking when the playback goes over a detected beat

Make the jogwheel ring blink when the track playing is near the end

true

The jogwheel LED ring will start blinking when a track is near the end. The end section can be defined in Preferences ‣ Waveforms ‣ End of track warning

Use the mixer to control input when using SHIFT

false

Make the GRID button blinking when the playback goes over a detected beat

Number of samples used for jogwheel speed

3

Number of samples used to determine the jogwheel movement. A higher value will increase precision but latency too, and vice-versa

Replace the sampler tab by a beatloop roll tab

false

Replace the sample tab as well of the sample feature with 8 beatloop roll

Define the predefined size to use for the beatjump tab

1,2,4,8,16,32,64,beatjump

Define the size of beatjumps of each pad, from left to right, starting from the top row. “beatjump” refers the currently selected value (beatjump_forward or beatjump_backward), “half” and “double” can be used to control this value

Define the predefined size to use for the beatloop tab

1/16,1/8,1/4,1/2,1,2,4,8

Define the size of loops of each pad, from left to right, starting from the top row.

Use the two last tab as loop half/double buttons in the beatloop tab

true

Use the last two pad from the bottom row as loop half and loop double. These can be used to interact with beatloop roll and normal loop.

Jogwheel speed (in turntable mode, as well as LED indicator)

33 + 1/3

The turntable mode defines how fast the jogwheel turns (if on) as well as the LED, and the overall jogwheel sensitivity. It is recommended to keep either 33 + 1/3 or 45 as a value

Whether or not to use haptic feedback features

false

Whether or not to use haptic feedback features. This is a beta feature, some of them may be unstable.

Map the mixer :hwlabel`Master` knob to the Mixxx internal mixer

false

When enabled, the Master knob will drive the Main gain of the Mixxx internal mixer as well as the hardware built-in mixer in the device.

Map the mixer :hwlabel`Booth` knob to the Mixxx internal mixer

false

When enabled, the Booth knob will drive the Booth gain of the Mixxx internal mixer as well as the hardware built-in mixer in the device.

Map the mixer headphone knobs :hwlabel`VOL` and :hwlabel`MIX` to the Mixxx internal mixer

false

When enabled, the headphone knobs will drive the headphone controls of the Mixxx internal mixer as well as the hardware built-in mixer in the device.

Default Pad Layout

default

Define the default layout used for the pads.

This settings are only useful if you are using haptic feedback features

Setting

Default

Description

Number of samples used for jogwheel speed in turntable mode

20

Number of samples used to determine the jogwheel movement when the turntable is on. A higher value will increase precision but latency too, and vice-versa

Define the tension of the jogwheel

0.5

Define the jogwheel tension. 0 makes it very tight while 1 makes it very loose

Define how much force can the jogwheel use

25000

Define how much resistance can the wheel use when its rotation is held

Changing settings

Mixxx 2.4

Making these changes is still a little awkward, this will be much easier to do starting in Mixxx 2.5. For now you’ll have to make a small change to the mapping script file. Don’t worry, the actual edit only involves replacing a single word in a text file.

  1. Open Mixxx Preferences and select the Kontrol S4 in the side list.

  2. Select Traktor-Kontrol-S4-MK3-hid-scripts.js.

  3. Click Open Selected File.

  4. Either the file should open in an editor, or you should see a file browser window with that file selected. If you see a file browser, right click the file and select an option to edit it.

  5. Starting from the block entitled USER CONFIGURABLE SETTINGS, there should be configurable options.

Mixxx 2.5+

Settings can be edited in the preference windows, under Preferences > Controllers > Traktor Kontrol S4 MK3 ….