Tech tutorial

For a complete description of distributed music we recommend reading at least chapter four of the author's Ph.D. thesis. Regarding artistic challenges and the effect of latency please read chapter five. With respect to the current state of the art and Soundjack in particular please read our IEEE-Access publication (mainly Section IV). Alternatively read this tutorial below as a "quick start".

Please take a look at the videos below - they show you all the details of how to adjust the relevant parameters.

Installation guide

  • Register on
  • Once registered log in and click on Download tab
  • Download either Mac OSX, Linux or Windows depending on your system. Win users will need an ASIO sound device. If not existing please download the ASIO4ALL driver as well and install it:
  • Extract and open the downloaded file.
  • OSX / Windows: Run the soundjack application by doubleclicking on the binary file (Win: soundjack.exe / OSX:
  • Linux: In a terminal window cd to the extracted directory. You will find script files (.sh) files there, corresponding to different versions of Soundjack. Run one of them – ideally the latest. (You will need to terminate this using ctrl-c once you have finished the Soundjack session.)
  • Important: A small XLR Icon in your dock will show up. This confirms the soundjack engine is running and working fine. On Windows you will see an additional DOS-type console.
  • Once the plugin is running on your machine return to the sound jack website and click the stage tab

Interface layout description

Soundjack is a browser-based low-latency communication system available at the stage tab. The left of the interface shows the local engine specific parameters, which determine the stream settings and in turn the bandwidth capacity of the outgoing stream. The right shows the user list which is to be understood as a mixing console in horizontal layout. Each user corresponds to a channel strip. Enable the "play" button at the very right of the channel strip in order to connect with the specific user.


  • Once you have successfully ran the application you will need to set your drivers/settings within the web browser. This may take some tweaking.
  • Select your the desired input and output interface of the existing ones 
  • Select the sample buffer (if you’re experiencing audio issues try raising the sample size to the next higher)
  • Select send channels. These should correlate to the inputs of your interface. Example inputs 1+2 would use 2 send channels. If you had a mic on in1 and a guitar on in3 you’d most likely need to select 4 channels here.
  • Lastly choose your network buffer and OPUS bit rate. The higher the OPUS bit rate the higher the quality but subsequently the more data will be transmitted which could cause issues with slower Internet connections.
  • Establish a test connection with the existing audio mirrors within the user list. You will see the jitter buffer turning green and/or red depending on the stability of the connection. Adjust this value according to your needs.


Lower network buffers will lower latency but could also create issues with streaming quality. Network buffers will correspond to peers’ sample buffer. For example, if they have a higher sample buffer (512 for instance) you may not need as large of a network buffer your end (perhaps 128). The opposite would also be true if the sender is sending smaller packets (say 128) the network buffer may need to be increased. Unfortunately, due to the nature of the internet and individual hardware setups, there is no straight forward way to determine the optimal settings for everyone so you are encouraged to tweak these settings to find out what works best for your session. OPUS bit rate in short the higher the bit rate the better quality the audio. Linear is uncompressed. 96 kbps is compressed by a factor of 8, 48 kbps by a factor of 16 etc. One thing to keep in mind is that this is the quality of each individual track so the more tracks you have sending the greater the speed requirements. Example one track at 96 kbps will be sending as much information as 4 tracks at 24 kbps.

Chat (time zone: UTC)

Tamikaze - 15:32

Will being streaming for a bit for tests...wondering how long 10.9.5 will be supported...

jazzalex - 13:22

Hi Bernd, sorry, bin gerade in einer Dev-Session für die nächste Release. Können gern später sprechen/spielen.

WendyLJones - 13:14

111 Thanks @IAN!!!!!!

aw1000k - 12:15

Ok here goes. In a few mins I will be streaming my practicing with backing tracks. Location is central NY state. Let me know if you want to play along

aw1000k - 11:48

hello all. I'm hoping to do a real-time test from Ny state in US

NguyendowsXP - 02:43

isomorgan, is that you?

NguyendowsXP - 02:42

morgankcollin, is that you?

kgjames - 02:06

111 thanks to @Ian!!!!

pepperman33 - 21:12


CipeSongs - 18:25

Anyone playing blues or similar and want a guitarist?

LHLR - 07:37

Thank's that more clear. Have a good day I m trying to promote your product in France We are not a lot!

jazzalex - 07:33

For LAN usage you don't need port forwarding at all. For WAN you sometimes need it but you can forward to one machine only - that's a general forwarding principle.

LHLR - 07:30

Ok no problem with UDP port 50050 used by both @IP ? My box refuse to add a rule for the second @IP

jazzalex - 07:28

left side - fourth choice box from the top

jazzalex - 07:27

Simply hit the "play" button for this user in the same LAN. Ideally switch the local network interface to VPN - this will ensure that the private IP is used.

LHLR - 07:26

My config is fine with my desktop and port forwarding is correct with my @IP. I want to connect a second machine on my LAN. How to proceed in that case? Thanks for your help

JamTuner - 07:25

hi lhlr

JamTuner - 07:24

on my machine , hovering the cursor over the jitter box triggers the tooltip but it isn't consistant- I would think that you we shouldn't have to "hunt" to make tooltip appear

LHLR - 07:23


JamTuner - 07:20

trying to make the tooltip "stick" now, it is not happening

soulalex - 07:20

If you have one tooltip visible it should fade off after 2 seconds.

soulalex - 07:19

Ah ! Probably you tried before relaunching the STAGE.

soulalex - 07:19

No in terms of reproducing or in terms of fading after 2 seconds :-) ?

JamTuner - 07:19

now it is not happening

JamTuner - 07:16


soulalex - 06:58

Can you reproduce this ? Does the tooltip fade after 2 seconds for you ?

JamTuner - 06:51

refreshing page clears the tip

JamTuner - 06:49

JamTuner - 06:48

tooltip staying visible over another "layer" of same tooltip :)

JamTuner - 06:47

"Set jitter buffer size – lower values lead to lower latency but also to higher probability of audio drop outs"

JamTuner - 06:46

got one stuck right now

jazzalex - 06:31

Modified the tooltip functionalilty. Please check if it still stays visible in some use cases.

lberger - 02:52


pronick - 00:18

connect to me if you need a drummer

pronick - 00:17

anyone need a drummer

Brian144 - 23:19

New user here. Would love to chat or improvise with anyone who wants to stop by. I have my flute and tenor sax at the ready.

LaurenMikeal - 20:57

It won't let me see room 8?

fortepianist - 20:54

handbellguy: I'm in room 8 but can't connect with you

LaurenMikeal - 20:39

fortepiano - i am free when you get back

handbellguy - 20:06

Amy, reenter the stage


We use cookies on our website. Some of them are essential for the operation of the site, while others help us to improve this site and the user experience (tracking cookies). You can decide for yourself whether you want to allow cookies or not. Please note that if you reject them, you may not be able to use all the functionalities of the site.