jamulus/INSTALL

/******************************************************************************\
 * Copyright (c) 2004-2019
 *
 * Author(s):
 *	Volker Fischer
 *
 ******************************************************************************
 *
 * This program is free software; you can redistribute it and/or modify it under
 * the terms of the GNU General Public License as published by the Free Software
 * Foundation; either version 2 of the License, or (at your option) any later
 * version.
 *
 * This program is distributed in the hope that it will be useful, but WITHOUT 
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
 * FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
 * details.
 *
 * You should have received a copy of the GNU General Public License along with
 * this program; if not, write to the Free Software Foundation, Inc.,
 * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
 *
\******************************************************************************/


Windows:
--------

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

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


Linux:
------

Required packages: Build-Essential, QT4 (devel packages, too!), Jack (devel packages, too!)
                   On the most common Linux distributions, the following
                   command should prepare the system for compilation:
                   sudo apt-get install build-essential libqt4-dev libjack-jackd2-dev

- qmake Jamulus.pro
- make clean
- make
- run ./Jamulus

Note that the "make clean" is essential to remove the automatically generated Qt
files which are present in the .tar.gz file and may not match the Qt version you
are using.

Use qmake "CONFIG+=nosound" Jamulus.pro for pure server installation which
does not require the Jack packages.

To use an external shared OPUS library instead of the built-in use
qmake "CONFIG+=opus_shared_lib" Jamulus.pro.

A desktop link file jamulus.desktop is available in the llcon/src/res directory.
To use this file configure the software with
qmake "CONFIG+=noupcasename" Jamulus.pro to make sure the output target name of
this software is jamulus instead of Jamulus (see content of jamulus.desktop).

Jamulus is also compatible with Qt5.

Mac:
----

Download and install Apple Xcode and QT SDK for Mac.

- qmake Jamulus.pro
- open Jamulus.xcodeproj and compile & run