This document assumes that the Arduino IDE is already installed, as well as the necessary hardware support packages, such as Teensyduino or the ESP32 Core, if you're not using a standard board.
Here are some links to installation instructions for the Arduino IDE on Linux, on Windows, and on OSX.
You have to install the Control Surface library itself, as well as some dependencies.
If you want to keep up to date with the latest developments, or if you want an easy way to update, the Git install is recommended. Otherwise, the installation without Git will be fine as well.
If you're using PlatformIO, you can download the library using the PIO Library Manager: https://platformio.org/lib/show/6793/Control Surface/installation
Download the repository as a ZIP archive by going to the home page of the repository and click the green Clone or download button on the top right.
Open the Arduino IDE, and go to the Sketch > Include Library > Add .ZIP Library menu.
Then navigate to your downloads directory where you just downloaded the library.
Select it, and click Ok.
If you haven't already, install Git from https://git-scm.com/downloads or use your system's package manager.
On Ubuntu and other Debian-based distros:
Open a terminal window and change the directory to your Arduino folder.
In a Linux terminal or Git Bash:
If you installed the library using Git, you can easily update it when a new version comes out.
To update to the latest master version:
If you are using an Arduino board with on-board USB capabilities, you need the MIDIUSB library. Install it as explained before, or by using the Library Manager.
The Control Surface Library depends on the PJRC Encoder library for reading the input from rotary encoders. Download and install it if you plan on using those.
If you are using a Teensy, you don't need the MIDIUSB library, and the Encoder library should already be installed by default.
To use AppleMIDI, you also need the AppleMIDI library and its dependencies.
1.8.19