These are answers to the current FAQs:


Complete instructions / quick start


  • 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 the TUTORIAL tab on this website as a "quick start". Please read the Support and communication rules FAQ below – we try to help where possible but we cannot discuss fundamental aspects with you. Distributed music is a complex domain which requires a certain degree of technical and artistic knowledge and the willingness to learn.




  • In some cases users do not receive the registration email. If so - please check your SPAM folder first. If it's not there it probably wasn't sent. In this case will manually enable your account after a couple of hours or probably days depending on the actual amount of work. In this case pleae try later to log in (we might probably inform you via email).




  • When you open Soundjack for the fist time you will see something like "This is an application of a non-verfied developer" and it won't launch. In this case please do the right-click and start Soundjack via "open" from the dropdown menu. Afterwards you can run it normally with the left-click as usual.


  • Starting wiht OSX 10.12 (and later) the input/output devices are accepted but sound is neither captured nor played back - the levelmeter does not move and there is no sound (and in case of video the app completely crashes). In this case make sure to move Soundjack to the applications and run the Security Settings of your OSX afterwards. There you can manually enable Soundjack to allow using the respective devices (audio and/or video). If it does not show up there or in case of other issues, start SJ via Terminal. Open the terminal and type: /Applications/soundjack.app/Contents/MacOS/soundjack. Alternatively (or ideally) you can run the Soundjack-Starter-Script (provided under the App download) which runs the SJC without any restriction (currently recommended).


  • For completely not known reasons on some OSX machines realtime performance is not provided if the SJC (the running app) is not the front finder app. If you experience very unstable audio in the receiver bring the SJC to the front.




  • On Windows the ASIO buffersize is not set automatically. Please make sure to set them yourself in the respective configuration panel.


  • On Windows some USB cards suffer from performance issues – please report if you encounter this problem as well


  • ASIO4ALL can be an alternative for a native ASIO driver, however, proper functionality is not granted which is why we can provide limited support only. Furthermore, numerous users don't find the configuration panel. Once you run  an ASIO4ALL configured session click on the "play" symbol in the dock (icons of running applications). Then the settings dialogue pops up, where you can adjust the in- and outputs for example. This is especially important in case your account does not turn green. In this case the in- and outputs have to be adjusted. Also note that ASIO4ALL does not allow more than one audio client at the same time - this includes system sounds etc. – the best choice is a native ASIO driver in any case.




  • Use the script in the main folder to run the SJC – e.g. ./SJC200524.sh


  • The current download might possibly not contain all the required libs. However, the system will tell you which ones and you can install them via "sudo apt-get instal <name-of-the-lib>".




  • Video is working in beta stage: It works fine for OSX if the SJC was launched with the Soundjack-Starter-Script (it crashes otherwise)  – on Linux and Windows it might not depeding on your hardware and OS. Please try and report what happens on your machine (incl. info about your OS).


  • Even if video works it could lead to crashes. In this case please switch the video off and figure if the video is the actual crash cause.


  • Don't use the Interleaved option at all and in terms of bandwidth please use the JPEG codec.


Audio configuration 


  • The channel selector below the loopback fader is in beta mode and has not been tested intensively yet - better don't use it – instead use either 1, 2, 4 or 8 channels in a bundle.


  • Inuilt devices work very well on OSX, work well on Linux but often cause performance issues on Windows. The recommendation is an external USB-Soundcard (e.g. Focusrite Scarlett Solo or Behringer U-Phoria).


  • Almost any new audio gear such as guitar processors etc. can be used as a sound card. However, most of them lead to performance issues. Please send a mail regarding your experience so we can create a list of working devices.


  • If you don't use an audio server and still run multiple audio applications at the same time it works on OSX. On Windows in some cases (and especially with ASIO4ALL), however, this will only process the sound of one application (without an error message). Other apps might provide VST plugins in order to connect these apps - Soundjack currently doesn't.


