Controller Assignments

Engine uses /usr/Engine/AssignmentFiles/PresetAssignmentFiles/[HARDWARE_ID]/[HARDWARE_ID]_*.qml to describe all the buttons, LEDs, and such on the unit. These buttons are mapped to various features.

Controller Performance Modes

The [HARDWARE_ID]_Controller_Assignments.qml specifies the button mapping for each supported controller mode.

Performance Modes List

Performance Mode	`JC11`	`JC16`	`JC20`	`JP07`	`JP08`	`JP11`	`JP13`	`JP14`	`JP20`	`JP21`	`JP22`	`NH08`	`NH09`	`NH10`	`RMZ2`
`AUTO`	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅
`CUES`	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅
`FIXED`	✅	✅	✅	✅	✅	❌	✅	✅	❌	✅	✅	❌	❌	❌	✅
`LOOPS`	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	❌	✅	✅
`ROLL`	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	❌	✅	✅
`SAMPLER`	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅
`SIMPLE_ROLL`	❌	❌	❌	❌	❌	❌	❌	❌	❌	❌	❌	❌	✅	❌	❌
`SLICER`	✅	✅	✅	✅	✅	❌	✅	✅	❌	✅	✅	❌	❌	❌	✅
`STEMS`	✅	❌	✅	❌	❌	❌	❌	❌	❌	✅	✅	❌	❌	❌	❌

Modifying

To change the compatible performance modes, modify your device's QML at /usr/Engine/AssignmentFiles/PresetAssignmentFiles/[HARDWARE_ID]/[HARDWARE_ID]_Controller_Assignments.qml

On the JP11, the controller assignment contains:

PerformanceModes {
    ledType: LedType.RGB
    modesModel: ListModel {
        ListElement {
            note: 11
            view: 'CUES'
        }
        ListElement {
            note: 12
            view: 'LOOPS'
            altView: 'AUTO'
        }
        ListElement {
            note: 13
            view: 'ROLL'
            altView: 'SAMPLER'
            shiftView: 'SAMPLER'
        }
    }
}

This shows the modes that a button is mapped to with a standard press (view), the mode that it switches to when pressed again (altView), and the mode that it switches to when SHIFT is held while the button is pressed (shiftView).

In this example, slicer mode (which isn't a feature of the JP11) can be added to the LOOP button by changing the ListElement for the button to:

ListElement {
    note: 12
    view: 'LOOPS'
    shiftView: 'SLICER'
}

Slicer enabling test apps for the JP11, JP11S, JP20, NH08, NH09, and NH10 can be downloaded here: TestAppsCatalog-Slicer.zip

Additional References

QEngine's controllermap - a worked example of writing these files from scratch rather than editing them. It drops a hand-authored RMZ2_Controller_Assignments.qml and RMZ2_Controller_Device.qml into the RMZ2 control-surface slot so that a third-party USB controller (a Denon DJ MC6000MK2, mapped from inMusic's published MIDI command list) drives Engine under emulation. See Engine OS for the project itself.

12 August 2026