1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
|
# Build Instructions
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.
## Dependencies
- C++ compiler
- Qt5
- JACK
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:
```sh
xcodebuild -version
```
If you don't have XCode, go to the AppStore to download and install it.
If this command returns the version number of the package manager Homebrew, you have it installed:
```sh
brew -v
```
If you don't have Homebrew, install it:
```sh
/bin/bash -c "$(curl -fsSLhttps://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
```
To install git if you don't have it:
```sh
brew install git
```
Install and link qt5:
```sh
brew install qt5
brew link qt5 --force
```
Clone the git repo and run `./build` in the src directory or use QtCreator to compile
## Build
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:
```sh
$ 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:
```sh
$ 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 `build-jacktrip-Desktop_x86_darwin_generic_mach_o_64bit-Release/`.
## Installation
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):
```sh
$ 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)
```
### Verification
If you have installed jacktrip, from anywhere in the Terminal, type:
```sh
$ jacktrip -v
```
If you have compiled from source without installing, in the /builddir directory type:
```sh
$ ./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
|
