Introduction

This script can be used to control Obsidian Onyx using an Akai APCmini. This is done by mapping the midi messages from the apc to osc messages that Onyx understands. By default the script maps the buttons to the playpaback buttons on page 1, the faders to playback faders 11-20 and buttons above the faders to the flash buttons of the faders.

Setup

1. First setup osc in Onyx and oscii-bot (see here). You can skip the test and directly use the script provided below.
2. Download the oscii-bot script from here
3. Put the script into the folder that oscii-bot loads its scripts from.
4. Make sure that the ip inside the script matches the one that you used in Onyx and on the loopback adapter (if you are using the loopback adapter).
5. Start oscii-bot.
6. Have fun

Changing the mapping

The script contains two arrays: faders and buttons which contain the osc mapping. This can be changed to anything you like. The array indices directly map to the midi codes sent by the apc. The faders from left to right have midi codes 48 to 56. The button matrix uses midi codes 0 to 63. The buttons on the bottom use codes 64 to 71 and the ones on the side use 82 to 89 and 98.

Be aware that the i at the beginning of the osc channel needs to remain. It is used by oscii-bot to set the type of the parameter. The osc channels of Onyx can be found here.