Mumble is an open-source, low-latency, high quality voice chat software.
Go to file
Robert Adam 459a3bf888 MAINT: Added clang-format support
The used .clang-format file has been generated using clang-format 6
(shipped with Ubuntu 18.04) and is therefore backwards compatible with
all clang-format versions until v6.
2020-09-11 18:28:38 +02:00
.ci CI: Enable online tests 2020-09-11 15:51:32 +02:00
.github .github/stale.yml: Configure stale-bot 2020-04-10 10:08:07 +02:00
.tx Add transifex client configuration for project. 2014-04-27 03:20:48 +02:00
3rdparty BUILD(qmake): Remove 2020-09-02 08:29:45 +02:00
3rdPartyLicenses scripts/mklic.pl, 3rdPartyLicenses: add libffi license. 2018-02-11 11:54:20 +01:00
cmake BUILD(cmake): Added debug-dependency-search option 2020-08-31 17:30:53 +02:00
docs MAINT(readme): Move READMEs for static server into docs/ 2020-07-08 17:55:46 +02:00
g15helper MAINT: Make use of cmake configure for version 2020-09-02 18:30:33 +02:00
icons themes: add "Classic - Old Style" theme 2019-03-21 07:27:29 +01:00
installer installer: add WiX files for CPack 2020-07-11 23:33:25 +02:00
macx MAINT: Make use of cmake configure for version 2020-09-02 18:30:33 +02:00
man DOCS(man): Add missing options from help messages to man pages 2020-08-20 00:04:29 +02:00
overlay MAINT: Make use of cmake configure for version 2020-09-02 18:30:33 +02:00
overlay_gl BUILD(cmake): Also install man files 2020-09-11 08:27:06 +02:00
overlay_winx64 MAINT: Make use of cmake configure for version 2020-09-02 18:30:33 +02:00
plugins BUILD(qmake): Remove 2020-09-02 08:29:45 +02:00
samples Add sound for recording state change notifications 2010-08-25 23:24:37 +02:00
screenshots screenshots: Added Mumble screenshots 2020-04-04 12:58:36 +02:00
scripts MAINT: Added clang-format support 2020-09-11 18:28:38 +02:00
src MAINT: Added clang-format support 2020-09-11 18:28:38 +02:00
themes FEAT(client): Indicate talking users when locally muted 2020-07-02 17:29:05 +02:00
.cirrus.yml CI: Build with CMake 2020-07-11 23:33:25 +02:00
.clang-format MAINT: Added clang-format support 2020-09-11 18:28:38 +02:00
.gitignore Update gitignore 2018-12-30 23:54:13 -06:00
.gitmodules BUILD(qmake): Remove 2020-09-02 08:29:45 +02:00
.mailmap Added aliases of Robert Adam 2020-01-28 12:47:16 +01:00
.travis.yml REFAC(ci): move scripts to dedicated ".ci" folder 2020-07-18 00:18:25 +02:00
AUTHORS AUTHORS: update via scripts/generate-AUTHORS.py. 2020-01-10 22:33:25 +01:00
CHANGES Update AUTHORS and CHANGES. 2016-12-23 09:27:14 +01:00
CMakeLists.txt MAINT: Make use of cmake configure for version 2020-09-02 18:30:33 +02:00
COMMIT_GUIDELINES.md MAINT: Added BUILD type to commit guidelines 2020-08-31 17:30:53 +02:00
Dockerfile Dockerfile: use regex for protobuf and grpc package names 2020-04-18 16:15:41 +02:00
Doxyfile Doxyfile: set "EXTRACT_ALL" to "YES" 2019-12-26 20:27:52 +01:00
INSTALL INSTALL: undocument 'no-directsound' option 2019-10-05 08:10:58 +02:00
LICENSE LICENSE, LICENSE.header: add 2020 to the copyright range 2020-01-07 02:54:50 +01:00
LICENSE.header LICENSE, LICENSE.header: add 2020 to the copyright range 2020-01-07 02:54:50 +01:00
README.md MAINT(readme): Removed reference to LGTM 2020-08-22 17:19:26 +02:00
SECURITY.md Add link to advisories in SECURITY.md 2020-05-31 16:39:12 +02:00
sonar-project.properties Travis CI: add SonarCloud integration for static code analysis 2019-06-29 00:41:35 +02:00

Mumble screenshot

Mumble - Open Source voice-chat software

https://www.mumble.info

#mumble:matrix.org #mumble@freenode.net

Codacy Azure Cirrus CI Travis CI

Mumble is an Open Source, low-latency and high-quality voice-chat program written on top of Qt and Opus.

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.

The documentation of the project can be found on the wiki. The FAQ can also be found there.

Reporting issues

If you want to report a bug or create a feature-request, you can open a new issue (after you have checked that there is none already) on GitHub.

Windows

Running Mumble

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

Running Murmur

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>.

MacOS

Running Mumble

To install Mumble, drag the application from the downloaded disk image into your /Applications folder.

Running Murmur

Murmur is distributed separately from the Mumble client on MacOS. 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" in the Linux/Unix section below.

Linux/Unix

Running Mumble

If you have installed Mumble through your distributon's package repostory, you should be able to find Mumble in your start menu. No additional steps necessary.

Running Murmur

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 a 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 an 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.

OpenGL Overlay

The OpenGL overlay works by intercepting the call to switch buffers, and just before the buffer switch, we draw our nice GUI.

To load a game with the overlay enabled, start the game like this: LD_PRELOAD=/path/to/libmumble.so.1.1 gamename

If you have Mumble installed through the binary packages, this can be done by simply typing: mumble-overlay gamename

Global Keyboard Events

On Linux, Mumble supports reading the kernel input devices. To use this, make sure mumble can open /dev/input/event* for reading. To test it out, that should only require:

  sudo chmod a+r /dev/input/event*

However, be aware that this will most likely only last until the next reboot (at which point devfs is recreated) and you also allow any program run by any user to monitor the physical keyboard.

Without this, Mumble will continuously poll the mouse and keyboard state for changes, which will use a tiny bit of processing power.