Difference between revisions of "Installing Mumble"

From Mumble Wiki
Jump to: navigation, search
Line 1: Line 1:
 
=Getting and Installing Mumble=
 
=Getting and Installing Mumble=
 +
 
This page shows you directions on how to install Mumble (client) as well as Murmur (server).
 
This page shows you directions on how to install Mumble (client) as well as Murmur (server).
  
 
==Windows==
 
==Windows==
  
'''Client'''
+
Just head to [http://sourceforge.net/project/showfiles.php?group_id=147372 SourceForge downloads page], get the Windows executable and run it. Follow the installer instructions and you are done. The installer includes both the client and the server.
 
 
Just head to [http://sourceforge.net/project/showfiles.php?group_id=147372 SourceForge downloads page], get the Windows executable and run it. Follow the installer instructions and you are done.
 
 
 
'''Server'''
 
 
 
The server binaries are included in the Mumble installer. In the latest snapshots of Mumble, one now has the ability to only install Murmur.
 
 
 
Also, you can build Mumble yourself from source as described in [[BuildingWindows]].
 
 
 
If you are interested in only setting up a working Murmur server, read [http://mumble.sourceforge.net/Murmurguide this guide] that explains exactly how to set up a Murmur server on Windows.
 
 
 
==Linux==
 
 
 
Some Linux distributions already have Mumble packaged so that an easy installation is possible. Check your package manager of your distribution for Mumble. But sometimes those packages are not up to date. So if you want more in-depth information about installing Mumble for Linux read up on [[BuildingLinux]]. Installation from source (git and tarball) is  described there.
 
 
 
 
 
=== Debian ===
 
 
 
On both Debian-based and Ubuntu-based distributions using the mumble-server package, the database for Murmur (''mumble-server.sqlite'') is at ''/var/lib/mumble-server'', should you wish to back your database up in case of data failure.
 
 
 
====Lenny====
 
Debian Testing (lenny) includes the latest official Mumble packages, and is the officially maintained version. New packaging efforts are encouraged to base their file layout and usernames on what is used here, to make third-party packages easier to port. To install:
 
 
 
'''Client'''
 
sudo aptitude install mumble
 
 
 
 
 
'''Server and web applications'''
 
sudo aptitude install mumble-server mumble-server-web
 
sudo dpkg-reconfigure mumble-server
 
 
 
''People who are connected to your Mumble server can go to <nowiki>http://</nowiki><your IP or domain>/mumble/register.cgi to register with the server through a web interface.
 
''They can also upload a custom texture that will be displayed in the Mumble game overlay from this page.
 
''Any 600x60 PNG image will work, but if you have an alpha channel on in, it will have transparency.
 
''<nowiki>http://</nowiki><your IP or domain>/mumble/ shows the list of users in your Mumble server.
 
 
 
<hr/>
 
 
 
====Etch====
 
 
 
'''Client'''
 
 
 
Mumble v1.1.6-x86 for Debian Stable ('Etch', 4.0r5) is available at http://Vocis.K1T.NET/
 
 
 
'''Server'''
 
 
 
Below are guidelines how to run Murmur (so its just a server) on Etch release, but it's not a completely described solution.
 
 
 
Requirements:
 
* sudo or su, ability to compile applications from source.
 
* already configured apache2 with php5
 
* mumble static with Ice support
 
* some spare time
 
 
 
First we're going to get some packages needed to install Ice and IcePHP:
 
apt-get install libdb4.4-dev
 
apt-get install pkg-congig
 
apt-get install libbz2-dev
 
 
 
Let's keep stuff in the single directory, enter it:
 
mkdir ~/src
 
cd ~/src
 
 
 
Now we download sources of Ice and IcePHP 3.2.0 version:
 
wget http://www.zeroc.com/download/Ice/3.2/Ice-3.2.0.tar.gz
 
wget http://www.zeroc.com/download/Ice/3.2/IcePHP-3.2.0.tar.gz
 
 
 
Unpack it:
 
tar zxf Ice-3.2.0.tar.gz
 
tar zxf IcePHP-3.2.0.tar.gz
 
 
 
And then compile Ice:
 
cd Ice-3.2.0
 
make
 
 
 
If the compilation returns an error then see the console for the information, probably you will need some extra packages with sources. Google a lot.
 
 
 
If compilation is successful then test the build.
 
make test
 
 
 
If everything is ok then install it:
 
make install
 
 
 
By default it will install in /opt/Ice-3.2.0
 
 
 
Now time to compile IcePHP
 
cd ..
 
cd IcePHP-3.2.0
 
export ICE_HOME=/opt/Ice-3.2.0
 
make
 
make install
 
 
 
In the result you should have the file /opt/IcePHP-3.2.0/lib/IcePHP.so, so copy it to the php5 modules dir - probably something like /usr/lib/php5/20060613+lfs/
 
The ~/src is not used anymore.
 
 
 
Now time to add config to the php5, create file /etc/php5/conf.d/ice.ini and chek the path to the IcePHP.so and the Mumble.ice taken from mumble installation:
 
extension=IcePHP.so
 
ice.slice=/etc/php5/conf.d/Murmur.ice
 
 
 
Reload apache2 and see if the php loaded Ice by pinting your browser to some page with phpinfo().
 
 
 
=== Ubuntu ===
 
 
 
==== Official Repository ====
 
 
 
'''This is the easy way, but you won't always get the latest version.'''
 
 
 
Ubuntu Hardy Heron (8.04) includes the Mumble 1.1.x series in it's official repository. It's cloned from Debian testing before every Ubuntu release, so while it will lag slightly behind, it won't be by much. Just follow the directions for installing under Debian.
 
 
 
==== PPA Repository ====
 
 
 
'''This is a bit more to type, but should always be up-to-date.'''
 
 
 
As the packages in the official Ubuntu repository aren't always up-to-date, you can add an external PPA repository to your package manager. It should always include the newest stable version of Mumble and Murmur for i386 and amd64 architectures.
 
 
 
You will have to manually add the repositories for the PPA repository. Go to a command prompt and type
 
sudo gedit /etc/apt/sources.list
 
then add the following two lines to the bottom of the file
 
deb http://ppa.launchpad.net/slicer/ubuntu hardy main
 
deb-src http://ppa.launchpad.net/slicer/ubuntu hardy main
 
then run
 
sudo aptitude update
 
(replace ''hardy'' with ''gutsy'' or ''intrepid'' if you are on those distributions)
 
 
 
Afterward you can use the same command as for installing under Debian Lenny (see [http://mumble.sourceforge.net/Installing_Mumble#Lenny above]).
 
 
 
More information about the PPA repository can be found at [https://launchpad.net/~slicer/+archive/ppa Launchpad]
 
 
 
===RPM-based distributions===
 
Fedora, openSUSE, PCLinuxOS, etc. are RPM-based distributions. If their own official package repository doesn't have an up to date version or even no version at all of Mumble, then have a look at openSUSE's Build Service (http://software.opensuse.org).
 
 
 
There you can find many different RPM-builds for different distributions and architectures of Mumble. '''Note''' that these packages are not officially supported, but it should work.
 
 
 
Follow this link to see search results for "mumble": http://software.opensuse.org/search?q=mumble
 
 
 
Often you can install it with the RPM tool of your distribution or by typing (as root):
 
rpm -i mumble-1.1.7-i386.rpm
 
 
 
 
 
===Gentoo===
 
'''Client'''
 
 
 
Depending on what other features you want compiled into it, check up on the possible USE-flags: http://www.gentoo-portage.com/media-sound/mumble/USE#ptabs
 
 
 
It's well possible that the Mumble ebuild is masked by the ~x86, ~amd64, or other keyword. Here, we make sure it will install anyways.
 
 
 
Become root and do:
 
echo media-sound/mumble >> /etc/portage/package.keywords
 
emerge -av media-sound/mumble
 
 
 
To build out of git, use this ebuild:
 
# Copyright 1999-2009 Gentoo Foundation
 
# Distributed under the terms of the GNU General Public License v2
 
 
EAPI="2"
 
 
inherit eutils multilib qt4 git
 
 
DESCRIPTION="Voice chat software for gaming written in Qt4."
 
HOMEPAGE="http://mumble.sourceforge.net/"
 
EGIT_REPO_URI="git://mumble.git.sourceforge.net/gitroot/mumble"
 
EGIT_PROJECT="mumble"
 
 
LICENSE="BSD"
 
SLOT="0"
 
KEYWORDS="~amd64 ~x86"
 
IUSE="alsa dbus debug g15 oss pch portaudio pulseaudio speech"
 
 
RDEPEND="dev-libs/boost
 
>=media-libs/speex-1.2_beta3_p2
 
x11-libs/qt-core:4[ssl]
 
x11-libs/qt-gui:4
 
x11-libs/qt-opengl:4
 
x11-libs/qt-sql:4[sqlite]
 
alsa? ( media-libs/alsa-lib )
 
dbus? ( x11-libs/qt-dbus:4 )
 
g15? ( app-misc/g15daemon )
 
portaudio? ( media-libs/portaudio )
 
pulseaudio? ( media-sound/pulseaudio )
 
speech? ( app-accessibility/speech-dispatcher )"
 
 
DEPEND="${RDEPEND}"
 
 
src_configure() {
 
local conf_add
 
 
if has_version '<=sys-devel/gcc-4.2'; then
 
conf_add="${conf_add} no-pch"
 
else
 
use pch || conf_add="${conf_add} no-pch"
 
fi
 
 
use alsa || conf_add="${conf_add} no-alsa"
 
use dbus || conf_add="${conf_add} no-dbus"
 
use debug && conf_add="${conf_add} symbols debug" || conf_add="${conf_add} release"
 
use g15 || conf_add="${conf_add} no-g15"
 
use oss || conf_add="${conf_add} no-oss"
 
use portaudio || conf_add="${conf_add} no-portaudio"
 
use pulseaudio || conf_add="${conf_add} no-pulseaudio"
 
use speech || conf_add="${conf_add} no-speechd"
 
 
eqmake4 "${S}/main.pro" -recursive \
 
CONFIG+="${conf_add} no-bundled-speex no-embed-qt-translations no-server no-xevie" \
 
DEFINES+="PLUGIN_PATH=/usr/$(get_libdir)/mumble" \
 
|| die "eqmake4 failed."
 
}
 
 
src_install() {
 
newdoc README.Linux README || die "Installing docs failed."
 
dodoc CHANGES || die "Installing docs failed."
 
 
local dir
 
if use debug; then
 
dir=debug
 
else
 
dir=release
 
fi
 
 
dobin "${dir}"/mumble || die "Installing mumble binary failed."
 
 
CONF_LIBDIR="$(get_libdir)/mumble" dolib.so "${dir}"/lib*.so* || die "Installing libraries failed."
 
CONF_LIBDIR="$(get_libdir)/mumble" dolib.so "${dir}"/plugins/lib*.so* || die "Installing libraries failed."
 
 
insinto /usr/share/services
 
doins scripts/mumble.protocol || die "Installing mumble.protocol file failed."
 
 
dobin scripts/mumble-overlay || die "Installing overlay script failed."
 
 
newicon icons/mumble.64x64.png mumble.png || die "Installing icon failed."
 
 
make_desktop_entry ${PN} "Mumble" mumble "Qt;KDE;Network;Telephony;" \
 
|| die "Installing menu entry failed."
 
 
doman man/mumble-overlay.1 || die "Installing mumble-overlay manpage failed."
 
doman man/mumble.1 || die "Installing mumble manpage failed."
 
}
 
 
pkg_postinst() {
 
echo
 
elog "Visit http://mumble.sourceforge.net/Audio_Tuning for futher configuration."
 
elog "Run mumble-overlay to start the OpenGL overlay (after starting mumble)."
 
echo
 
}
 
 
 
'''Server'''
 
 
 
Depending on what other features you want compiled into it, check up on the possible USE-flags: http://www.gentoo-portage.com/media-sound/murmur/USE#ptabs
 
 
 
It's well possible that the Murmur ebuild is masked by the ~x86, ~amd64, or other keyword. Here, we make sure it will install anyways.
 
 
 
Become root and do:
 
echo media-sound/murmur >> /etc/portage/package.keywords
 
emerge -av media-sound/murmur
 
 
 
To build out of git, use this ebuild:
 
# Copyright 1999-2009 Gentoo Foundation
 
# Distributed under the terms of the GNU General Public License v2
 
 
EAPI="2"
 
 
inherit eutils qt4 git
 
 
MY_PN="mumble"
 
MY_P=${MY_PN}-${PV}
 
 
DESCRIPTION="Voice chat software for gaming written in Qt4 (server)."
 
HOMEPAGE="http://mumble.sourceforge.net/"
 
EGIT_REPO_URI="git://mumble.git.sourceforge.net/gitroot/mumble"
 
EGIT_PROJECT="mumble"
 
 
LICENSE="BSD"
 
SLOT="0"
 
KEYWORDS="~amd64 ~x86 ~ia64"
 
IUSE="debug +ice logrotate pch"
 
 
RDEPEND="
 
x11-libs/qt-core:4[ssl]
 
x11-libs/qt-dbus:4
 
|| ( x11-libs/qt-sql:4[sqlite] x11-libs/qt-sql:4[mysql] )
 
ice? ( dev-cpp/Ice dev-libs/boost )
 
logrotate? ( app-admin/logrotate )
 
"
 
 
DEPEND="${RDEPEND}"
 
 
S="${WORKDIR}"/${MY_P}
 
 
pkg_setup() {
 
enewgroup murmur
 
enewuser murmur -1 -1 /var/lib/murmur murmur
 
}
 
 
src_prepare() {
 
sed -i \
 
-e 's:mumble-server:murmur:g' \
 
scripts/murmur.conf \
 
scripts/murmur.ini.system \
 
|| die "sed failed."
 
}
 
 
src_configure() {
 
local conf_add
 
use debug && conf_add="${conf_add} symbols debug" || conf_add="${conf_add} release"
 
use ice || conf_add="${conf_add} no-ice"
 
use pch || conf_add="${conf_add} no-pch"
 
 
eqmake4 main.pro -recursive \
 
CONFIG+="${conf_add} no-client no-bundled-speex" \
 
|| die "eqmake4 failed."
 
}
 
 
src_install() {
 
dodoc README CHANGES || die "Installing docs failed."
 
 
docinto scripts
 
dodoc scripts/*.php scripts/*.pl || die "Installing docs failed."
 
 
local dir
 
if use debug; then
 
dir=debug
 
else
 
dir=release
 
fi
 
 
dobin "${dir}"/murmurd || die "Installing murmurd binary failed."
 
 
insinto /etc/murmur/
 
newins scripts/murmur.ini.system murmur.ini || die "Installing murmur.ini configuration file failed."
 
 
if use logrotate; then
 
insinto /etc/logrotate.d/
 
newins "${FILESDIR}"/murmur.logrotate murmur || die "Installing murmur logrotate file failed."
 
fi
 
 
insinto /etc/dbus-1/system.d/
 
doins scripts/murmur.conf || die "Installing murmur.conf dbus configuration file failed."
 
 
newinitd "${FILESDIR}"/murmur.initd murmur || die "Installing murmur init.d file failed."
 
newconfd "${FILESDIR}"/murmur.confd murmur || die "Installing murmur conf.d file failed."
 
 
keepdir /var/lib/murmur /var/run/murmur /var/log/murmur
 
fowners -R murmur /var/lib/murmur /var/run/murmur /var/log/murmur || die "fowners failed."
 
fperms 750 /var/lib/murmur /var/run/murmur /var/log/murmur || die "fperms failed."
 
 
doman man/murmurd.1 || die "Installing murmur manpage failed."
 
}
 
 
pkg_postinst() {
 
echo
 
elog "Useful scripts are located in /usr/share/doc/${PF}/scripts."
 
elog "Please execute:"
 
elog "murmurd -ini /etc/murmur/murmur.ini -supw <pw>"
 
elog "chown murmur:murmur /var/lib/murmur/murmur.sqlite"
 
elog "to set the inbuild 'SuperUser' password before starting murmur."
 
elog "Please restart dbus before starting murmur,"
 
elog "or dbus registration will fail."
 
echo
 
}
 
 
 
 
 
===ArchLinux===
 
 
 
'''Client'''
 
 
 
A  stable PKGBUILD is available in the [http://aur.archlinux.org/packages.php?do_Details=1&ID=10221&K=mumble AUR]. Download the tarball and then run:
 
tar xzfv mumble*.tar.gz
 
cd mumble*
 
makepkg
 
 
 
That should create a package for you. Of course, you need to install all the dependencies listed before. To do it in a single command:
 
 
 
pacman -S alsa-lib qt4 libxevie sqlite3 boost
 
 
 
Finally, install the package:
 
 
 
pacman -A mumble-1.0.0-1.pkg.tar.gz
 
 
 
Of course, replace the package name as appropriate.
 
 
 
If you want to test a SVN Snapshot, use this [http://aur.archlinux.org/packages.php?ID=23369 PKGBUILD] in the [http://aur.archlinux.org/packages.php?ID=23369 AUR]. Use [http://wiki.archlinux.org/index.php/Yaourt Yaourt] or the instructions above.
 
 
 
  
 
==Mac OS X==
 
==Mac OS X==
Line 391: Line 11:
 
Precompiled Mac OS X universal binaries are available from the [http://sourceforge.net/project/showfiles.php?group_id=147372 SourceForge downloads page].
 
Precompiled Mac OS X universal binaries are available from the [http://sourceforge.net/project/showfiles.php?group_id=147372 SourceForge downloads page].
  
You can also build it from source yourself if you wish. See [[BuildingMacOSX]] for more information.
+
== Debian (Linux) ==
 
 
 
 
==Snapshots==
 
 
 
If you want to get the latest snapshots for Mumble and Murmur, you can find those [http://mumble.info/snapshot/ here]. These include the latest builds of Mumble and Murmur for Windows, and static builds of Murmur for Linux.
 
 
 
 
 
=Post-installation tips=
 
==Common tips==
 
===Initializing/Resetting Murmur SuperUser password===
 
Type:
 
murmur -supw <password>
 
That will change the password for SuperUser, a special user that has all rights.
 
If you want to reset the entire database, just delete murmur.sqlite and the recreate it with the command above.
 
 
 
===Registering a User===
 
There are many ways to register a user using DBus or ICE but if you simply want to add a user from the server locally without setting up a webserver you can run a DBus script:
 
 
 
[http://mumble.sourceforge.net/DBus_scripts#Windows DBus bat script for Windows]
 
 
 
===Making Sound File===
 
[[Speexconversion]]
 
 
 
==Windows==
 
===Text-to-Speech===
 
The Text-To-Speech voices that ship by default with Windows are not all that good (and if you are not English, its even worse as it will try to speak english even when the text is not). If you have installed either MS Office or the Speech SDK, you will get more voices which can be configured from the Speech control panel. You can also buy a commercial Text-To-Speech engine; as long as it's SAPI5 compatible it can be used by Mumble. The main developers are currently using NeoSpeech Kate (buyable standalone from [http://www.nextup.com NextUp]).
 
 
 
===Creating a server connection shortcut===
 
You can right click on your desktop and choose "New" and pick "Shortcut" from the sub-menu.
 
In the box that says "Type the location of the item" put "mumble://username:password@servername/channel"
 
replacing the "username" with the name you log into the murmur server with (or omitting it and mumble will ask you for a user name), replacing "servername" with the DNS name or IP address of the murmur server.  "Channel" may be omitted if you want to connect to the root channel.  If a password is not specified mumble will request one from you when it attempts to connect.  The bare minimum required for the shortcut would be "mumble://servername" with mumble requesting a username and a password upon attempting to connect to "servername".  This format would also be used to embed a link to your murmur server in a web page, perhaps in the members section of a clan home page.
 
 
 
===It complains about mumble_ol.dll / Problems with Overlay===
 
If you are running XP you will need to update it to SP2.
 
 
 
=== Murmur dies when I log out! How can I get Murmur to stay on all the time? ===
 
If you've noticed that the Murmur server dies when you log out of Windows, this is expected. If you want Murmur to run all the time, it'll need to be ran as a service. Fortunately, this is really easy to do! For the purposes of this write-up, the service we are creating is Murmur Demo. You may call it something else if you so choose.
 
 
 
Some references you'll see int his write-up:
 
 
 
instsrv.exe - A program that adds services to the Windows registry.
 
 
 
srvany.exe - A program that allows any Windows application and some Windows 16-bit applications to run as a service.
 
 
 
'''The HOW-TO'''
 
 
 
Step 1: Gain Administrator access on the machine running Murmur.
 
 
 
Step 2: Download and install the following collection of tools from Microsoft to the default directory (C:\Program Files\Windows Resource Kits):
 
 
 
[http://www.microsoft.com/downloads/details.aspx?FamilyID=9d467a69-57ff-4ae7-96ee-b18c4790cffd&displaylang=en Windows 2003 Server Resource Kit].
 
 
 
Step 3: Open a command console (Start >> Accessories >> Command Prompt).
 
 
 
Step 4: If you have installed to the default directory, type the following:
 
 
 
"C:\Program Files\Windows Resource Kits\Tools\instsrv.exe" "Murmur" "C:\Program Files\Windows Resource Kits\Tools\srvany.exe"
 
 
 
The result of this step is a new service in the Services console (Start >> Control Panel >> Administrative Tools >> Services).
 
 
 
'''Be sure to close the Services console before proceeding.'''
 
 
 
Step 5: Open the registry editor (Start >> Run and enter "regedit") and navigate to the following key:
 
 
 
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Murmur Demo
 
 
 
 
 
Step 6: Right click on the key name ("Murmur Demo") in the left panel of regedit, and from the menu that pops up, select New >> Key.
 
 
 
Step 7: Name this new key "Parameters"
 
 
 
Step 8: Right click on the key name ("Parameters") in the left panel of regedit, and from the menu that pops up, select New >> String value.
 
 
 
Step 9: Name this new String value "Application".
 
 
 
Step 10: Right click on the String value ("Application) in the right panel of regedit, and from the menu that pops up, select Modify. Change the value from blank to the full path to your murmur.exe file.
 
 
 
Repeat steps 8 through 10, making a second String value called "AppDirectory" and set its value to the full directory path of your murmur.exe file.
 
 
 
Step 11: Close Regedit
 
 
 
Step 12: Open the Services console. Navigate to your service, and right click it and select Properties.
 
 
 
Step 13: Make sure the Startup Type value is Automatic, and then press the Start button.
 
 
 
At this point, the server should launch, although you probably won't see it. You can test to see if it's working by trying to connect to it using your client.
 
 
 
If your server did start, congratulations, you're done. You should be able to logoff and reboot the machine if you want, with Murmur pesisting through both.
 
 
 
If your server did not start, recheck your settings. Most problems are related to typos in configuration settings.
 
  
==Linux==
+
Debian unstable has the latest release at all times in the unstable repository, and snapshots in experimental. Backports to current stable are done as soon as the packge reaches testing (usually a week after release).
===Getting the Shortcuts Suppression to work===
 
  
You need to have Xevie enabled in your xorg.conf. To do this you will have to add the following line to xorg.conf, in the extensions section:
+
To configure the server, just 'dpkg -reconfigure mumble-server'.
  
Option        "XEVIE" "Enable"
+
=== Ubuntu (Linux) ===
  
That should like something like this:
+
Ubuntu carries whatever Mumble version was current at the time of the release in the universe repository. Backports of current releases can be found [https://launchpad.net/~slicer/+archive/ppa in the PPA].
  
Section "Extensions"
+
== SUSE (Linux) ==
    ...
 
    Option        "XEVIE" "Enable"
 
    ...
 
EndSection
 
  
Then restart the X server (Ctrl+Alt+Backspace) and try again.
+
Uptodate packages can be found in the [http://download.opensuse.org/repositories/home:/lnussel:/mumble:/unstable/ Build Service].
  
 
[[Category:Documentation]]
 
[[Category:Documentation]]
 
[[Category:Documentation English]]
 
[[Category:Documentation English]]
[[Category:Needs Update for 1.2.0]]
 

Revision as of 23:19, 11 November 2009

Getting and Installing Mumble

This page shows you directions on how to install Mumble (client) as well as Murmur (server).

Windows

Just head to SourceForge downloads page, get the Windows executable and run it. Follow the installer instructions and you are done. The installer includes both the client and the server.

Mac OS X

Precompiled Mac OS X universal binaries are available from the SourceForge downloads page.

Debian (Linux)

Debian unstable has the latest release at all times in the unstable repository, and snapshots in experimental. Backports to current stable are done as soon as the packge reaches testing (usually a week after release).

To configure the server, just 'dpkg -reconfigure mumble-server'.

Ubuntu (Linux)

Ubuntu carries whatever Mumble version was current at the time of the release in the universe repository. Backports of current releases can be found in the PPA.

SUSE (Linux)

Uptodate packages can be found in the Build Service.