Installation instructions for zita-jacktools.
=============================================


********* IMPORTANT NOTICE FOR VERSION 1.7.2 ************

This release requires zita-jclient-0.5.2 or higher.
The new 'freewheel' classes will fail silently with
older versions of zita-jclient.


********* IMPORTANT NOTICE FOR VERSION 1.6.0 ************

If you have a previous version installed, some manual
intervention is required. There are two reasons for
this:

* The package has been renamed from 'jacktools' to
  'zita_jacktools'.

* The use of setuptools instead of distutils to create and
  install the package.

This has two consequences:

* Before installation you must (as root) delete everything
  relating to jacktools < 1.6.0 in the Python site-packages 
  directory. Failing to do so will result in an installation
  that fails to work.

* After installation you will have to modify the import
  statements in existing applications so they use the new
  package name.

*********************************************************


Apart from the zita_jacktools tarball, you will need:

* Python, numpy
  The library may work with Python 2.7, but the examples
  all use Python 3. Note that the official Python 2 sunset
  was February 2020.

* libraries (and headers):

   * fftw3
   * zita-jclient
   * zita-resampler
   * zita-convolver

Install the required libraries first.
Then in the top directory: make; sudo make install.

Copy the examples directory to somewhere in your
home directory.

To run some of the examples you may need:

   * jaaa, jack_utils, jnoisemeter, zita-audiotools
   * scipy, matplotlib, pyqt5



A FOP (Frequently Occurring Problem) and its solution.
------------------------------------------------------

When you install shared libraries (e.g zita-jclient)
from source they will end up in /usr/local/lib or in
/usr/local/lib64.

Linux systems are usually not configured to look for
libraries in /usr/local, so things will fail.

The solution is simple. Do the following as root:

1. In the directory /etc/ld.so.conf.d, create a file
   called local.conf. This file should contain two
   lines:

/usr/local/lib
/usr/local/lib64

2. Run the command ldconfig.

If this doesn't help, reboot.

--
FA


