Macros and knobs

Each of the 32 knobs has four macros. A macro maps knob motion to MIDI, a rack device parameter, an S32 LFO, or a CV16 output.

Modes and settings use names, not integers.

s32 --loopback macro get 4 1
s32 --loopback macro set 4 1 mode=cc msb=74 channel=3
s32 --loopback potname get 4
s32 --loopback potname set 4 Cutoff
s32 --loopback knobmap get 0
s32 --loopback knobmap copy 3 9

Modes

CLI name	Aliases	What it sends
disabled	off	Nothing
cc	control-change	7-bit Control Change
pc	program-change	Program Change
cc14	fourteen-bit	14-bit Control Change
aftertouch	at	Channel aftertouch
poly-aftertouch	poly-at, pat	Polyphonic aftertouch (msb is the MIDI note)
nrpn		NRPN
rpn		RPN
pitch-bend	pb	Pitch bend
sysex		SysEx
device	device-parameter	Rack device parameter
s32-lfo	lfo	Global S32 LFO parameter
cv16	cv16-ctrl	CV16 jack voltage
cv16-lfo		CV16 expander LFO parameter

Product reference for each mode (ranges, when to use it):

• Disabled
• Control Change
• Program Change
• 14-bit CC
• Channel aftertouch
• Poly aftertouch
• NRPN
• RPN
• Pitch bend
• SysEx
• Device parameter
• S32 LFO
• CV16 control
• CV16 LFO

macro get / macro set

macro get POT MACRO — pot 0–31, macro 0–3.

macro set POT MACRO key=value … reads the current row, then patches the fields you name:

Key	Values
mode	Names in the table above
msb	CC number, PC number, NRPN/RPN MSB, …
lsb	LSB where the mode uses it
channel	global or 1–16
min / max	Mapped range. 7-bit MIDI is 0–127. cc14, nrpn, rpn, pitch-bend, and sysex default to 0–16383 when you change into that mode without naming min/max. Pass them to keep a custom window.
invert	on / off
outputs	none, usb, out1, out2, or usb+out1+out2
pickup	on / off
rack / device / param	Device-parameter mode. param takes the same names as device param get (bypass, clock-division, …) or a numeric ParameterId.
sub	Step Seq step index (0–15). Device-settings targets (CLOCK BYPASS, …) default to 255 when you omit sub. Pass sub= only for a per-step mapping.
lfo / cvParam	S32 LFO / CV16 LFO modes (cvParam is rate, depth, enabled, …)
cv	CV16 jack (1–16) for mode=cv16
name	Named-control label

macro set 4 1 mode=cc msb=74 channel=3 min=0 max=127 outputs=usb+out1
macro set 0 2 mode=cc14 msb=1 lsb=33 channel=3
macro set 0 0 mode=device rack=100 device=1000 param=bypass
macro set 2 0 mode=s32-lfo lfo=0 cvParam=rate min=0.1 max=20
macro set 3 0 mode=disabled

Switching mode=cc14 (or nrpn / rpn / pitch-bend / sysex) without min/max sends 0…16383, matching a panel mode change. To keep a custom window, pass min/max when you change mode, or set them after the row is already in that mode.

mode=device without sub= leaves device-settings targets unscoped. Pass sub= only when mapping a Step Seq per-step field.

Pot names

potname get|set POT [NAME]

Knob map

knobmap get [START] pages knob names and the four macros per pot.

knobmap copy SRC DST copies one pot’s entire map onto another.