Logo Velours DevicesVelours Devices, homeOrder

Documentation

The configurator

Build pages on your computer, see them laid out as they will appear on KARL, and send them over USB.

Download

KARL ConfiguratorMac with Apple silicondownload
KARL ConfiguratorMac with Inteldownload
KARL ConfiguratorWindows 10 or laterdownload
KARL ConfiguratorLinux, AppImagedownload

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 slotAdd a control there
⇧ or ⌘ clickSelect more than one control
DragMove a control, or swap it with the one it lands on
⌥ dragCopy a control
Right clickThe slot's menu
⌘C, ⌘X, ⌘VCopy, cut, paste onto the selected slot
⌥⌘VPaste only the settings (MIDI, OSC, colour, label) onto the selection. CC and OSC numbers count up
⌘DDuplicate
⌫Delete
Arrows, EnterMove through the slots, open one
⌘Z, ⇧⌘ZUndo, redo
⌘FFind a control on any page
⌘SSave 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.