Jamulus Icon. Links to homepage
Open navigation

Command Line Options

Most common functions in Jamulus can be set using the GUI, but these and others can also be set using options given in a terminal window. Exactly how you do this will depend on your operating system.

For example on Windows, to have a client use a specific settings file, right-click on the Jamulus shortcut and choose “Properties” > Target. Add the necessary arguments to Jamulus.exe:

"C:\Program Files (x86)\Jamulus\Jamulus.exe" --inifile "C:\path\to\myinifile.ini"

For macOS, start a Terminal window and run Jamulus with the desired options like this:

 /Applications/Jamulus.app/Contents/MacOS/Jamulus --inifile "/path/to/myinifile.ini"

You can see all possible options your version supports by starting Jamulus with the -h option.

Note that the following options will not alter settings made in the GUI.

General settings (client and server modes)

ShortLong name[...] means optional parameterNotes
-h,-?--helpThis help text 
-i--inifileSet location of initialization file (overrides default)Client (always) and server (with GUI)
-n--noguiDisable GUI 
-p--portLocal UDP port number. Default is 22124 
-Q--qosSets the quality of service DSCP value. Default is 128. Disable with 0.QoS is ignored by Windows, but see Tips & Tricks for how to apply it.
-t--notranslationDisable translations 
-v--versionOutput version information and exit 

Server only

ShortLong name[...] means optional parameterNotes
-d--discononquitDisconnect all clients on quit 
-e--directoryserverMake the server public and sets its genre. See also -oSee server types
-f--listfilterWhitelist servers registering on the server list, format ip address 1[;ip address 2]Directory servers only. See note
-F--fastupdateReduces latency if clients connect with “Enable Small Network Buffers” option. Requires faster CPU to avoid dropouts, and more bandwidth to enabled clients. 
-l--logEnable logging, set path and file name 
-L--licenceShow an agreement window before users can connect 
-m--htmlstatusEnable HTML status file, set path and file name 
-o--serverinfoLocation details in the format: [name];[city];[locale value] (see values)Public servers only
-P--delaypanStart with delay panning enabledSee Server Setup
-R--recordingInclude a writeable path where the files should be stored (in quotes if needed).See Server Setup.
 --norecordDisable recording when enabled by default by -R 
 --serverbindipSpecify the IP address to bind to 

Client only

ShortLong name[...] means optional parameterNotes
-M--mutestreamStarts Jamulus in muted state 
 --mutemyownMute me in my personal mixHeadless only
-c--connectConnect to given server address on startup, format address[:port] 
-j--nojackconnectDisable auto JACK connections 
 --ctrlmidichMIDI controller channel to listen on, control number offset and consecutive CC numbers (channels). Format: channel[;f*][;p*][;s*][;m*]See Tips & Tricks
 --clientnameWindow title and JACK client name 

Tell us about Jamulus - take our anonymous survey!

This documentation is licensed under a Creative Commons Licence. Want to get involved?