Binary versions
===============

Binary versions for Win32 of the most recent version of mumble are provided
on sourceforge.net, see http://www.sourceforge.net/projects/mumble/

The only legitimate releases of Mumble will be on sourceforge, any other
place offering Mumble is likely to contain trojans or viruses.

Windows pre-requisites
======================

Detailed build instructions are available at
http://mumble.sourceforge.net/BuildingWindows and it is highly recommended
to follow them to the letter.

Mac OS X pre-requisites
=======================

Detailed build instructions are available at
http://mumble.sourceforge.net/BuildingMacOSX and it is highly recommended
to follow them to the letter.

Linux pre-requisites
====================

Detailed build instructions are available at
http://mumble.sourceforge.net/BuildingLinux and it is highly recommended
to follow them to the letter.

Building Mumble and Murmur
==========================

To build mumble and murmur, type
qmake main.pro
make release

You may need to edit src/mumble/mumble.pro to reflect the installation paths you
use for libraries.
After building, the binaries will be in the release/ directory.

The qmake step supports a number of configurations options. To enable an
option, simply add CONFIG+=<option> to the end. If you want to change these
after your initial setup, you'll also need to pass -recursive.
So, to build without the server and without ASIO, the above line would be

qmake main.pro CONFIG+=no-server CONFIG+=no-asio -recursive

CONFIG+=no-client
 Don't build the client (Mumble)

CONFIG+=no-server
 Don't build the server (Murmur)

CONFIG+=no-bundled-speex
 Don't use the included version of Speex, but look for one on the system.
 Note that this requires your system-installed Speex to be at least version
 1.2.0.

CONFIG+=optimize
 Build a heavily optimized version, specific to the machine it's being
 compiled on.

CONFIG+=no-cocoa (OSX)
 Disable parts of Mumble that require a Cocoa-version of Qt. This option
 allows Mumble builds for pre-10.5 systems, but still requires the 10.5
 SDK to build.

CONFIG+=no-dbus (Mumble)
 Don't include DBus support on Mumble. This has no effect on Murmur, which
 requires DBus to work.

CONFIG+=no-g15 (Mumble)
 Don't include support for the G15 keyboard (and compatible devices).

CONFIG+=no-asio (Mumble, Win32)
 Don't build support for ASIO audio input.

CONFIG+=no-directsound (Mumble, Win32)
 Don't build support for DirectSound.

CONFIG+=no-wasapi (Mumble, Win32)
 Don't build support for WASAPI.

CONFIG+=no-portaudio (Mumble, Unix, OSX)
 Don't build support for PortAudio.

CONFIG+=no-pulseaudio (Mumble, Unix)
 Don't build support for PulseAudio.

CONFIG+=no-xevie (Mumble, Unix)
 Don't build support for XEvIE. Without this, you can't suppress hotkeys.

CONFIG+=no-oss (Mumble, Linux)
 Don't build support for OSS. Mumble supports OSS4 if you have the correct
 header files.

CONFIG+=no-alsa (Mumble, Linux)
 Don't build support for ALSA.

CONFIG+=no-speechd (Mumble, Linux)
 Don't build support for Speech Dispatcher.

CONFIG+=no-update (Mumble)
 Default disable the checking of new versions. (For distributions)

CONFIG+=no-embed-qt-translations (Mumble)
 Don't embed the translations for Qt, load them from the system. (For
 distributions).

CONFIG+=no-ice (Murmur)
 Don't build support for Ice RPC.
 
CONFIG+=no-bonjour
 Don't build support for Bonjour.

CONFIG+=no-overlay (Mumble, Linux)
 Don't build the overlay library.

User Registrations
==================

To enable user registration, copy scripts/murmur.pl to murmur.cgi and put it
somewhere accessible by your webserver. Make sure your webserver is
configured to execute it as a CGI, and make sure you edit it to reflect
the configuration parameters. Note that the user the CGI will run as needs
write permissions to both the database file and the directory the database
file resides in.
