INSTALL.txt 2.06 KB
Newer Older
jcaceres's avatar
jcaceres committed
1
jmess : Build Instructions for Linux and MacOS X
jcaceres's avatar
jcaceres committed
2

3
4
5
jmess can save an XML file with all the current jack connections. This same file can
be loaded to connect evrything again. The XML file can also be edited.
It alse also has the option to disconnect all the clients.
jcaceres's avatar
jcaceres committed
6

jcaceres's avatar
jcaceres committed
7
---
jcacerec's avatar
jcacerec committed
8
MacOS X (10.4 or higher) Installation:
jcaceres's avatar
jcaceres committed
9

jcacerec's avatar
jcacerec committed
10
If you are installing on MacOS X, a binary is provided.  You just need to have JackOSX installed on your machine
jcaceres's avatar
jcaceres committed
11
12
13
14
15
16
17
18
19
20
http://www.jackosx.com/

TO install (using Terminal): go to bin/ directory and type:

   sudo cp jmess /usr/bin/
   (enter your password when prompted)

   sudo chmod 755 /usr/bin/jmess
   (now you can run jmess from any directory using Terminal)

21
---
jcaceres's avatar
jcaceres committed
22
23
Dependencies:

24
25
26
27
You need to have installed the libraries in your system:
qt4-devel
jack-audio-connection-kit-devel

jcacerec's avatar
jcacerec committed
28
If you are using yum (in Fedora Core 12 for example) you can just install
29
them (as root) with:
jcaceres's avatar
jcaceres committed
30
yum install qt4-devel jack-audio-connection-kit-devel
31

jcaceres's avatar
jcaceres committed
32
33
34
35
36
37
38

If you want to build on MacOS X, you need JackOSX
http://www.jackosx.com/
and Qt 4.2 or higher. A Binary installer is porvided at:
http://www.trolltech.com/download?target=ftp://ftp.trolltech.com/qt/source/qt-mac-opensource-4.3.0.dmg


39
40
41
---
Build:

jcacerec's avatar
jcacerec committed
42
to build on Linux or Mac OS X, just go to the /src directory and type the following two command:
jcaceres's avatar
jcaceres committed
43

jcacerec's avatar
jcacerec committed
44
   ./build
jcaceres's avatar
jcaceres committed
45

jcacerec's avatar
jcacerec committed
46
						    
jcaceres's avatar
jcaceres committed
47
If evreything works fine, you will have the excecutable jmess ready to use. It is located at the ../bin directory. If you wish, you can install it in your system. Just type (as root):
48

jcaceres's avatar
jcaceres committed
49
   make install
50
51

If you want to uninstall:
jcaceres's avatar
jcaceres committed
52
53
54

   make uninstall

55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70

---
Usage:

For a list a commands, just type:
./jmess

If you want to save your current connections (connected with qjackctl for example)
just type:

./jmess -s filename.xml

All your connections are saved in filename.xml.

If you want to load them:
./jmess -c filename.xml
jcacerec's avatar
jcacerec committed
71
						    
72
73
74
75
76
77
78
And if you first want to disconnect all and the load the saved connections:
./jmess -d -c filename.xml

If you just want to disconnect all:
./jmess -d


jcaceres's avatar
jcaceres committed
79
---
80
Juan-Pablo Caceres
jcaceres's avatar
jcaceres committed
81
82
83
Please contact me with bugs, suggestions at:
jcaceres [at] ccrma [dot] stanford [dot] edu