OneSeq

MIDI control surfaces

Map hardware to OneSeq without turning it into homework

OneSeq ships with practical profiles for common controllers and keeps the flexible path open: learn a control, bind it to a target, choose absolute or relative behavior, and decide whether the UI should follow the hardware.

Setup

Make sure OneSeq sees the device first

  1. Connect the MIDI controller before or after launching OneSeq.
  2. Open Config, enable the MIDI input monitor, and select the input port.
  3. Move a knob, fader, pad, or button. Recent input should show the port, channel, CC/note, and value.
  4. Select a built-in profile, or clone one to create a custom profile.
  5. Use Control Surface Follow when you want OneSeq selection/focus to track incoming controls; disable it for background control.

Profiles

Built-ins in 0.3.2

Profile Best use Setup note
Generic 8-knob / focused performance Fast current-track parameter control and simple custom mappings. Use Learn latest when the controller does not match a named device profile.
Traktor Kontrol F1 observed Observed CC/pad behavior from the available hardware path. Select the F1 input port and confirm Recent input before relying on the profile.
Torso T-1 CC Mode Hands-on CC70-83 control from a T-1 track. Press BANK, then hold CTRL+VBx on the desired T-1 track until it is cyan for CC Track mode.
Arturia MiniLab 3 Eight encoders for selected-track params plus faders for mix/send targets. Use the default DAW/user MIDI behavior and verify CCs in Recent input.
Akai MPK Mini Portable 8-knob and pad control. Defaults vary by editor preset; use the profile as a starting map and Learn latest if needed.
Novation Launchkey MK4 Keyboard-plus-pads control with a OneSeq custom-mode style map. Use Novation Components/custom mode if factory DAW mode sends different messages.
Korg nanoKONTROL2 Fixed eight-track mixer control. Use CC mode. Faders target gains, knobs target pans, and buttons target mute/solo/select.
Behringer X-Touch Mini Relative encoder control and compact mixer/performance actions. Use Preset A. Encoders use relative center-64 behavior on channel 11.
Novation Launch Control XL Eight-track mixer plus selected-parameter control. Use a OneSeq template/common CC layout; fixed faders/knobs target tracks and lower knobs target selected parameters.

Custom mapping

Learn, then make it yours

The monitor is also the mapping tool. Move a hardware control, choose Learn latest, then set the target: selected-track parameter, fixed-track parameter, gain, pan, mute, solo, sends, FX, LFO, transport, section navigation, track movement, or auto-focus behavior.

Flexible by design: A controller can be an eight-knob current-track editor, a fixed mixer, a launch panel, a Fractal performance surface, or a mix of all of those.

Value modes

Absolute and relative controls behave differently

Absolute CCs send 0-127 and are best for normal knobs, faders, and custom CC tracks. Relative encoders send movement deltas around a center value and are best for endless encoders. If a knob jumps or only moves after catching up, check whether the profile is using the correct mode.

Troubleshooting

When hardware behaves strangely

Symptom Likely fix
Recent input is empty Refresh ports, select the correct input port, and check whether another app has grabbed the device.
Values only change after the knob catches up Use absolute mode for normal CC controls, or make sure the profile is not treating the control as relative.
Endless encoder moves one way incorrectly Use a relative mode that matches the device, usually center-64 for X-Touch Mini style encoders.
Hardware changes the wrong track Check selected vs fixed-track targets and whether Control Surface Follow is enabled.