README

Wahjam client and server (http://wahjam.org/)
---------------------------------------------

This software allows musicians to play music together over the internet.  It is
compatible with and based on NINJAM (http://ninjam.com/).

This code is licensed GPL v2 or later:

  http://www.gnu.org/licenses/gpl-2.0.html

Source tree layout
------------------

  cliplogcvt/     Utility to extract individual tracks from a jam
  common/         Core code
  qtclient/       GUI client using Qt framework
  server/         Server
  WDL/            Cockos common library, see www.cockos.com/wdl/

How to build the Qt client
--------------------------

Install the Qt5 cross-platform application and UI toolkit from http://qt.nokia.com/.

Install Ogg and Vorbis audio codec libraries from http://xiph.org/.

Then run the following commands:

  qmake
  make

On Windows the recommended build environment for libogg and libvorbis is MinGW
and MSYS from http://www.mingw.org/.  Build libogg and libvorbis inside MSYS,
then use the Qt build environment to compile qtclient.  You may need to add the
MSYS include/ and lib/ paths as QMAKE_CXXFLAGS -I and LIBS -L flags in
qtclient/qtclient.pro.

Cross-compiling the Qt client for Windows
-----------------------------------------

The MinGW compiler can be used as a cross-compiler to build Windows executables
from a Linux host.  This allows us to set up a Linux build server capable of
building Windows executables.

The mxe project provides a cross-compiler and many popular libraries, including
Wahjam's dependencies on ogg, vorbis, the Qt framework, and PortAudio.

1. Clone mxe:

  git clone https://github.com/mxe/mxe.git

1. Build the cross-compiler and dependencies:

  cd mxe
  make gcc ogg vorbis qt5 portaudio portmidi

1. If you encounter any build errors try reducing optional dependencies.

For example, try disabling SQL drivers and DBUS on the ./configure line in
mxe/src/qt.mk.

NINJAM fork information:

The original source trees were taken from http://www.ninjam.com/.  The files
were:

  ninjam_winclient_0.06.zip
  ninjam_osxclient_0.02a.tar.gz
  cclient_src_v0.01a.tar.gz
  ninjam_server_0.06.tar.gz