open-audiovisual
Search GitHub

PMJ

PMJ MidiKey

PMJ MidiKey is a MIDI hardware controller by PMJ: 48 buttons.

It sends Note on channel 1. The profile cites 1 source. 48 of its controls are marked unverified: the number is our best reading, and Learn rebinds it in one move.

  • Community notes
  • From QLC+
  • Layout generated automatically
  • 48 unverified
Kind
hardware device
Maker
PMJ
Controls
48 controls
Messages
Note
MIDI channels
1
LED feedback
none sent
Layout
generated automatically
Data licence
Apache-2.0, from QLC+ (NOTICE)
Checked on hardware
not yet
Signals
midi/midikey/…
Port name matches
none: assign by hand, then learn
PMJ MIDIKEYBUTTONS

Play PMJ MidiKey on screen Raw JSON ↗ All controllers

Layout generated automatically: QLC+ has no faceplate data, so this is a list of the controls, not a picture of the device.

Drag knobs and faders · tap pads and keys · or plug the real one in and press Connect. Nothing is sent anywhere unless you add a MIDI out.

MIDI implementation

Every control of PMJ MidiKey and the message it sends

Generated from the profile file, so it is the same table the on-screen controller plays. Channels are 1–16; numbers are real MIDI numbers.

MIDI implementation of PMJ MidiKey
ControlTypeMessageChNumberSignalLED feedbackEvidence
Row 1 (top) Button 1 row-1-top-button-1 button Note · momentary 1 1 · C#-1 midi/midikey/row-1-top-button-1 — unverified
Row 1 (top) Button 2 row-1-top-button-2 button Note · momentary 1 2 · D-1 midi/midikey/row-1-top-button-2 — unverified
Row 1 (top) Button 3 row-1-top-button-3 button Note · momentary 1 3 · D#-1 midi/midikey/row-1-top-button-3 — unverified
Row 1 (top) Button 4 row-1-top-button-4 button Note · momentary 1 4 · E-1 midi/midikey/row-1-top-button-4 — unverified
Row 1 (top) Button 5 row-1-top-button-5 button Note · momentary 1 5 · F-1 midi/midikey/row-1-top-button-5 — unverified
Row 1 (top) Button 6 row-1-top-button-6 button Note · momentary 1 6 · F#-1 midi/midikey/row-1-top-button-6 — unverified
Row 2 Button 1 row-2-button-1 button Note · momentary 1 7 · G-1 midi/midikey/row-2-button-1 — unverified
Row 2 Button 2 row-2-button-2 button Note · momentary 1 8 · G#-1 midi/midikey/row-2-button-2 — unverified
Row 2 Button 3 row-2-button-3 button Note · momentary 1 9 · A-1 midi/midikey/row-2-button-3 — unverified
Row 2 Button 4 row-2-button-4 button Note · momentary 1 10 · A#-1 midi/midikey/row-2-button-4 — unverified
Row 2 Button 5 row-2-button-5 button Note · momentary 1 11 · B-1 midi/midikey/row-2-button-5 — unverified
Row 2 Button 6 row-2-button-6 button Note · momentary 1 12 · C0 midi/midikey/row-2-button-6 — unverified
Row 3 Button 1 row-3-button-1 button Note · momentary 1 13 · C#0 midi/midikey/row-3-button-1 — unverified
Row 3 Button 2 row-3-button-2 button Note · momentary 1 14 · D0 midi/midikey/row-3-button-2 — unverified
Row 3 Button 3 row-3-button-3 button Note · momentary 1 15 · D#0 midi/midikey/row-3-button-3 — unverified
Row 3 Button 4 row-3-button-4 button Note · momentary 1 16 · E0 midi/midikey/row-3-button-4 — unverified
Row 3 Button 5 row-3-button-5 button Note · momentary 1 17 · F0 midi/midikey/row-3-button-5 — unverified
Row 3 Button 6 row-3-button-6 button Note · momentary 1 18 · F#0 midi/midikey/row-3-button-6 — unverified
Row 4 Button 1 row-4-button-1 button Note · momentary 1 19 · G0 midi/midikey/row-4-button-1 — unverified
Row 4 Button 2 row-4-button-2 button Note · momentary 1 20 · G#0 midi/midikey/row-4-button-2 — unverified
Row 4 Button 3 row-4-button-3 button Note · momentary 1 21 · A0 midi/midikey/row-4-button-3 — unverified
Row 4 Button 4 row-4-button-4 button Note · momentary 1 22 · A#0 midi/midikey/row-4-button-4 — unverified
Row 4 Button 5 row-4-button-5 button Note · momentary 1 23 · B0 midi/midikey/row-4-button-5 — unverified
Row 4 Button 6 row-4-button-6 button Note · momentary 1 24 · C1 midi/midikey/row-4-button-6 — unverified
Row 5 Button 1 row-5-button-1 button Note · momentary 1 25 · C#1 midi/midikey/row-5-button-1 — unverified
Row 5 Button 2 row-5-button-2 button Note · momentary 1 26 · D1 midi/midikey/row-5-button-2 — unverified
Row 5 Button 3 row-5-button-3 button Note · momentary 1 27 · D#1 midi/midikey/row-5-button-3 — unverified
Row 5 Button 4 row-5-button-4 button Note · momentary 1 28 · E1 midi/midikey/row-5-button-4 — unverified
Row 5 Button 5 row-5-button-5 button Note · momentary 1 29 · F1 midi/midikey/row-5-button-5 — unverified
Row 6 Button 1 row-6-button-1 button Note · momentary 1 30 · F#1 midi/midikey/row-6-button-1 — unverified
Row 6 Button 2 row-6-button-2 button Note · momentary 1 31 · G1 midi/midikey/row-6-button-2 — unverified
Row 6 Button 3 row-6-button-3 button Note · momentary 1 32 · G#1 midi/midikey/row-6-button-3 — unverified
Row 6 Button 4 row-6-button-4 button Note · momentary 1 33 · A1 midi/midikey/row-6-button-4 — unverified
Row 6 Button 5 row-6-button-5 button Note · momentary 1 34 · A#1 midi/midikey/row-6-button-5 — unverified
Row 7 Button 1 row-7-button-1 button Note · momentary 1 35 · B1 midi/midikey/row-7-button-1 — unverified
Row 7 Button 2 row-7-button-2 button Note · momentary 1 36 · C2 midi/midikey/row-7-button-2 — unverified
Row 7 Button 3 row-7-button-3 button Note · momentary 1 37 · C#2 midi/midikey/row-7-button-3 — unverified
Row 7 Button 4 row-7-button-4 button Note · momentary 1 38 · D2 midi/midikey/row-7-button-4 — unverified
Row 7 Button 5 row-7-button-5 button Note · momentary 1 39 · D#2 midi/midikey/row-7-button-5 — unverified
Row 8 Button 1 row-8-button-1 button Note · momentary 1 40 · E2 midi/midikey/row-8-button-1 — unverified
Row 8 Button 2 row-8-button-2 button Note · momentary 1 41 · F2 midi/midikey/row-8-button-2 — unverified
Row 8 Button 3 row-8-button-3 button Note · momentary 1 42 · F#2 midi/midikey/row-8-button-3 — unverified
Row 8 Button 4 row-8-button-4 button Note · momentary 1 43 · G2 midi/midikey/row-8-button-4 — unverified
Row 8 Button 5 row-8-button-5 button Note · momentary 1 44 · G#2 midi/midikey/row-8-button-5 — unverified
Row 9 (bottom) Button 1 row-9-bottom-button-1 button Note · momentary 1 45 · A2 midi/midikey/row-9-bottom-button-1 — unverified
Row 9 (bottom) Button 2 row-9-bottom-button-2 button Note · momentary 1 46 · A#2 midi/midikey/row-9-bottom-button-2 — unverified
Row 9 (bottom) Button 3 Please/Enter row-9-bottom-button-3-please-enter button Note · momentary 1 47 · B2 midi/midikey/row-9-bottom-button-3-please-enter — unverified
Row 9 (bottom) Button 4 row-9-bottom-button-4 button Note · momentary 1 48 · C3 midi/midikey/row-9-bottom-button-4 — unverified

