INSTALL

   1 --------------------------
   2 -  INSTALL for Cadence  -
   3 ------------------------
   4
   5 To install Cadence and the other tools, simply run as usual:
   6 $ make
   7 $ [sudo] make install
   8
   9 You can also run the tools without installing them, by using instead:
  10 $ make
  11 $ python src/<tool>.py
  12 (Replace '<tool>' by a proper name, in lowercase. Some distros may need to use 'python2' here.
  13 Note that Carla can only be used when properly installed)
  14
  15 Packagers can make use of the 'PREFIX' and 'DESTDIR' variable during install, like this:
  16 $ make install PREFIX=/usr DESTDIR=./test-dir
  17
  18
  19 ===== [BUILD] DEPENDENCIES =====
  20 The required build dependencies are: [devel packages of these]
  21  - JACK
  22  - FluidSynth
  23  - liblo
  24  - Gtk2
  25  - Qt4
  26  - PyQt4
  27
  28 On Debian and Ubuntu, use this command to install all dependencies:
  29 $ sudo apt-get install libjack-dev libfluidsynth-dev liblo-dev libgtk2.0-dev libqt4-dev qt4-dev-tools python-qt4-dev pyqt4-dev-tools
  30
  31 To run all the apps/tools, you'll additionally need:
  32  - python-liblo
  33  - python-rdflib
  34  - python-xdg
  35  - xdg-utils
  36
  37 Optional but recommended:
  38  - a2jmidid
  39  - jack-capture
  40
  41 The 'Cadence' app requires a jackdbus version (either JACK1+DBus patch, or JACK2).
  42 Claudia is a LADISH frontend, so it will obviously require LADISH to run.
  43
  44 The python version used is python2. After install, the app/tools will still work on distros with python3 as default, without any additional work.
  45
  46
  47 ===== [RUNTIME] DEPENDENCIES =====
  48 All tools require Python and Qt, some of them work on Windows and Mac.
  49 Here's the required dependencies of each of the main tools:
  50
  51 ---> Cadence [Linux only]
  52 Requires DBus and jackdbus
  53 Recommends a2jmidid
  54 Suggests pulseaudio
  55
  56 ---> Catarina
  57 No special requirements
  58
  59 ---> Catia
  60 Recommends jackdbus and a2jmidid
  61
  62 ---> Claudia [Linux only]
  63 Requires python-xdg, xdg-utils, jackdbus and ladish
  64 Recommends a2jmidid
  65
  66 ---> Carla
  67 Requires python-rdflib for LRDF and LV2 support, although optional
  68
  69 ---> Carla-Control
  70 Requires python-liblo
  71
  72 ---> XY-Controller
  73 No special requirements
  74