Installing Mumble

From Mumble Wiki
Revision as of 22:24, 21 August 2008 by Snares2 (talk | contribs) (PPA Repository)
Jump to: navigation, search

! Scroll to bottom of page for instructions on installing Murmur !

Getting and Installing Mumble

Windows

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

Also, you can build Mumble yourself from source as described in BuildingWindows.

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 (svn and tarball) is described there.

The following are instructions for installing mumble with the package managers of the various distributions.

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. You can install that version simply by typing the following command into a shell:

sudo aptitude install mumble

Info: Replace mumble with mumble-server for the Murmur Server Daemon.

Additionally you may want to install speech dispatcher for text-to-speech support by typing:

sudo aptitude install speech-dispatcher

Info: Replace speech-dispatcher with festival for Mumble versions below 1.1.3.

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.

To use this, you first have to add the repository and the key which is used to sign the packages within:

gpg --keyserver hkp://keyserver.ubuntu.com/ --recv-keys DEBA6F3E
gpg --export --armor DEBA6F3E | sudo apt-key add --

echo -e "deb http://ppa.launchpad.net/slicer/ubuntu hardy main\ndeb-src http://ppa.launchpad.net/slicer/ubuntu hardy main" > /tmp/mumble
sudo mv /tmp/mumble /etc/apt/sources.list

sudo aptitude update

Warning: This example is for Ubuntu Hardy Heron (8.04). For other versions you have to change all appearances of the word hardy in the third command to the shortname of your Ubuntu version (e.g. gutsy, intrepid, ...)

Afterwards you can use the same command as in the official repository to install mumble

sudo aptitude install mumble

Info: Replace mumble with mumble-server for the Murmur Server Daemon

Additionally you may want to install speech dispatcher for text-to-speech support by typing:

sudo aptitude install speech-dispatcher

Info: Replace speech-dispatcher with festival for Mumble versions below 1.1.3.

More information about the PPA repository can be found at Launchpad

Manual Download

This is not a good idea because you won't get automatic updates and no packages for amd64 architecture.

If you are running Ubuntu Gutsy Gibbon (7.10) on i386 architecture you can download the .deb packages avalaible at SourceForge. To install the .deb files, type the following in a shell:

sudo dpkg -i mumble_1.1.4-0ubuntu1_i386.deb

Replace mumble_1.1.4-0ubuntu1_i386.deb with the name of the file to install if you install another file.

Additionally you may want to install speech dispatcher for text-to-speech support by typing:

sudo aptitude install speech-dispatcher

Info: Replace speech-dispatcher with festival for Mumble versions below 1.1.3.

Fedora

Fedora 7 RPMs: 1.1.0 i386 1.1.0 x86_64 Fedora 8 RPMs: 1.1.0 i386 1.1.0 x86_64

Install them via double click.

PCLinuxOS and other RPM based distros

You can find a rpm package in the forum. Note that it is not officially supported, but it should work. You can install it with your rpm package manager or typing (as root):

rpm -i mumble-1.0.0-2.i386.rpm

Gentoo

Become root and do:

emerge -av mumble

That should do the magic. If something fails though, check up on BuildingLinux

ArchLinux

A PKGBUILD is avalaible in the 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.

Mac OS X

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

You can also build it from source yourself if you wish. See BuildingMacOsX for more information.

Post-installation tips

Common tips

Initializing/Resetting Murmur 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.

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 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. You also need to update to the latest DirectX9 version that can be downloaded from the Microsoft site. The June 2007 version should be enough.

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):

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"

Below is an example of what you should see:

http://soapbox.sytes.net/Portals/soapbox/Mumble/command.jpg

The result of this step is a new service in the Services console (Start >> Control Panel >> Administrative Tools >> Services).

http://soapbox.sytes.net/Portals/soapbox/Mumble/service.jpg

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

Regedit should look something like this:

http://soapbox.sytes.net/Portals/soapbox/Mumble/regedit.jpg

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.

http://soapbox.sytes.net/Portals/soapbox/Mumble/newkey.jpg

Step 7: Name this new key "Parameters"

http://soapbox.sytes.net/Portals/soapbox/Mumble/parameters.jpg

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.

http://soapbox.sytes.net/Portals/soapbox/Mumble/newstring.jpg

Step 9: Name this new String value "Application".

http://soapbox.sytes.net/Portals/soapbox/Mumble/application.jpg

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.

http://soapbox.sytes.net/Portals/soapbox/Mumble/editapplication.jpg

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. When you're done making your registry changes, your edits should produce something like this:

http://soapbox.sytes.net/Portals/soapbox/Mumble/final.jpg

Step 11: Close Regedit

Step 12: Open the Services console. Navigate to your service, and right click it and select Properties.

http://soapbox.sytes.net/Portals/soapbox/Mumble/panel.jpg

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

Getting the Shortcuts to work

There are two alternatives: Either use native input or Xevie.

For native input make sure that the user running Mumble has read permissions on the /dev/input/eventX files of the input devices you want to use for shortcuts. Be aware that too weak permissions may be a security risk, because malicious processes may log all your input.

If Mumble can not read from any input device it falls back to Xevie.

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:

Option         "XEVIE" "Enable"

That should like something like this:

Section "Extensions"
    ...
    Option         "XEVIE" "Enable"
    ...
EndSection

Then restart the X server (Ctrl+Alt+Backspace) and try again.

Note: As of Mumble 1.1.4 neither Xevie nor access to /dev/input is needed anymore. Push To Talk shortcuts will work out of the box.

Running murmur as a SysV service

You can use Murmur_Init_Script.


Getting and Installing Murmur

//This is a community page, please edit it if you would like to put instructions on installing Murmur for some other Linux distribution, Windows, or Mac.\\

Ubuntu

PPA Repository

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 Murmur for i386 and amd64 architectures.

To use this, you first have to add the repository and the key which is used to sign the packages within:

gpg --keyserver hkp://keyserver.ubuntu.com/ --recv-keys DEBA6F3E
gpg --export --armor DEBA6F3E | sudo apt-key add --

echo -e "deb http://ppa.launchpad.net/slicer/ubuntu hardy main\ndeb-src http://ppa.launchpad.net/slicer/ubuntu hardy main" > /tmp/mumble
sudo mv /tmp/mumble /etc/apt/sources.list.d/

sudo aptitude update

Warning: This example is for Ubuntu Hardy Heron (8.04). For other versions you have to change all appearances of the word hardy in the third command to the shortname of your Ubuntu version (e.g. gutsy, intrepid, ...)

Afterwards you can use the same command as in the official repository to install Murmur

sudo aptitude install mumble-server mumble-server-web 

A window should pop up for Postfix. Postfix is a simple SMTP program that you can use to set up a simple email account. You must correctly set up an email account, and this email must be the same as the one that is listed in the mumble-server.ini (read below).

Now run

sudo dpkg-reconfigure mumble-server

and go through the configuration.