Ninjam

NINJAM is open source (GPL) software to allow people to make real music together via the Internet. Every participant can hear every other participant. Each user can also tweak their personal mix to their liking. NINJAM is cross-platform, with clients available for Mac OS X, Linux, and Windows. REAPER (our digital audio workstation software for Windows and OS X) also includes NINJAM support (ReaNINJAM plug-in).

Software Included

Package Version License
ninjam latest GPL 2.0

Creating an App using the Control Panel

Click this button to create a Droplet based on this 1-Click App. If you aren’t logged in, this link will prompt you to log in with your DigitalOcean account.

Deploy to DO

Creating an App using the API

In addition to creating a Droplet from the Ninjam 1-Click App using the control panel, you can also use the DigitalOcean API. As an example, to create a 4GB Ninjam Droplet in the SFO2 region, you can use the following curl command. You need to either save your API access token) to an environment variable or substitute it in the command below.

curl -X POST -H 'Content-Type: application/json' \
         -H 'Authorization: Bearer '$TOKEN'' -d \
        '{"name":"choose_a_name","region":"sfo2","size":"s-2vcpu-4gb","image": "sharklabs-ninjam-10-0"}' \
        "https://api.digitalocean.com/v2/droplets"

Getting Started After Deploying Ninjam

After the droplet is created the server will be running at the IP specified on port 2049 (default).

If you wish to edit the default config, it can be found at /etc/ninjam.cfg. You can find a reference for each of the options here.

Setting up your client

Reaper is the preferred client. Download the version that matches your operating system here. Reaper can be evaluated for free, but it is highly encouraged that you support high quality, well priced software wherever possible.

  • Open Reaper.
  • Click the FX button on the master channel
  • Choose the ReaNINJAM plugin
  • Click Show ReaNINJAM Console
  • Click File > Connect
  • Paste in the IP address you got from your Droplet
  • Input your username and select Connect anonymously
  • Add at least one track to your Reaper project
  • Enable monitoring on that track

You should now be able to see your audio signal and the others in your session. Tweak the levels to your liking and happy Ninjamming!