Audio server


  • If you want to run more than one audio application on your machine and locally want to route signals between then you have to use some kind of audio server and use it as in- and output device driver in each application.



  • Our current preference is JACK, which works as follows: In Soundjack adjust JACK as the in- and output device and do the same in your DAW. This way you access JACK with both applications and can now connect them within the JACK connection panel. With other audio servers it might be slightly different but this still describes the general principle.


  • When using an audio server make sure that everything is adjusted to 48 kHz sample rate. Also the audio channels and audibuffer (framesize) configuration must match for every connected audio application. Otherwise you will have strange effects.




  • Soundjack is a p2p streaming system. Capacity load in on the users' endpoint connection depending on the applied audio settings. In terms of streaming data there is no load on any of our servers. We also provide a server-based streaming which is currently in beta state and not available to the public.


  • Use a wired (no WIFI) connection to your router. This will result in most stable and low-latency audio streaming. With WIFI you will encounter a siginificant amount of audio dropouts, which can only be compensated with higher buffers and in turn higher latencies. Ideallay turn out any WIFI network or explicitly choose the wired endpoint in the list of available network interfaces.


  • The default settings of Soundjack with sample- and networkbuffer of 512 and a jitter buffer of 4 don't allow distant rhythmical interaction – they lead to 40 ms of latency with localhost already. You need to reduce these buffer and figure if your audio gear and network connection provide lower buffers. This varies from endpoint to endpoint. In ideal cases you can apply 128 or even 64 samples to the samplebuffer, 128 samples to the networkbuffer and a jitterbuffer of one single packet (better use 2 in any case) – this will lead to about 3 ms latency on localhost.


  • The final latency is determined by three parameters: Audio buffer and network buffer on the sending site (basically the size of the packet – in the SJC settings on the left) and the jitter buffer on the receiving site (the amount of packets stored before playback – green or red-flashing box within the user list on each entry).


  • The lower the network- and jitter buffer, the higher is the risk of the audio stream being disturbed by other Internet traffic (cross traffic). As a consequence make sure that other users in your LAN (any device such as notebooks, smartohones etc. behind your router) reduce Internet traffic to a minimum (ideally zero). This effect has a lower impact the more upload bandwidth is available at the Internet endpoint.


  • Not all routers allow incoming streams so connections will fail. In these cases UDP port forwarding (port 50000) is required. The process is described in the NAT-Traversal Video in the TUTORIAL. However, due to our experience with various users we can conclude that a number of routers don't forward packets although they claim to. Please try and report – we are willing to verify. Also make sure to either switch off any software firewall or generate an exception rule for it.


  • If you have applied your forwarding correctly but still Soundjack fails detecting the open port 50000 it is very likely that your Internet endpoint connection does not provide IPv4. In this case it basically does not work until we implemented an IPv6 endpoint support within Soundjack (already scheduled on TODO).


  • If you want to connect machines on a LAN Soundjack will only automatically pick the LAN IP only if both peers share the same public IP. If they don't it is required to enable the VPN call in the parameter settings on the left. When VPN is enabled Soundjack will choose the private IP in any case.


  • We support dedicated rehearsing spaces / rooms for a specific group of people. Simply create your own room at the right of the lock symbol and pick a password for it. Soundjack will assign a number for this room and it will show up in the list of available private rooms (also in the dropdown list beside the lock symbol). Inform your friends about the number and the password so they can pick this room. Afterwards only these player will be displayed in the list.


  • If you see message "SJ-Server down – nothing will work" first make sure that your TCP port 1234 is open and your browser supports websockets (try other browsers as well). If both is the case the server is down indeed.


  • If you launched the app and it says "FAILED CREATING WEBSOCKET" you either have another instance of the application running (please shut it down) or your OS does not support websockets. In this case you manually have to enable websocket support within your OS.


Support and communication rules


  • If you cannot get Soundjack to work fine contact the main author: This email address is being protected from spambots. You need JavaScript enabled to view it..  If we do not respond please don't take it personal. Then your question is ansered within the FAQ. Also respect proper language in any case. Users with a disrespectful, reproachful, racist or aggressive attitude will be warned once and thrown off the system after ignoration. 


  • In the Soundjack community share a rather informal style – we typically salute each other by our forename.


  • Long-term Soundjack User and Facebook Group Admin JamTuner often gives support via the Shoutbout, which we appreciate a lot – main developer Jazzalex does as well assuming time and leisure, however, please note that is impossible to answer every question. Please read the FAQ before asking.


  • If you report of a bug, a crash or other forms of disfunction please provide as much information as possible (under which conditions, after which amount of time, after application of which parameters etc.). A single info such as "it crashes" is completely useless to us. Ideally provide a short screen cast of what is happening on your machine as this is the most effective way to figure to actual problem.


  • If we spend our time to help you but cannot find a solution we will eventually ask you to access your machine via Teamviewer (http://www.teamviewer.com) or Anydesk (http://www.anydesk.com). This is the last chance to possibly fix your individual problem. If you are not confident with that we have to leave you alone with your problem.




Chat (time zone UTC-1)

rfiorentino - 15:33

JamTuner - that's ok, I finally figured it out! :) I had to turn my fader, on the left, all the way down.

JamTuner - 10:05

I am going afk - audio stream will play on unless something happens.

JamTuner - 01:38

Rocco- sorry I lost patience with you yesterday

JamTuner - 01:18

Everyone - I can't help if you don't engage :)

