bionic (1) aseqjoy.1.gz

NAME

       aseqjoy - Joystick to ALSA MIDI Sequencer Converter

SYNOPSIS

       aseqjoy [options]

DESCRIPTION

       Aseqjoy  maps  each axis of a joystick device to a specific MIDI controller. Moving the joystick along an
       axis will cause aseqjoy to emit MIDI controller messages via ALSA's  sequencer  API.  The  value  of  the
       controller  message  represents  the  joystick's position along the axis (eg ´left´ -> 0, ´middle´ -> 63,
       ´right´ -> 127). Note that you can run aseqjoy with the ´-r´ commandline switch to use fine MIDI  control
       change messages instead (with 14 bit resolution).

       Aseqjoy  uses  the  ALSA sequencer API to emit the MIDI events. Therefor it creates and output port named
       after joystick used. You can then use for example aconnect, QjackCtrl or the alsa-patch-bay to connect an
       aseqjoy instance to an input port of your choice.

       Note: Some joysticks may have to be calibrated (with jscal) before they can be used efficiently.

OPTIONS

       -h     Display help info

       -d [joystick]
              Select  the  joystick  to  use  for aseqjoy, where [joystick] is an integer value from from 0 to 3
              effectivley selecting devices js0 to js3.

       -v     Verbose mode - aseqjoy will output information about the MIDI events sent.

       -0 [controller]
              Select the MIDI controller ID for axis 0. As a default value aseqjoy will use 10 + the axis ID, so
              for axis 0 that would be 10 + 0 = 10.

       -1 [controller], -2 [controller], -3 [controller],
              Just like -0 this will set the controller IDs for axes 1, 2, 3.

       -r     Use fine MIDI control change messages instead (14 bit insstead of 7 bit resolution).

OPERATION

       After  aseqjoy  has  started  successfully all motion detected by the selected joystick device will cause
       MIDI controller messages to be emitted via the corresponding ALSA sequencer output port.  The  controller
       IDs are either the default values (10, 11, 12 ...) or the ones given as commandline options.

       Pressing  a  joystick  button  will  cause  aseqjoy to switch the MIDI channel. On startup channel '1' is
       selected. Pressing joystick button 2 will cause channel 2 to be selected. Other buttons work accordingly.

LICENSE

       aseqjoy comes under the terms of the GNU General Public License Version 2 or (at your option)  any  later
       version - for details please refer to the file COPYING included with the aseqjoy source code.

AUTHOR

       Man page and software by Alexander Koenig <alex@lisas.de>.

SEE ALSO

       jscal(1), aconnect(1)