Netjack under OSX

Download and install JackOSX

Download and install the version of JackOSX that corresponds to the version of OSX you are running.

The most up to date versions are in the JackOSX web site itself. Go to the download page and select the installer that corresponds to your OSX version.

You could also go to the Jack Audio Connection Kit download page, and download from there, but versions might be older than the ones in JackOSX.com.

Open the downloaded file with the archive utility. It will unpack the download and show you the installer package. Double click on it and install the package. This will add to your computer:
  • the jack server
  • the JackRouter application (enables any OSX Core Audio application to become a Jack client)
  • the jack audio plugins (AU and VST jack-aware audio plugins)
  • the JackPilot application (a GUI front end to the jack server)
  • (only for newer versions of JackOSX) the Qjackctl Jack control panel
You will need to restart your computer after the install.

Download and install Qjackctl

First check to see if Qjackctl was already installed, as it is part of the newer versions of JackOSX, if so please skip this step...

Qjackctl is a very convenient Jack GUI front end that is the default interface for Jack in Linux. There are binaries in the Ardour web site but not of the latest version (go to http://www.ardour.org). You can download a current version with "netone" driver support from here:
Which one to use depends the version of JackOSX you installed in the previous step. This is a preliminary build (2010.10.29), improvements to come later.

Open the dmg file and drop the Qjackctl application bundle into your Applications folder.

Connecting your computer to OpenMixer

Make sure that you have configured your laptop to use DHCP so it automatically gets an IP address from the OpenMixer computer. Connect your laptop to one of the four ethernet ports in the Listening Room equipment rack (use one of the yellow ethernet cables). Once you are connected you should be able to access the Internet (fire up a browser and test the connection - and make sure you are not connected through wireless only!).

Running Jack through Qjackctl

Qjackctl is a GUI front end for Jack. After starting it you should see its main window:


 You will need to configure it before starting Jack!

Click on the "Setup" button and change:
  • "Server Path" to /usr/local/bin/jackd
  • "Driver" to "netone"
You can leave the rest alone for now.


Close the "Setup" dialog and click on "Start". If your firewall is running (and this is the first time you run Jack with the "netone" driver) you will be prompted to allow incoming connections from jackdmp:


Click on "Allow" and Jackd will finish starting up since it can now connect to the Netjack server running on the OpenMixer computer. If you click on "Messages" you will see that Jack is now running with a period size of 256 frames and it has 24 input and output channels (and 1 MIDI channel as well), which matches the default configuration of the OpenMixer Netjack servers.

Click on the "Connect" button to show the connections window:


You can click on each client to show individual channels and you can drag connections from the left pane to the right pane. Very easy. But before you start to connect applications together you have to let your Mac know that it should send Core Audio audio to Jack itself...

Setting the number of channels JackRouter will have

Start JackPilot (in the "Applications" "Jack" folder) and open the Preferences panel.


Set the number of channels that Core Audio will see in the "Virtual Input Channels" and "Virtual Output Channels" fields. You will need to modify this if you want to use Core Audio apps with multichannel outputs (more than the default of stereo). You should set "VIrtual Input Channels" and "Virtual Output Channels" to 24.

Routing Core Audio to Jack

Now go to your "System Preferences" and then "Sound" and you will see an entry for "JackRouter" in both the input and output tabs.


Click on "JackRouter" to send audio from Core Audio OSX programs to Jack. You can do the same for the "Input" tab. Start an OSX program and you should get audio from it through the Netjack connection.

Of course you will need to have selected the "netjack" source in OpenMixer and set a default preset for a default routing in OpenMixer to hear sound.

Running Jack through JackPilot (optional)

JackPilot is included in JackOSX and is a GUI front-end to Jack. NOTE: you can't start Jack with the "netone" driver from JackPilot as it does not yet include support in its GUI for it (use Qjackctl instead or start jackd from a terminal).

If you start it with Jack already running you will see its main window. You will see how much CPU Jack is currently using:


Click on "Routing" and you should see "system" ports for input (Receive) and output (Send) in the "Connections Manager" dialog:


Click on the port to open it up and show the individual channels. Both "system" ports should have 24 channels. In the Jack world "system" ports normally point to your soundcard, in this case they are input / output connections to OpenMixer.

Route your channels in the "Routing / Connections Manager" window by clicking on the "Send Port" that corresponds to the application that is generating audio, and then on one of the channels. The select the "system" "Receive Port" and double click on the channel that you want to connect to. You can route any channel from any application to any output channel in the Listening Room. This picture shows a simple stereo connection to the first two channels from Itunes: