Skip to content

Understanding Cards

Kilowhat is the configuration tool for your controller. With Kilowhat you can set up the messages that your controller will send, where the messages will be sent, save your configuration files, define the behavior of your components, configure the messages to which your feedback will respond, and more.

Each of the cards represents a component in your controller. Select one card to access its configuration. Or activate auto selection, move a component and the corresponding card will be selected. The cards also provide useful visual information while you work on your configuration.

Kilowhat main interface

The interface is organized into several key areas:

  • Load and save - Save and load configuration files
  • Show bank number - Display which bank you’re currently editing
  • Cards/components - The main card grid showing all your controller components
  • Filter and search - Tools to find specific components quickly
  • Help and preferences - Access settings and documentation
  • Parameter editor - Configure the selected component
  • Editor/banks - Switch between editing modes
  • MIDI monitor - View real-time MIDI activity
  • Link and sync - Connection status indicators
  • Send to device - Upload your configuration

Each card displays essential information about its corresponding component at a glance.

Card anatomy breakdown

A card shows the following information:

ElementDescription
HW IDHardware ID - unique identifier for each component
CommentUser-defined reference name for the parameter
Card SynchroIndicates if the card is synced with the controller
MessageThe MIDI message type (CC, NOTE, etc.)
MIN/MAX ValuesThe minimum and maximum values for the message
PortsOutput ports (M: MIDI, U: USB)
MIDI ChannelThe MIDI channel used by this component
Feedback Color/ModeVisual indicator of feedback configuration

This number shows the hardware ID, unique for each component in your controller. You can find this number in the top left corner of each card.

Here you can see the color configured for the feedback of the component corresponding to the card.

  • Encoder cards: You’ll see 2 circles - one for the rotary encoder’s ring, and one for the encoder switch
  • Digital cards: You’ll see the color configured for the button

The feedback indicator shows the color mode:

  • Solid blob = FIXED COLOR mode with the configured color
  • Color wheel = VALUE TO COLOR mode (color changes based on received MIDI value)

Shows a user-defined reference name for a parameter. You can edit this name by typing in the “comment” box inside the configuration tool box of each component.

Shows the message type for this component:

CodeMessage Type
NOTEMIDI Note Message
CCMIDI Control Change Message
PCMIDI Program Change Message
PC+MIDI Program Change Increment and send
PC-MIDI Program Change Decrement and send
NRPNMIDI Non Registered Parameter Number Message
RPNMIDI Registered Parameter Number Message
PBMIDI Pitch Bend Message
KBKeyboard action
BANKComponent configured as a Bank shifter

Shows the minimum and maximum values defined for the message. For example, “0-127” indicates the full MIDI value range.

Shows the output ports for the message:

  • M = MIDI (DIN5 port)
  • U = USB
  • M|U = Both ports

Shows the MIDI channel (1-16) used by this component.

You can select a card to edit by either:

  1. Clicking on the card directly
  2. Moving a component on your controller (with Auto-Select enabled)

The selected card will be highlighted in Kilowhat, and its configuration options will appear in the parameter editor on the right side.