If you just cloned the git repository, make sure you also cloned the submodules, which you can do using:

$ git submodule update --init

Building

Build dependencies

The required build dependencies are: (devel packages of these)

• PyQt6 (or PyQt5)
• Qt6 dev tools (or Qt5 dev tools)
• qtchooser (only for translations)
• qttools5-dev-tools (only for translations, works for Qt5 and Qt6)

The difficulty with Qt6 build (which is the default), is sometimes to get the lrelease executable. By chance, the compilation should work even if these tool is supposed to work with Qt5.

On Debian and Ubuntu, use these commands as root to install all build dependencies:

• for Qt6 build:

$ [sudo] apt install pyqt6-dev-tools qt6-base-dev-tools qtchooser qttools5-dev-tools

• for Qt5 build:

$ [sudo] apt install pyqt5-dev-tools qtchooser qttools5-dev-tools

To build Patchance, simply run as usual:

$ make

if you prefer to build it with Qt5:

$ QT_VERSION=5 make

Depending of the distribution you might need to use the LRELEASE variable to build. If you don't have 'lrelease' executable but 'lrelease-qt5' use:

$ make LRELEASE=lrelease-qt5

Installing

To install Patchance, simply run as usual:

$ [sudo] make install

Packagers can make use of the 'PREFIX' and 'DESTDIR' variable during install, like this:

$ [sudo] make install PREFIX=/usr DESTDIR=./test-dir

Uninstalling

To uninstall Patchance, run:

$ [sudo] make uninstall

Runtime dependencies

To run it, you'll additionally need:

• qt6-svg-plugins (or probably libqt5svg5 for Qt5)
• python3-pyqt6 (or python3-pyqt5 for Qt5)
• python3-pyqt6.qtsvg (or python3-pyqt5 for Qt5)
• python3-qtpy
• python3-jack-client
• python3-pyliblo3 (or python3-liblo, depending on what is available)
• git (not absolutely required but highly recommended)
• python3-pyalsa (recommended)
• Roboto font family (used by default patchbay theme)

To install runtime dependencies on debian based systems, run:

[sudo] apt install qt6-svg-plugins python3-pyqt6 python3-pyqt6.qtsvg python3-qtpy python3-jack-client python3-pyalsa fonts-roboto

IMPORTANT: since python 3.11, because pyliblo has been totally abandonned by Dominic Sacre, for liblo you need to use the following fork:

https://github.com/gesellkammer/pyliblo3

Simply install it with:

$ python3 -m pip install pyliblo3

Running

You can run Patchance without install, by using:

$ ./src/patchance.py