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.
If you're using an AVR board (e.g. Arduino Uno, Mega, Nano, Leonardo), you need at least version 1.8.1 of the Arduino AVR Core (see Tools > Board > Boards Manager).
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 clicking the green Code button in the top right, then choosing “Download ZIP”.
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 main 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.
To use AppleMIDI, you also need the AppleMIDI library and its dependencies.
1.9.4