Compiling

( en | es )

Home > Compiling (for geeks and Linux users)

Linux

Please refer to the client installation page or these instructions if you wish to compile a headless server

MacOS

Requirements

1. Install XCode
2. Install QT as follow

brew install qt5
brew link qt5 --force

Build project

Generate XCode Project file

qmake -spec macx-xcode Jamulus.pro

Print build targets and configuration in console

xcodebuild -list -project Jamulus.xcodeproj

will prompt

    Targets:
        Jamulus
        Qt Preprocess

    Build Configurations:
        Debug
        Release

    If no build configuration is specified and -scheme is not passed then "Release" is used.

    Schemes:
        Jamulus

Build the project

xcodebuild build

Will build the file and make it available in ./Release/Jamulus.app

Windows

Required software: QT, a compiler like Visual Studio, ASIO development files

• copy ASIO development files in jamulus/windows directory so that, e.g., the directory jamulus/windows/ASIOSDK2/common exists
• open Jamulus.pro in Qt Creator and compile & run

General notes

The "headless" build flag

Compiling with the headless flag means you can avoid installing some of the dependent packages, save some disk space and/or speed up your build time under the following circumstances:

1. If you plan to run Jamulus on Gentoo Linux, the only packages you should need for a headless build are qtcore, qtnetwork, and qtxml (both for building and running the server).

2. If you are running Jamulus on Ubuntu/Debian, you will need all dependent packages to compile the binary, but to run the resulting headless Jamulus server you should only need libqt5core5a, libqt5network5, libqt5xml5 and probably libqt5concurrent5. This may be useful for compiling/upgrading on one machine to run the binary on another (a Raspberry Pi, for example).

3. Note that if you want to compile a GUI client on one machine and run it on another (eg a Raspberry Pi) you only need the dependencies listed for a headless server, only with the Jack sound libraries.