Before you begin
Make sure you have at least Java 2 Platform Standard Edition Runtime Environment 5 (J2SE 5) installed. If you haven't than grab the latest version at http://java.sun.com/javase/downloads/.
If you are on Windows you also want to get a Midi loopback driver (try MidiYoke - it's free). This allows you to route all your Midi devices to Kable and use the loopback device to send the processed result to other software.
Installing Kable
To install Kable you just have to unzip the downloaded package somewhere on your hard drive. Make sure the target folder is writable by the software as there will be some configuration files created when the application is running.
Don't extract it into the folder of a previous version!
Getting Started
Go into the installation folder and start Kable.exe. A little red cable icon will appear in the system tray bar. Right click it to bring up the context menu and select Open Designer to launch the Kable Designer.
In the Kable Designer choose File>New>Kable Diagram to create a new diagram and a corresponding model file. From the palette on the right side select an InputDevice and place it in the diagram editor (the big white area). In the Properties view click on the Name property and select one of the available input devices. If the done correctly the title of the component in the editor should change to the selected device. Turn a knob on the device you selected and you should see event messages appearing in the Console view reflecting the values sent by your input device.
Select a Gate or Transformer from the palette and place it in the editor area. If you like you can specify a title for the component. From the Tools menu activate Input Learn. Select the component you just created and move some controlls on your input device. The selected Gate or Transformer should now create a number of Conditions or Expressions acording to the values sent fromt the input device. Don't forget to deactivate Input Learn.
Now you can edit the created Conditons/Expressions or you can delete them or add new ones. To manually add a one you have to hover with your mouse curser over the Gate/Transformer component and wait until the Add Condition or Add Expression popup bar appears. Press the button to add a new Condition/Expression.
Please refer to the User Reference for details on how to specify Conditions and Expressions and the allowed fields and operators.
Finally add an OutputDevice just like you created the InputDevice and connect all components with the Connection tool from the palette. Make sure all components are connected and every Input and OutputDevice is connected (i.e. the title should not be "<...>").
Save your diagram and close the Kable Designer.
Right click the Kable tray icon and choose Configure.... In the Kable Runtime Configuration dialog press Add.. and select the .kar file you just created. The file will be opened and immediately processed, meaning that whatever you have configured there will now be applied to your devices.
More documentation available at http://kable.sourceforge.net/.