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