Help

The binding editor

Everything a preset does is a list of rows, and every row is the same shape: one input on the left, one or more outputs on the right, and an Options panel for how the two are joined. Once the row makes sense, the whole app does.

The anatomy of a row

From left to right: a drag handle for reordering, the row number, a Scan button, the input type menu, the specific input, an arrow, then the output type menu and the output itself. Below the row sits a note field, and a disclosure labelled Options. The row number matches the number shown in the Live Visualizer, so clicking a control on screen takes you to its row.

Inputs

The input type menu offers Button, Axis, Hat, Touchpad, Touchpad Region, Touchpad Gesture, Motion, Keyboard Key, Mouse, Cursor Region, Stick Region, Tap the Mac, and MIDI. Buttons are on or off. Axes are sticks and analog triggers, bound one direction at a time: a stick is four rows, one per direction. A hat is the D-pad. Motion is the gyroscope and accelerometer. Keyboard Key and Mouse make your Mac's own keyboard and mouse into inputs. MIDI covers notes, pads, control changes, pitch bend, aftertouch, and program change.

Outputs

Keyboard Key, Type Text, Mouse Button, Mouse Motion, Mouse Wheel, Mouse Wheel Step, MIDI Note, MIDI CC, MIDI Pitch Bend, MIDI Program Change, MIDI Transport, System Function, System Volume (follows input), and App Action. A row can carry several outputs at once with the plus button; they all fire together. A keyboard output can be a full chord such as Command Shift 3, and it is sent as a real chord.

Scan

Press Scan on a row, then press the control you want. The row's input is set to whatever you pressed, on whatever device you pressed it: a controller button, a stick direction, a MIDI key, a key on your Mac keyboard, or a mouse button. Modifier keys pressed on their own are detected too, including Shift, Control, Option, Command, right Command, F16 to F19, and the fn / Globe key. Escape cancels a scan, and there is a Cancel button for people without a keyboard.

Options: press behavior

Toggle latches the output on with one press and releases it with the next. Sticky modifiers, push-to-talk that stays on, auto-run.
Turbo repeats the output while the control is held, at a rate you set in presses per second.
Repeat fires the output a fixed number of times per press, with a delay between repeats.
Macro replaces the output with a sequence of steps, each with its own delay and hold time. A Hold down step keeps a key held while later steps run, which is how Command C style chords are built. Release lets it go.
Hold action fires a different output when the control is held past a threshold you set.
Double-tap action fires a different output when the control is pressed twice within a window you set.
While holding makes the row a chord: it only fires while another button on the same controller is held.

Options: feedback

Vibrate rumbles the controller when the row fires, with a strength slider; it needs a controller with real haptics such as the DualSense. Speak says a phrase out loud when the row fires, through the Mac or through the controller's own speaker. Leave the phrase empty and it says the input's name, which is a quick way to learn a layout by ear.

Options: analog

Rows bound to a stick, trigger, or motion channel get an inner deadzone, an outer deadzone, axis inversion, a sensitivity curve (Linear, Smooth, Aggressive), and Variable Sensitivity, which scales the output by how far the control is pushed. The Calibrate button opens a live plot of the stick so the deadzone can be set by watching where it rests. See deadzones and sensitivity.

Reordering, duplicating, converting

Drag a row by its handle; it lifts, follows the pointer, and the list opens a gap where it will land. The copy button duplicates a row with every option intact. The header of a controller slot has a sort button, an undo for that sort, a stick settings button that sets the deadzone on every axis row at once, and a convert option that changes the preset between controller types, keeping every setting.

Undo, versions, and the Key field

The editor has undo and redo. Every save keeps a snapshot, and the preset's detail page can revert to any of the last ten. The Key field at the top gives the preset its own system-wide shortcut: press it anywhere to switch to the preset, press it again to stop it.

Questions

Can one button send more than one thing?

Yes. Add outputs with the plus button and they fire together, or build a macro for a sequence with timing.

What does a row with no output do?

Nothing, which is sometimes the point. A chord's modifier button can be given an empty row so it stops doing its normal job while it is used as a modifier.

Why are stick rows in pairs?

A stick axis is bound one direction at a time, plus and minus, so left and right are two rows. That is what lets each direction send a different thing, and have its own deadzone and curve.