The following are instructions for compiling Jacktrip from source. Compiling from source is the best way to keep up with the latest changes, both stable and experimental. For quicker ways to install Jacktrip, go to README.md in the root directory of the project.
- C++ compiler
RtAudio is no longer a dependency. You might want to skip the steps you don't need.
Install Jack2 https://jackaudio.org/downloads/
If this command returns the XCode version, you have it installed:
If this command returns the version number of the package manager Homebrew, you have it installed:
/bin/bash -c "$(curl -fsSLhttps://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
To install git if you don't have it:
brew install git
Install and link qt5:
brew install qt5 brew link qt5 --force
Clone the git repo and run
./build in the src directory or use QtCreator to compile
You can compile using the build script or QtCreator.
To clone the repo in the Terminal: $ git clone --recurse-submodules https://github.com/jacktrip/jacktrip.git
To compile using the build script:
$ cd jacktrip $ ./build $ cd builddir $ ls
You should see a
jacktrip executable in this folder.
If the build script doesn't work, try building the Makefiles yourself. You'd need qmake. Then you can build by:
$ qmake jacktrip.pro $ make release
To build using QtCreator:
- Open jacktrip.pro using QtCreator
- Choose a correctly configured Kit
QtCreator places the
jacktrip executable by default in a folder
with a name like
You need to have a working Jack installation on your machine (see Dependencies above).
To install using Terminal (skip the first three steps if you've already followed the Build instructions above):
$ git clone --recurse-submodules https://github.com/jacktrip/jacktrip.git $ cd jacktrip $ ./build $ cd builddir $ sudo cp qjacktrip /usr/local/bin/ (enter your password when prompted) $ sudo cp jacktrip /usr/local/bin/ $ sudo chmod 755 /usr/local/bin/qjacktrip (now you can run jacktrip from any directory using Terminal)
If you have installed jacktrip, from anywhere in the Terminal, type:
$ jacktrip -v
If you have compiled from source without installing, in the /builddir directory type:
$ ./jacktrip -v
If you see something like this, you have successfully installed Jacktrip:
JackTrip VERSION: 1.xx Copyright (c) 2008-2020 Juan-Pablo Caceres, Chris Chafe. SoundWIRE group at CCRMA, Stanford University