Device Selection

On the server you can select which midi device you want to receive data from.

It is important to note that not all controllers speak midi and hid simultaneously.

You can select as many devices as you would like, however each device requires a corresponding personality file.

Screenshot 2025-09-04 at 11.40.23 AM.png

The file needs to be the same name as the device ID produced by the system in string format.

IAC Driver Bus 1.json

{
"commands": [
	{
		"channel": 7,
		"note": 0,
		"event": "Cue 1"
	},
	{
		"channel": 7,
		"cc": 8,
		"event": "FIRE"
	}
}

Personality files need to be placed in:

Mac: ~/Library/Application Support/ClockworksServer/personalities/

Windows: $HOME\\AppData\\Roaming\\ClockworksServer\\personalities\\

File Format

The json file above consists of a commands object that holds an array of commands. Each command has a channel value, a note or cc for control change, and an event value.

Clockworks can map the same event to multiple inputs, this allows for things like mixed layers on pads, or multiple effects knobs. The event value is an arbitrary string of your choosing.

Midi Notes To Integer

image.png

Event Data