JamTuner - 01:05

it sounds lie your hardware/software set-up(s) are causing the client to crash.

JamTuner - 01:04

fiddleman and friend - if you give me some more detail about your interfaces and etc , I may be able to help you

JamTuner - 01:03

I am back and streaming audo for testing. Just connect to me :)

fiddleman - 00:35

Crashed again!

fiddleman - 00:34

CyClone.52 -- Once SoundJack crashes, I cannot get it to come back up!

fiddleman - 00:33

that didn't work!!!

JamTuner - 00:29

the audio tet stream is off for a while. I will resume it hen I can. meanwhile if you have questions, please ask ans try to stay around long enough for me to respond, or go to the facebookk soundjack

JamTuner - 23:56

I am streaming audo for testing. Just connect to me :)

JamTuner - 23:55

I am at my desk.

fiddleman - 23:37

CyClone.52. Lost you.

fiddleman - 23:23


JamTuner - 23:17

I am afk for maybe forty minutes.

JamTuner - 23:16

there is also a soundjack facebook group www.fhttps://www.facebook.com/groups/Soundjack

JamTuner - 23:15

fiddleman...I ave to go afk for a while, when I return , and you are still around, I will try to help you . I am This email address is being protected from spambots. You need JavaScript enabled to view it., or arne nordwall on Face Book

fiddleman - 23:10

The Apolo is now connected, but we still can't hear each other at all.

JamTuner - 23:01

Fiddleman- you friend has DL'd the SJ client properly and installed and opened it ( while not on the webpage) and the opened the browser page ?

JamTuner - 23:00

I use an apoolo quad , no problem for years :)

fiddleman - 22:59

Thanks -- My friend is having trouble getting either sent or received audio from his Apollo interface. It is connecting (and we are both GREEN), but his interface isn't even showing up on the dropdown

fiddleman - 22:59

Thanks -- My friend is having trouble getting either sent or received audio from his Apollo interface. It is connecting (and we are both GREEN), but his interface isn't even showing up on the dropdown

JamTuner - 22:56

I am logged in here to help and stream test audio whenever I can. I standby to help whe I am at my desk

JamTuner - 22:55

after that the connection box ( normally green with "4" ) can be lowered or raised to fine tune jitter

JamTuner - 22:53

fiddleman- always start with nw buffer at512- then when you have connected to someone, lower it incrementelly to the lowest setting that works...

fiddleman - 22:45

Thanks for changing your buffer for me!

fiddleman - 22:45

Thanks. Still learning how to optimize this. I'm on the phone with CyClone.52 (an old buddy of mine). We're trying to do our first 'session'.

JamTuner - 22:41

Fiddleman- I saw you connected to me at 128 network buffer, and the connection box was flashing red intermittently, so I raised my nw buffer , which then made the connection better and you heard

fiddleman - 22:37

Was getting some strange sounds and distortion, then the music changed and it got much better. Did you just change your broadcast?

fiddleman - 22:36

I was just using your feed to experiment with buffer sizes.

fiddleman - 22:36

Hey JamTuner -- sorry -- missed your text. Just trying to get up and running. I have a friend that is supposed to meet me here at 3:30.

JamTuner - 22:32

oops fiddleman- you must be very near me- am i pleasanton CA

JamTuner - 22:32

fiddleman +

duncanmenzies - 22:19

Yes I can hear you hcoj

duncanmenzies - 22:19

I can hear you and myself

hcoj - 22:19

i can't hear you

hcoj - 22:19


duncanmenzies - 22:18


BBSConductor - 17:11

I just joined!! I am in Texas. Anyone nearby?