Importing the sources - Alex
[terminatorX.git] / aseqjoy / README
1 aseqjoy is a simple Joystick -> MIDI controller converter. 
2
3 What it does: Each axis of the joystick device is mapped to a specific MIDI 
4 Controller. Moving the joystick along an axis will cause aseqjoy to emit
5 MIDI controller messages via ALSA's sequencer API. The value of the controller
6 message represents the joystick's position along the axis (eg 'left' -> 0, 
7 'middle' -> 63, 'right' -> 127).
8
9 aseqjoy uses the ALSA sequencer API to emit the MIDI events. Therefor it
10 creates and output port named after joystick used. You can then use for example
11 the alsa-patch-bay to connect an aseqjoy instance to an input port of your
12 choice. 
13
14 Requirements:
15 - Linux System with correctly configured Joystick support.
16 - A working ALSA 0.9 installation.
17
18 Links:
19 aseqjoy homepage: http://terminatorX.cx/aseqjoy
20 ALSA homepage: http://www.alsa-project.org
21 Input Utils: http://.cz
22 ALSA-patch-bay: http://
23
24 Howto:
25
26 Start aseqjoy - if you have a working Joystick (Nr. 0) aseqjoy will detect
27 that and each axis to a controller from 10 on upwards:
28
29 Axis -> Controller
30    0 -> 10
31    1 -> 11
32    2 -> 12
33    
34 From now on aseqjoy emits events over the "Joystick0" output port. To make use
35 of these events in another application use for example the alsa-patch-bay
36 to connect that output port to another application's input sequencer port
37 (for example the "terminatorX" input port for terminatorX). After you bound
38 the controllers to certain controls you should see how moving the joystick
39 affects the corresponding control.
40
41 Have Fun,
42 Alex