Home

Jamulus OS

Jamulus OS is a Linux distribution based on Ubuntu Studio with Jamulus software out of the box.

The idea behind this OS is simplicity. With Jamulus OS follow these steps:

• Download ubuntustudio iso image from https://sourceforge.net/projects/jamulus-os/files/JamulusOS/
• Create a USB drive/stick with this image using Rufus (Windows) or mkusb (Linux)
• Reboot your computer on this USB drive/stick
• install Jamulus OS package
• Probe you hardware and configure it with easy configuration steps
• Connect to Jamulus

What are the prerequisites ?

PC with at least :

• 2 GHz CPU frequency.
• 64 bits processor
• 2 GB RAM
• 4GB USB drive/stick with good read/write capabilities.
• A wired connection to internet (If you don't have an internal ethernet card you can use an ethernet to USB adapter) |> Please don't use Powerline ethernet or WIFI <|
• Sound card compatible with ALSA (All USB sound cards that are class compliant or listed here

The latest version is v2.02 based on ubuntu studio 20.04.

Documentation

Applications delivered with Jamulus OS install package

Keyboard Shortcuts from V2.00 are no longer available ...

Repositories added

• ppa:ubuntuhandbook1/apps
• ppa:mkusb/ppa

Packages using repositories (Official or added)

• SoundConverter
• vlc (vlc-plugin-jack)
• ubuntu-wallpapers-artful
• stacer
• cbm
• htop
• mixxx
• audacity
• parole
• audacious
• ffmpeg
• obs-studio (obs-plugins)
• simplescreenrecorder
• vokoscreen
• mkusb
• raysession

Packages compiled or downloaded on official sites

• jamulus-os-utils (Jamulus OS dev package)
• jamulus-hw-check (Jamulus OS dev package)
• jamulus (software Jamulus OS packaging)
• qjackctl (with graphe support)
• ulauncher (application launcher CTRL+space)
• non-mixer (from kxstudio)
• luppp (from kxstudio)
• skypeforlinux

How to (with video links)

Consult this HOW-TO if you have any question.

Documentation on Jamulus

https://jamulus.io/wiki/Getting-Started

Bandwith needed for client and server

https://jamulus.io/wiki/Network-Requirements

Troubleshooting with (persistent) Live USB

See Troubleshooting if you have unexpected errors.

Installation

Steps to follow to create an USB persistent live or to clone iso image to USB stick/drive

see README file in https://sourceforge.net/projects/jamulus-os/files/JamulusOS/v2/

Hard drive vs USB Stick/drive installation

Hard drive installation should perform faster than USB stick/drive especially if your USB stick/drive is slow. So consider it as an option.

25 GB are recommended for JamulusOS installation. You can install a boot loader on your hard drive to let you switch at boot time to your other OSes (Windows, Ubuntu ...). You can also use a entire hard drive, this is simpler to set. Remember that all data will be lost on the disk partition or hard drive that you set for installation. Please backup your data before any OS installation process especially if you are new to Linux.

Upgrade

Upgrade to a new version without loosing personal data

Note: You will need another drive for storing your personal data.

Go to the Jamulus OS application menu (whisker menu) and type: mkusb
Choose Backup live persistent home : it will backup your home to a compressed file where you set it to.
and to restore from the created compressed file choose Restore live persistent home

Tips and Tricks

Audio optimisation

If you don't use pulseaudio to grab audio from web explorer like firefox or other pulseaudio capable applications, please don't activate the pulseaudio bridge in Ubuntu studio controls as it can take CPU even if you don't use it.

If you have a simple setup with Jamulus, you will not need pulseaudio bridge, so don't activate it (click on "remove input bridge" et "remove output bridge" buttons if any in Pulse Bridging tab and then click "Apply audio settings" | all in Ubuntu Studio Controls)

Close all applications that you don't need especially web browser which can take a lot of CPU/RAM ... So it can slower your computer if you have not enough resources !

Start several Jamulus instances; each on a different sound card on a single computer

• Deactivate DBus service options in qjackctl (in setup / misc tab)
• Create a preset in qjackctl for each of your sound cards
• Start qjackctl for each sound card by executing the following command, selecting your preset and start the server :
  qjackctl -n MYJACKSERVERNAME
  Ex: qjackctl -n U22
• Start your audio program and select your sound card by setting the default jack server name:
  export JACK_DEFAULT_SERVER=MYJACKSERVERNAME;program
  Ex: export JACK_DEFAULT_SERVER=U22;Jamulus

Limit access to my jamulus private server to a IP whitelist

If you want to allow only a IP whitelist to access to your jamulus private server, you can do it with a firewall.

A simple firewall for Jamulus OS/Ubuntu is ufw with a nice GUI named gufw.

sudo apt install gufw

Deny access to your computer and for each IP address (musician IPv4 addresses) add a rule to allow input on 22124/UDP.