Install Arduino support on Linux

Install version 1.6 or newer of the Arduino IDE from http://arduino.cc/download -- Unfortunately the version packaged in Ubuntu is too ancient to support Arduino's new way of doing 3rd-party hardware. I'm not aware of Ubuntu packages for 1.6 or 1.8

Assuming you're untarring in the download directory:

$ cd ~/Downloads
$ tar xvf arduino-1.8.5-linux64.tar.xz
$ sudo mv arduino-1.8.5 /usr/local/arduino
$ cd /usr/local/arduino
$ sudo ./install.sh

On Ubuntu, you will have to prevent ModemManager from attempting to grab the keyboard virtual serial port when it goes into bootloader mode:

$ wget https://raw.githubusercontent.com/keyboardio/Kaleidoscope/master/etc/99-kaleidoscope.rules
$ sudo cp 99-kaleidoscope.rules /etc/udev/rules.d

Then disconnect and reconnect the keyboardio for that change to take effect.

To let Arduino talk to the device over the serial port, you'll need to be in the 'dialout' group.

From a shell:

$ groups 

If you see dialout in the list, you're good to go. If you don't, you'll have to add yourself and then get Linux to recognize the change in your current shell:

$ sudo adduser $USER dialout
$ su -  $USER

On Manjaro linux, and probably Arch, the group for the device access is uucp. To add yourself to this group if necessary, use

$ sudo usermod -a -G uucp
$ su - $USER

and you most likely will have to tweak the ARDUINO_PATH (put this line in your shell-rc - minus the prompt of course)

$ export ARDUINO_PATH=/usr/share/arduino

Now continue with the instructions from the Readme