Documentation
The configurator
Download
| KARL Configurator | Mac with Apple silicon | download |
| KARL Configurator | Mac with Intel | download |
| KARL Configurator | Windows 10 or later | download |
| KARL Configurator | Linux, AppImage | download |
On a Mac, the first open needs one step in System Settings. See opening it the first time on a Mac.
Projects and pages
Everything KARL shows is one project: a list of pages, each with the knobs, keys and lists on it. The configurator edits that project and sends it to KARL with ⌘S. KARL checks it before using it, and keeps the last project that worked, so a mistake never leaves you with a blank panel.
Each page is a grid of 24 knob slots in six columns and four rows, with key slots along the four edges. Click a slot to place a control, then set it up in the inspector on the right: its name, colour, range and what it sends.
Editing
| Click an empty slot | Add a control there |
| ⇧ or ⌘ click | Select more than one control |
| Drag | Move a control, or swap it with the one it lands on |
| ⌥ drag | Copy a control |
| Right click | The slot's menu |
| ⌘C, ⌘X, ⌘V | Copy, cut, paste onto the selected slot |
| ⌥⌘V | Paste only the settings (MIDI, OSC, colour, label) onto the selection. CC and OSC numbers count up |
| ⌘D | Duplicate |
| ⌫ | Delete |
| Arrows, Enter | Move through the slots, open one |
| ⌘Z, ⇧⌘Z | Undo, redo |
| ⌘F | Find a control on any page |
| ⌘S | Save and send the project to KARL |
Select several controls to change them together in one inspector.
MIDI settings that carry down
Set a MIDI port and channel once for the project or for a page, and every control without its own setting uses them. A control's own setting wins over its page's, and the page wins over the project.
Table view
The table lists every control with its MIDI and OSC settings, for changes in bulk. It imports and exports CSV, so you can prepare a page in a spreadsheet.
Library
The library keeps templates, such as whole pages or sets of controls, and instrument profiles to build pages from. General MIDI is built in. Import your own profiles as JSON, or as CSV with the columns name,cc[,min,max,msb,lsb].
Checking what KARL does
- Follow: the configurator jumps to the control you touch on KARL.
- Live: values on screen move with KARL.
- MIDI log: every message KARL sends and receives.
- Test: sends a control's MIDI or OSC again, to check the other side.
The JSON tab
Under the editor, a project is a controls.json file. The JSON tab shows it with completion and inline errors, for anything the inspector does not cover. The configurator checks the file against the same rules as KARL before sending it.
Next: the kinds of controls you can place.