Have this unit? It takes a few minutes to check this data. Verify PMJ MidiKey with your unit →

LED feedback is not modeled for this one yet, so OAV does not light its LEDs. Every control still plays and sends its message.

Sources

Where this profile comes from

Imported from QLC+ on 2026-11-04. resources/inputprofiles/PMJ-MidiKey.qxi

Notes

Imported from QLC+. The messages are what its community profile lists; nobody has checked them on a unit for this project, so every control is unverified. QLC+ has no faceplate data, so the layout was generated from the list of controls and does not look like the device. There is no port name to go by, so it is never picked automatically: assign it by hand. QLC+ numbers these controls without a MIDI channel, so channel 1 here is a placeholder: the unit may send on another.

Port names it recognises

Signals

Every control publishes midi/midikey/<control> (0..1), plus /raw; pads add /hit, encoders /delta, keys /on /off and n<note>; the last control touched is midi/midikey/last.

Use it

Use PMJ MidiKey in your own work

  1. Embed it with one line

    No import map, no build step. Change layout, add hardware="ask" for a Connect button.

    html
    <script type="module" src="https://openaudiovisual.com/packages/midi/element.js"></script>
    <oav-controller profile="pmj-midikey" readout></oav-controller>
  2. Or as an iframe

    For places that only take an iframe. Every event arrives as a postMessage.

    html
    <iframe src="https://openaudiovisual.com/embed/controller/?profile=pmj-midikey&readout"
            width="720" height="303" style="border:0;max-width:100%" allow="midi"
            title="PMJ MidiKey"></iframe>
    <script>
      // every control the visitor plays arrives here
      addEventListener('message', (e) => {
        if (e.data?.source !== 'openav' || e.data.type !== 'control') return;
        console.log(e.data.detail.signal, e.data.detail.value);
      });
    </script>
  3. Send it to Ableton, TouchDesigner or Resolume

    What you play on screen leaves as real MIDI on the IAC bus (macOS) or a loopMIDI port (Windows). The steps are on the catalog page.

    html
    <!-- what you play on this controller → the IAC bus (macOS) → Ableton, TouchDesigner, Resolume -->
    <script type="module" src="https://openaudiovisual.com/packages/midi/element.js"></script>
    <oav-controller profile="pmj-midikey" midi-out="IAC" readout></oav-controller>
    <!-- Windows: midi-out="loopMIDI" · let the visitor pick a port: midi-out="ask" -->

    macOS: Audio MIDI Setup → MIDI Studio → IAC Driver → “Device is online”. Windows 11: the built-in Windows MIDI Services have a loopback (not tested by us); older Windows: install loopMIDI, add a port and use midi-out="loopMIDI".

