Mumble is an open-source, low-latency, high quality voice chat software.
Go to file
Mikkel Krautz d475b446dc scripts/generate-AUTHORS.py: use pyuca for sorting to get deterministic output on all platforms.
My own rule of thumb for scripts in our repo is to keep the
number dependencies down. In practice, this means I always
strive to only use the standard library.

In this case, it's not that easy.

The existing code sorted sufficiently on Windows.

However, when run on Unix-like systems, it produces odd, and
to my mind, unexpected sorting behavior. (Such as ignoring spaces,
and sorting 'Hey You' after 'Heyh You'.)

I suppose the sort order is a matter of preference.

But the non-determinism of the script's output isn't.
If we don't fix this, we'll get noisy diffs once in a while,
which isn't very nice.

This commit changes the script to use 'pyuca' to
do the sorting. This is a pure Python module, so
it's easy to install via pip on all OSes.
2016-05-06 13:38:36 +02:00
.tx Add transifex client configuration for project. 2014-04-27 03:20:48 +02:00
3rdparty Move smallft to 3rdparty/smallft-src and add to 3rdPartyLicenses. 2016-04-28 13:11:33 +02:00
3rdPartyLicenses Use Emoji One SVGs for our flag icons instead of FamFamFam. 2015-11-17 00:13:59 +01:00
g15helper Update the Copyright year range for The Mumble Developers throughout the tree. 2016-01-01 16:04:46 +01:00
icons Update svg URL(s) from sourceforge to github 2015-12-12 19:41:18 +01:00
installer installer: add ql.dll plugin to the installer. 2016-04-25 14:52:34 +02:00
macx compiler.pri: unsure that all our compiler.pri CFLAGS and CXXFLAGS are also applied for Objective-C(++). 2015-11-21 16:46:03 +01:00
man man: refer to The Mumble Developers as the Mumble authors in our man pages. 2015-12-28 01:26:32 +01:00
overlay overlay: remove Far Cry 4 from the default blacklist. 2016-04-01 22:06:49 +02:00
overlay_gl overlay_gl: port to FreeBSD. 2015-11-23 01:24:42 +01:00
overlay_winx64 Update the Copyright year range for The Mumble Developers throughout the tree. 2016-01-01 16:04:46 +01:00
plugins Plugin update for latest version of Quake Live 2016-04-30 17:09:57 +02:00
samples Add sound for recording state change notifications 2010-08-25 23:24:37 +02:00
scripts scripts/generate-AUTHORS.py: use pyuca for sorting to get deterministic output on all platforms. 2016-05-06 13:38:36 +02:00
src GlobalShortcut_win: fix access to nxboxinput in EnumDevicesCB. 2016-05-04 01:57:03 +02:00
themes themes/Mumble: sync with mumble-theme submodule. 2016-02-20 02:00:32 +01:00
toolchain/win32-msvc2013 toolchain/win32-msvc2013: only use native amd64 compiler if it is available. 2015-11-28 10:57:25 +01:00
.gitignore overlay: split the shaders in overlay.fx out into separate HLSL files. 2015-11-28 10:05:06 +01:00
.gitmodules main.pro, 3rdparty: remove fx11 from the Mumble build. 2015-11-28 10:05:07 +01:00
.mailmap .mailmap: update James Fraser alias. 2016-05-01 16:17:10 +02:00
AUTHORS Add .mailmap file and us it in scripts/generate-AUTHORS.py. 2016-03-13 13:35:46 +01:00
CHANGES Update changelog. 2014-12-28 23:49:46 +01:00
compiler.pri Do not enable warnings-as-errors by default. 2016-03-14 22:42:20 +01:00
Doxyfile Remove 'doc' directory in favour of https://github.com/mumble-voip/mumble-protocol 2015-03-17 20:19:15 +01:00
INSTALL GlobalShortcut_win, XboxInput: implement native XInput support in GlobalShortcut_win. 2015-12-24 01:37:25 +01:00
LICENSE Simplify LICENSE file, add LICENSE.header and add AUTHORS. 2016-02-20 01:13:38 +01:00
LICENSE.header Simplify LICENSE file, add LICENSE.header and add AUTHORS. 2016-02-20 01:13:38 +01:00
main.pro GlobalShortcutWin: Exclude XInput devices from DirectInput. 2016-03-03 16:13:26 +01:00
qt.pri Do not use the qtaccessiblewidgets plugin on Qt 5.4 and greater. 2014-12-24 13:41:49 +01:00
rcc.pri rcc.pri: use manual quoting via escape_expand(\") instead of system_quote() to be compatible with Qt 4. 2015-11-22 13:09:03 +01:00
README Update OS X murmur docs 2015-07-04 17:33:27 +02:00
README.Linux fix minor spelling mistake 2015-05-06 00:53:13 +02:00
README.md Add README.md for GitHub 2016-02-20 01:21:14 +01:00
README.static.linux changed sourceforge links to mumble.info links 2015-07-05 10:43:56 +02:00
README.static.osx changed sourceforge links to mumble.info links 2015-07-05 10:43:56 +02:00
symbols.pri Handle symbol-generation for plugin_bundles on Mac OS X. 2010-02-24 17:26:01 +01:00
winpaths_default.pri mumble, murmur: final adjustments for the win32-static buildenv. 2013-08-25 13:22:38 +02:00
winpaths_static.pri winpaths_static.pri: remove executable bit. 2014-01-12 22:04:35 +01:00

Mumble - A voicechat utility for gamers

http://mumble.info/
#mumble on freenode

Mumble is a voicechat program for gamers written on top of Qt and Speex.

There are two modules in Mumble; the client (mumble) and the server (murmur). The client works on Win32/64, Linux and Mac OS X, while the server should work on anything Qt can be installed on.

Note that when we say Win32, we mean Windows XP or newer.

Running Mumble

On Windows, after installation, you should have a new Mumble folder in your Start Menu, from which you can start Mumble.

On Mac OS X, to install Mumble, drag the application from the downloaded disk image into your /Applications folder.

Once Mumble is launched, you need a server to connect to. Either create your own or join a friend's.

Running Murmur on Unix-like systems

Murmur should be run from the command line, so start a shell (command prompt) and go to wherever you installed Mumble. Run murmur as

murmurd [-supw <password>] [-ini <inifile>] [-fg] [v]

-supw   Set new password for the user SuperUser, which is hardcoded to
        bypass ACLs. Keep this password safe. Until you set a password,
        the SuperUser is disabled. If you use this option, murmur will
        set the password in the database and then exit.

-ini    Use a inifile other than murmur.ini, use this to run several instances
        of murmur from the same directory. Make sure each instance is using
        a separate database.

-fg     Run in the foreground, logging to standard output.

-v      More verbose logging.

Running Murmur on Mac OS X

Murmur is distributed seperately from the Mumble client on Mac OS X. It is called Static OS X Server and can be downloaded from the main webpage.

Once downloaded it can be run in the same way as on any other Unix-like system. For more information please see the 'Running Murmur on Unix-like systems' above.

Running Murmur on Win32

Doubleclick the Murmur icon to start murmur. There will be a small icon on your taskbar from which you can view the log.

To set the superuser password, run murmur with the parameters -supw <password>.

Bandwidth usage

Mumble will use 10-40 kbit/s outgoing, and the same incoming for each user. So if there are 10 other users on the server with you, your incoming bandwidth requirement will be 100-400 kbit/s if they all talk at the same time.