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