In p5.js, with one line

The one-line injection names knobs, faders and pads by their order in this profile, the order of the table above. Add ?profile=pmj-midikey to make the on-screen controller this one; a real PMJ MidiKey is recognised by its port name.

javascript
document.head.prepend(Object.assign(document.createElement('script'), { src: 'https://openaudiovisual.com/p5/oav-p5.js?profile=pmj-midikey' }));
p5.js sketch
function draw() {
  background(20);
}

Encoders, buttons, wheels and strips are not numbered: read them as midi.cc[number] in the table above, or react in controlChange(cc, value, ch).

The whole p5.js page →

Other software

Use this controller outside this project

The same data, as files other programs read. Nobody has tested these on this exact unit unless the table above says so.

QLC+

An input profile: every control and LED value, for lighting. Copy it to your user folder (macOS ~/Library/Application Support/QLC+/InputProfiles, Linux ~/.qlcplus/inputprofiles, Windows %USERPROFILE%\QLC+\InputProfiles) and restart QLC+.

Mixxx

A starting point, not a finished mapping: decks, EQ and hot cues go to the controls in order. Put both files in the folder that Preferences → Controllers → Open User Mapping Folder opens, then remap what you like with the Learning Wizard.

The data itself

Everything above comes from this file: faceplate, messages, LEDs, SysEx and who checked what. tools/export-controller.mjs writes these files from any profile.

Missing

Is your controller not here?

Open an issue with the brand and model, whether you have the unit and a link to the manual. Or write the profile yourself: it is one JSON file.

GitHub

Is something in this data wrong?

Every number on this page comes from one JSON file. If it disagrees with your unit or the manual, tell us which firmware you checked and we fix the file.