More README/INSTALL updates

INSTALL

@@ -1,79 +0,0 @@
---------------------------
--  INSTALL for Cadence  -
-------------------------
-
-To install Cadence and its tools, simply run as usual:
-$ make
-$ [sudo] make install
-
-You can also run the tools without installing them, by using instead:
-$ make
-$ python3 src/<tool>.py
-(Replace '<tool>' by a proper name, in lowercase. Some distros may need to use 'python' here)
-
-Packagers can make use of the 'PREFIX' and 'DESTDIR' variable during install, like this:
-$ make install PREFIX=/usr DESTDIR=./test-dir
-
-
-===== [BUILD] DEPENDENCIES =====
-The required build dependencies are: [devel packages of these]
- - JACK
- - liblo
- - Gtk2
- - Qt4
- - PyQt4
-
-Optional but recommended:
- - FluidSynth
- - LinuxSampler
-
-On Debian and Ubuntu, use this command to install all dependencies:
-$ sudo apt-get install libjack-dev liblo-dev libgtk2.0-dev libqt4-dev qt4-dev-tools python-qt4-dev pyqt4-dev-tools libfluidsynth-dev
-(NOTE: linuxsampler is not packaged in either Debian or Ubuntu, but it's available in KXStudio)
-
-To run all the apps/tools, you'll additionally need:
- - python3-dbus
- - python3-liblo
- - python3-rdflib
-
-Optional but recommended:
- - a2jmidid
- - jack-capture
-
-The 'Cadence' and 'Catia' apps rely on a jackdbus version to work properly (either JACK2 or JACK1 + DBus patch).
-Claudia is a LADISH frontend, so it will obviously require LADISH to run.
-
-The python version used is python3.
-After install, the app/tools will still work on distros with python2 as default, without any additional work.
-
-
-===== [RUNTIME] DEPENDENCIES =====
-All tools require Python3 and Qt4, some of them work on Windows and Mac.
-Here's the required run-time dependencies of each of the main tools:
-
----> Cadence
-Recommends a2jmidid and jackdbus
-Suggests pulseaudio
-
----> Catarina
-No special requirements
-
----> Catia
-Recommends a2jmidid and jackdbus
-
----> Claudia [Linux only]
-Requires jackdbus and ladish
-Recommends a2jmidid
-
----> Carla
-Requires liblo and Gtk2
-Recommends python3-rdflib (for LADSPA RDF support)
-
----> Carla-Control
-Requires python3-liblo
-
----> JACK-Meter
-No special requirements
-
----> XY-Controller
-No special requirements

INSTALL.md

@@ -0,0 +1,95 @@
+# ---  INSTALL for Cadence  ---
+
+To install Cadence and its tools, simply run as usual: <br/>
+`$ make` <br/>
+`$ [sudo] make install`
+
+You can also run the tools without installing them, by using instead: <br/>
+<i>(Replace '&lt;tool&gt;' by a proper name, in lowercase. Some distros may need to use 'python' here)</i> <br/>
+`$ make` <br/>
+`$ python3 src/<tool>.py`
+
+Packagers can make use of the 'PREFIX' and 'DESTDIR' variable during install, like this: <br/>
+`$ make install PREFIX=/usr DESTDIR=./test-dir`
+
+<br/>
+
+===== BUILD DEPENDENCIES =====
+--------------------------------
+The required build dependencies are: <i>(devel packages of these)</i>
+
+ - JACK
+ - liblo
+ - Gtk2
+ - Qt4
+ - PyQt4
+
+Optional but recommended:
+
+ - FluidSynth
+ - LinuxSampler
+
+On Debian and Ubuntu, use this command to install all dependencies: <br/>
+`$ sudo apt-get install libjack-dev liblo-dev libgtk2.0-dev libqt4-dev qt4-dev-tools python-qt4-dev pyqt4-dev-tools libfluidsynth-dev`
+
+NOTE: linuxsampler is not packaged in either Debian or Ubuntu, but it's available in KXStudio. <br/>
+<br/>
+
+To run all the apps/tools, you'll additionally need:
+
+ - python3-dbus
+ - python3-liblo
+
+Optional but recommended:
+
+ - a2jmidid
+ - jack-capture
+ - python3-rdflib
+
+The 'Cadence' and 'Catia' apps rely on a jackdbus version to work properly (either JACK2 or JACK1 + DBus patch). <br/>
+Claudia is a LADISH frontend, so it will obviously require LADISH to run.
+
+The python version used is python3. <br/>
+After install, the app/tools will still work on distros with python2 as default, without any additional work.
+
+<br/>
+
+===== RUNTIME DEPENDENCIES =====
+----------------------------------
+All tools require Python3 and Qt4, some of them work on Windows and Mac. <br/>
+Here's the required run-time dependencies of each of the main tools:
+
+### Cadence
+Recommends a2jmidid and jackdbus <br/>
+Suggests pulseaudio <br/>
+<br/>
+
+### Catarina
+No special requirements <br/>
+<br/>
+
+### Catia
+Recommends a2jmidid and jackdbus <br/>
+<br/>
+
+### Claudia [Linux only] <br/>
+Requires jackdbus and ladish <br/>
+Recommends a2jmidid <br/>
+<br/>
+
+### Carla
+Requires liblo and Gtk2 <br/>
+Recommends python3-rdflib (for LADSPA RDF support) <br/>
+<br/>
+
+### Carla-Control
+Requires python3-liblo <br/>
+<br/>
+
+### JACK-Meter
+No special requirements <br/>
+<br/>
+
+### XY-Controller
+No special requirements <br/>
+<br/>

README.md

@@ -1,6 +1,6 @@
 # ---  README for Cadence  ---
 
-Cadence is a set of tools useful for audio production.
+Cadence is a set of tools useful for audio production. <br/>
 It's being developed by falkTX, using Python and Qt (and some C++ where needed).
 
 The tools share the same base source code, so most of them look quite similar (which is intentional).
@@ -11,62 +11,60 @@ The basic modules are:
 -   cadence_render -> Record (or 'render') a JACK project using jack-capture, controlled by JACK Transport; supports realtime and freewheel modes.
 -   cadence_jacksettings -> Configure JACK (requires jackdbus, either JACK2 or JACK1 + DBus patch).
 
-Also, lots of custom widgets were coded when needed (like pixmapdial, pixmapkeyboard, patchcanvas and systray).<br/>
+Also, lots of custom widgets were coded when needed (like pixmapdial, pixmapkeyboard, patchcanvas and systray). <br/>
 They can be re-used in other projects. Contact the author if you need help on that.
 
 Note that the main focus goes to JACK2 (or JACK1+DBus); JACK1 (raw) and tschack are untested and may not work properly at this point.
 
-<br/>
 
 ===== DESCRIPTIONS =====
 ------------------------
-Here's a brief description of the main tools:<br/>
-<i>(Click on the tool name to open its respective documentation)</i>
+Here's a brief description of the main tools:
 
 ### [Cadence](http://kxstudio.sourceforge.net/KXStudio:Applications:Cadence)
-The main app. It performs system checks, manages JACK, calls other tools and make system tweaks.<br/>
+The main app. It performs system checks, manages JACK, calls other tools and make system tweaks. <br/>
 Currently under development, may change at anytime.
 
 ### [Catarina](http://kxstudio.sourceforge.net/KXStudio:Applications:Catarina)
-A Patchbay test app, created while the patchcanvas module was being developed.<br/>
-It allows the user to experiment with the patchbay, without using ALSA, JACK or LADISH.<br/>
+A Patchbay test app, created while the patchcanvas module was being developed. <br/>
+It allows the user to experiment with the patchbay, without using ALSA, JACK or LADISH. <br/>
 You can save & load patchbay configurations too.
 
 ### [Catia](http://kxstudio.sourceforge.net/KXStudio:Applications:Catia)
-JACK Patchbay, with some neat features like A2J bridge support and JACK Transport.<br/>
-It's supposed to be as simple as possible (there's Claudia for advanced things), so it can work nicely on Windows and Mac too.<br/>
+JACK Patchbay, with some neat features like A2J bridge support and JACK Transport. <br/>
+It's supposed to be as simple as possible (there's Claudia for advanced things), so it can work nicely on Windows and Mac too. <br/>
 Currently has ALSA-MIDI support in experimental stage (it doesn't automatically refresh the canvas when changes happen externally).
 
 ### [Claudia](http://kxstudio.sourceforge.net/KXStudio:Applications:Claudia)
-LADISH frontend; just like Catia, but focused at session management through LADISH.<br/>
-It has a bit more features than the official LADISH GUI, with a pretty preview of the main canvas in the bottom-left.<br/>
+LADISH frontend; just like Catia, but focused at session management through LADISH. <br/>
+It has a bit more features than the official LADISH GUI, with a pretty preview of the main canvas in the bottom-left. <br/>
 It also implements the 'Claudia-Launcher' add-application style.
 
 ### [Claudia-Launcher](#)
-A multimedia application launcher with LADISH support.<br/>
-It searches for installed packages (not binaries), and displays the respective content as a launcher.<br/>
-The content is got through an hardcoded database, created and/or modified to suit the target distribution.<br/>
+A multimedia application launcher with LADISH support. <br/>
+It searches for installed packages (not binaries), and displays the respective content as a launcher. <br/>
+The content is got through an hardcoded database, created and/or modified to suit the target distribution. <br/>
 Currently supports Debian and ArchLinux based distros.
 
 ### [Carla](http://kxstudio.sourceforge.net/KXStudio:Applications:Carla)
-Multi-plugin host for JACK.<br/>
-It has some nice features like automation of parameters via MIDI CCs (and send control outputs back to MIDI too) and full OSC control.<br/>
-Currently supports LADSPA (including LRDF), DSSI, LV2, and VST plugin formats, with additional GIG, SF2 and SFZ file support via FluidSynth and LinuxSampler.<br/>
+Multi-plugin host for JACK. <br/>
+It has some nice features like automation of parameters via MIDI CCs (and send control outputs back to MIDI too) and full OSC control. <br/>
+Currently supports LADSPA (including LRDF), DSSI, LV2, and VST plugin formats, with additional GIG, SF2 and SFZ file support via FluidSynth and LinuxSampler. <br/>
 This application is still under development and may change/break at anytime.
 
 ### [Carla-Control](#)
 An OSC Control GUI for Carla (you get the OSC address from the Carla's about dialog, and connect to it).<br/>
-Supports controlling main UI components (Dry/Wet, Vol and Balance), and all plugins parameters.<br/>
-Peak values and control outputs are displayed as well.<br/>
-Custom Plugin GUIs are not supported at this point.<br/>
+Supports controlling main UI components (Dry/Wet, Vol and Balance), and all plugins parameters. <br/>
+Peak values and control outputs are displayed as well. <br/>
+Custom Plugin GUIs are not supported at this point. <br/>
 NOTE: This application is not yet ported to this python3 branch
 
 ### [JACK-Meter](#)
-Simple JACK audio peak meter.<br/>
+Simple JACK audio peak meter. <br/>
 In the future it will be available in a plugin version, based on the DISTRHO project.
 
 ### [XY-Controller](#)
-Simple XY widget that sends and receives data from Jack MIDI.<br/>
-It can send data through specific channels and has a MIDI Keyboard too.<br/>
-This is more of a concept of my jacklib python module usage then anything else, may not work properly under very low JACK buffer sizes.<br/>
+Simple XY widget that sends and receives data from Jack MIDI. <br/>
+It can send data through specific channels and has a MIDI Keyboard too. <br/>
+This is more of a concept of my jacklib python module usage then anything else, may not work properly under very low JACK buffer sizes. <br/>
 In the future it will be available in a plugin version, based on the DISTRHO project.