For most folks, the right way to get started is to install the Arduino IDE with prebuilt Kaleidoscope support
Setup the Arduino IDE on your system. Make sure you install at least version 1.8.6, since older version may not support all required features.
## Set up the Arduino IDE with Kaleidoscope support
* On Linux, follow the instructions [on the wiki](https://github.com/keyboardio/Kaleidoscope/wiki/Install-Arduino-support-on-Linux).
* On macOS, install using [homebrew](http://brew.sh/) [cask](https://caskroom.github.io/) with `brew cask install arduino` or download the application from [the official website](https://www.arduino.cc/en/Main/Software) and move it to your `/Applications` folder.
[setup_toolchain](Install Arduino and Kaleidoscope)
## Get into the right directory
If you intend to develop Kaleidoscope, you may want to install Kaleidoscope from git.
### macOS
```sh
mkdir -p $HOME/Documents/Arduino/hardware
cd $HOME/Documents/Arduino/hardware
```
### Linux
```sh
mkdir -p $HOME/Arduino/hardware
cd $HOME/Arduino/hardware
```
### Windows
*TODO*: Write me
### Install the libraries and hardware definitions