posts: add diagram for shared Guix profiles and store
[software/elephly-net.git] / static / lv2 / mdapiano.markdown
index 8abaf54b1cf3dc7ccac185936ecb7e4e93815a12..ccb1142ccff4f3ae43faa857171ffa840c0c537f 100644 (file)
@@ -4,10 +4,52 @@ This is an LV2 port of the mdaPiano VSTi (not to be confused with the
 [mdaEPiano](/lv2/mdaepiano.html)). The original VST that this port is based on
 was written by Paul Kellett.
 
-## Documentation
 
-TODO
+## Compiling
+
+To compile the mda Piano plugin, just execute the following statement:
+
+    make && sudo make install
+
+This will copy the compiled plugin to `/usr/local/lib/lv2`.  To change
+the target prefix, pass the `PREFIX` variable to `make`.
+
+To build the mda EPiano plugin, pass `TYPE=mdaEPiano` to `make`:
+
+    make TYPE=mdaEPiano
+    sudo make install TYPE=mdaEPiano
+
+**NOTE**: you will need the [lvtoolkit libraries](http://lvtoolkit.org) to
+compile this plugin.
+
+
+## Connecting
+
+You will need an LV2 host to use the plugin. I'm using `jalv.gtk`:
+
+    jalv.gtk http://elephly.net/lv2/mdaPiano
+
+You should now be able to connect your MIDI device to the plugin via JACK. Also
+don't forget to connect the plugin's stereo output to your system's outputs:
+
+    jack_connect system:playback_1 mdaPiano:left
+    jack_connect system:playback_2 mdaPiano:right
+
+I provide a simple connect script with the code which does these things
+automatically.
+
+
+## License
+
+The original mda VST plug-ins by Paul Kellett are released under the
+MIT license or under the GPL "either version 2 of the License, or (at
+your option) any later version". The LV2 ports of the mdaPiano and
+mdaEPiano plugins by rekado are released under GPLv3, or (at your
+option) any later version.
+
 
 ## Download
 
-[Fetch the source here](https://github.com/rekado/lv2-mdaPiano).
+[Fetch the source here](http://git.elephly.net/software/lv2-mdametapiano.git).
+The latest
+[release tarball can be downloaded here](http://git.elephly.net/software/lv2-mdametapiano.git/archive/0.0.2.tar.gz).