cadence/INSTALL.md

2.2 KiB

--- INSTALL for Cadence ---

To install Cadence and its tools, simply run as usual:
$ make
$ [sudo] make install

You can run the tools without installing them, by using instead:
(Replace '<tool>' by a proper name, in lowercase. Some distros may need to use 'python' here)
$ make
$ python3 src/<tool>.py

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
  • Qt5
  • PyQt5 (Py3 version)

On Debian and Ubuntu, use these commands to install all build dependencies:
$ sudo apt-get install libjack-jackd2-dev qtbase5-dev qtbase5-dev-tools
$ sudo apt-get install python3-pyqt5 python3-pyqt5.qtsvg pyqt5-dev-tools

To run all the apps/tools, you'll additionally need:

  • python3-dbus
  • python3-dbus.mainloop.qt

Optional but recommended:

  • a2jmidid
  • jack-capture
  • pulseaudio[-module-jack]

The 'Cadence' app relies on jackdbus 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 and tested is python3.2. Older versions won't work!
After install, the app/tools will still work on distributions with python2 as default, without any additional work.


===== RUNTIME DEPENDENCIES =====

All tools require Python3 and Qt5 (PyQt5).
Here's the required run-time dependencies of each of the main tools:

Cadence

Requires jack
Recommends a2jmidid (>= 7) and jackdbus
Suggests pulseaudio[-module-jack]

Cadence-JackMeter

Requires jack

Cadence-JackSettings

Requires jackdbus

Cadence-Logs

No special requirements

Cadence-Render

Requires jack-capture

Cadence-XY Controller

Requires jack

Catarina

No special requirements

Catia

Requires jack
Recommends a2jmidid (>= 7) and jackdbus

Claudia [Linux only]

Requires jackdbus and ladish
Recommends a2jmidid