1JACKTRIP(1) User Commands JACKTRIP(1)
2
3
4
6 JackTrip - manual page for JackTrip VERSION: 1.7.0
7
9 jacktrip [-s|-c|-S|-C hostIPAddressOrURL] [options]
10
12 JackTrip: A System for High-Quality Audio Network Performance over the
13 Internet Copyright © 2008-2022 Juan-Pablo Caceres, Chris Chafe. Sound‐
14 WIRE group at CCRMA, Stanford University This build of JackTrip is sub‐
15 ject to LGPL license. JackTrip source code is released under MIT and
16 GPL licenses. See LICENSE.md file for more information. VERSION:
17 1.7.0
18
20 REQUIRED ARGUMENTS: One of:
21 -s, --server
22 Run in P2P Server Mode
23
24 -c, --client <peer_hostname_or_IP_num>
25 Run in P2P Client Mode
26
27 -S, --jacktripserver
28 Run in Hub Server Mode
29
30 -C, --pingtoserver <peer_name_or_IP>
31 Run in Hub Client Mode
32
33 OPTIONAL ARGUMENTS:
34 -n, --numchannels #
35 Number of Input and Output Channels (# greater than 0, default:
36 2)
37
38 --receivechannels #
39 Number of receive Channels from the network (# greater than 0)
40
41 --sendchannels #
42 Number of send Channels to the network (# greater than 0)
43
44 -q, --queue # (2 or more)
45 Queue Buffer Length, in Packet Size (default: 4)
46
47 -r, --redundancy # (1 or more)
48 Packet Redundancy to avoid glitches with packet losses (default:
49 1)
50
51 -o, --portoffset #
52 Receiving bind port and peer port offset from default 4464
53
54 -B, --bindport #
55 Set only the bind port number (default: 4464)
56
57 -P, --peerport #
58 Set only the peer port number (default: 4464)
59
60 -U, --udpbaseport
61 Set only the server udp base port number (default: 61002)
62
63 -b, --bitres # (8, 16, 24, 32)
64 Audio Bit Rate Resolutions (default: 16, 32 uses floating-point)
65
66 -z, --zerounderrun
67 Set buffer to zeros when underrun occurs (default: wavetable)
68
69 -t, --timeout
70 Quit after 10 seconds of no network activity
71
72 -l, --loopback
73 Run in Loop-Back Mode
74
75 -j, --jamlink
76 Run in JamLink Mode (Connect to a JamLink Box)
77
78 -J, --clientname
79 Change default client name (default: JackTrip)
80
81 -K, --remotename
82 Change default remote client name when connecting to a hub
83 server (the default is derived from this computer's external
84 facing IP address)
85
86 --appendthreadid
87 Append thread ID to client names
88
89 -L, --localaddress
90 Change default local host IP address (default: 127.0.0.1)
91
92 -D, --nojackportsconnect
93 Don't connect default audio ports in jack
94
95 --bufstrategy # (0, 1, 2)
96 Use alternative jitter buffer
97
98 --broadcast <broadcast_queue>
99 Duplicate receive ports with the specified broadcast_queue
100 length. Broadcast outputs have higher latency but less packet
101 loss.
102
103 --udprt
104 Use RT thread priority for network I/O
105
106 OPTIONS FOR AUDIO PATCHING IN HUB SERVER MODE:
107 -p, --hubpatch # (0, 1, 2, 3, 4, 5)
108 Hub auto audio patch, only has effect if running HUB SERVER
109 mode, 0=server-to-clients, 1=client loopback, 2=client fan
110 out/in but not loopback, 3=reserved for TUB, 4=full mix, 5=no
111 auto patching (default: 0)
112
113 -i, --includeserver
114 Include audio to and from the server in the mix when patching.
115 Only affects -p 2 (client fan out/in but not loopback) and -p 4
116 (full mix) patch modes.
117
118 -u, --upmix
119 Upmix mono clients to stereo when patching
120
121 OPTIONAL SIGNAL PROCESSING:
122 -f, --effects # | paramString | help
123 Turn on incoming and/or outgoing compressor and/or reverb in
124 Client - see `-f help' for details
125
126 -O, --overflowlimiting i|o[w]|io[w]|n|help
127 Use audio limiter(s) in Client, i=incoming from network, o=out‐
128 going to network, io=both, n=no limiters, w=warn if limiting
129 (default=n). Say -O help for more.
130
131 -a, --assumednumclients help|# (1,2,..)
132 Assumed number of Clients (sources) mixing at Hub Server (other‐
133 wise 2 assumed by -O)
134
135 ARGUMENTS TO USE JACKTRIP WITHOUT JACK:
136 -R, --rtaudio
137 Use system's default sound system instead of Jack
138
139 -T, --srate #
140 Set the sampling rate, works on --rtaudio mode only (default:
141 48000)
142
143 -F, --bufsize #
144 Set the buffer size, works on --rtaudio mode only (default: 128)
145
146 --audiodevice "input-output device name"
147
148 --audiodevice "input device name","output device name"
149
150 --audioinputdevice "input device name"
151
152 --audiooutputdevice "output device name"
153 Set audio device to use; if not set, the default device will be
154 used
155
156 --listdevices
157 List available audio devices
158
159 -d, --deviceid #
160 Set rtaudio device id (DEPRECATED, use --audiodevice instead)
161
162 ARGUMENTS TO DISPLAY IO STATISTICS:
163 -I, --iostat <time_in_secs>
164 Turn on IO stat reporting with specified interval (in seconds)
165
166 -G, --iostatlog <log_file>
167 Save stat log into a file (default: print in stdout)
168
169 -x, --examine-audio-delay <print_interval_in_secs> | help
170 Print round-trip audio delay statistics. See `-x help' for de‐
171 tails.
172
173 ARGUMENTS TO SIMULATE NETWORK ISSUES:
174 --simloss <rate>
175 Simulate packet loss
176
177 --simjitter <rate>,<d>
178 Simulate jitter, d is max delay in packets
179
180 ARGUMENTS FOR HUB CLIENT/SERVER AUTHENTICATION:
181 -A, --auth
182 Use authentication on the client side, or require it on the
183 server side
184
185 --certfile
186 The certificate file to use on the hub server
187
188 --keyfile
189 The private key file to use on the hub server
190
191 --credsfile
192 The file containing the stored usernames and passwords
193
194 --username
195 The username to use when connecting as a hub client (if not sup‐
196 plied here, this is read from standard input)
197
198 --password
199 The password to use when connecting as a hub client (if not sup‐
200 plied here, this is read from standard input)
201
202 HELP ARGUMENTS:
203 -v, --version
204 Prints Version Number
205
206 -V, --verbose
207 Verbose mode, prints debug messages
208
209 -h, --help
210 Prints this Help
211
213 Copyright © 2008-2022 Juan-Pablo Caceres, Chris Chafe. SoundWIRE group
214 at CCRMA, Stanford University This build of JackTrip is subject to LGPL
215 license. JackTrip source code is released under MIT and GPL licenses.
216 See LICENSE.md file for more information.
217
218
219
220JackTrip VERSION: 1.7.0 January 2023 JACKTRIP(1)