This clip is taken from a longer Control Surface Studio walkthrough video
🎥 Watch the full CSS walkthrough video
This guide explains how to add a controller input (such as an encoder) to your Controller Template . Controller Templates visually represent your hardware MIDI Controller. They store all MIDI data which the physical controls send and receive.
For more details see: Why are Scripts and Controller Templates separate?
Prerequisites
- Your MIDI controller is connected and sending MIDI data.
- You have already created a new script or opened an existing one in the Script Editor.
Create a New Controller Template
In the Script Panel, click the plus button which is located to the right of the ‘controller input’ menu.
You will be prompted to name the new Controller Template.
After entering a name, click add and the new template will appear in the Controller Template Panel on the right.
Add a New Controller Input
In the Input menu at the top.
Choose the input type that matches your hardware control. Example: Select Endless Encoder to add a rotary knob.
Position and resize the control on the template canvas as needed.
Assign MIDI Data to the Controller Input
To open the input’s settings menu, hover over the input and click the small arrow which appears.
Turn on MIDI Learn.
Move the physical control (e.g. twist the encoder).
The MIDI data fields will update automatically.
The most recent MIDI data is shown in the MIDI learn section.
Enter the MIDI velocity data in the ‘MIDI Input Velocity Settings’ section.
Save the changes.
Test the MIDI data is correct
If the MIDI data which you entered is correct, when you press/turn/move the physical input on the connected MIDI controller, the controller input will highlight in green.
Save and Confirm
- To save changes to file. Click the Save button in the top right corner the Controller Template panel.
Notes
- Controller templates are reusable across multiple scripts.