8b3a67fe229fda00055e4cdb45386b4a7e758b29
[terminatorX.git] / website / aseqjoy.xml
1 <?xml version='1.0' encoding='utf-8'?>
2 <!DOCTYPE section SYSTEM "./tX.dtd">
3 <section name='aseqjoy'>
4   <aseqjoy>
5     <para>
6     <bold>aseqjoy</bold>is a 
7     <italic>Joystick to ALSA MIDI Sequencer Converter</italic>. In fact it's a
8     really tiny piece of software that turns a joystick into a MIDI controller
9     for the 
10     <link ref='http://www.alsa-project.org'>ALSA</link> sequencer
11     infrastructure. I mainly wrote it to test the new MIDI interface of
12     terminatorX but then I thought it might be useful with other scenarios and
13     applications, too.</para>
14     <para>For a more detailed description on what it does and how to use it
15     have a look the 
16     <link ref='aseqjoy-man.html'>manpage</link>.</para>
17     <para>If you want to test it yourself download the source: 
18     <link ref='aseqjoy-0.0.1.tar.gz'>aseqjoy-0.0.1.tar.gz</link> (Sorry no
19     binaries - but it's so small it only takes seconds to compile it yourself
20     :) Compiling aseqjoy requires kernel and ALSA (asound library) headers to
21     be installed.</para>
22     <para>To compile and install it's really just the simple:</para>
23     <para>
24       <screen>tar xzf aseqjoy-0.0.1.tar.gz &amp;&amp; cd aseqjoy-0.0.1
25       &amp;&amp; ./configure &amp;&amp; make &amp;&amp; make install</screen>
26     </para>
27     <para>To make full use of aseqjoy you might require jscal from the Vojtech
28     Pavlik's 
29     <link ref='http://atrey.karlin.mff.cuni.cz/%7Evojtech/joystick/'>joystick
30     package</link> (to calibrate your joystick) and Robert Ham's 
31     <link ref='http://pkl.net/%7Enode/alsa-patch-bay.html'>
32     alsa-patch-bay</link> or aconnect from the 
33     <link ref='http://www.alsa-project.org'>alsa-utils</link> package to connect
34     aseqjoy's MIDI output port to other input ports.</para>
35     <para>aseqjoy is distributed under the terms of the 
36     <link ref='COPYING'>GNU General Public License V2</link>.</para>
37   </aseqjoy>
38 </section>