You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
Davide Beatrici da5b6edd07
Merge PR #4918: MAINT: Add Code of Conduct
2 days ago
.ci/azure-pipelines CI(azure): Clean entire workspace before starting 6 days ago
.github CI: Added check to prevent CRLF endings 2 weeks ago
.tx Add transifex client configuration for project. 7 years ago
3rdPartyLicenses FORMAT: Removed CRLF line endings 2 weeks ago
3rdparty FIX(client): Update rnnoise-src submodule 1 month ago
cmake BUILD(cmake): Fix unity build failure 1 month ago
docs DOCS: Mention unity builds 1 month ago
g15helper MAINT: Update copyright notice to 2021 1 month ago
helpers/vcpkg/ports/zeroc-ice MAINT: Update hash in Ice port file (vcpkg) 5 days ago
icons MAINT: Added Mumble PNG image 6 months ago
installer MAINT: Update copyright notice to 2021 1 month ago
macx BUILD(cmake): Make unity builds possible 1 month ago
man DOCS(man): Add missing options from help messages to man pages 8 months ago
overlay BUILD(cmake): Make unity builds possible 1 month ago
overlay_gl MAINT: Update copyright notice to 2021 1 month ago
overlay_winx64 BUILD(versioning): Make use of the 4th part (build/tweak) of the version 3 months ago
plugins FIX(positional-audio): Update Among Us plugin to work with v2021.3.31.3s 1 week ago
samples Add sound for recording state change notifications 11 years ago
screenshots MAINT(docs): the Game bar trigger must be disabled for the guide button to work 6 months ago
scripts MAINT: Add `CHANGE` commit type 7 days ago
src Merge PR #4920: FIX(client): Check the returned error code of ALSA 4 days ago
themes FEAT(client): Indicate talking users when locally muted 9 months ago
.cirrus.yml MAINT: Update copyright notice to 2021 1 month ago
.clang-format MAINT: Added clang-format support 7 months ago
.gitignore MAINT: Ignore local Visual Studio CMake settings file CMakeSettings.json 3 weeks ago
.gitmodules BUILD(qmake): Remove 7 months ago
.mailmap Added aliases of Robert Adam 1 year ago
AUTHORS AUTHORS: update via scripts/generate-AUTHORS.py. 1 year ago
CHANGES Update AUTHORS and CHANGES. 4 years ago
CMakeLists.txt BUILD(cmake): Increase unity build batch size 1 month ago
CODE_OF_CONDUCT.md MAINT: Add Code of Conduct 4 days ago
COMMIT_GUIDELINES.md MAINT: Add `CHANGE` commit type 7 days ago
Dockerfile MAINT(docker): added missing sql driver 2 months ago
Doxyfile Doxyfile: set "EXTRACT_ALL" to "YES" 1 year ago
LICENSE MAINT: Update copyright notice to 2021 1 month ago
README.md MAINT: Add Weblate and translation notice to README.md 1 month ago
SECURITY.md Add link to advisories in SECURITY.md 11 months ago

README.md

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 Windows, Linux, FreeBSD and macOS, while the server should work on anything Qt can be installed on.

Please note that with "Windows" we mean 7 and newer. Vista may be supported, but we can't guarantee it. If you don't want to encounter potential issues, you may download Mumble 1.3.x, the last version to provide support for XP.

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

Contributing

We always welcome contributions to the project. If you have code that you would like to contribute, please go ahead and create a PR. While doing so, please try to make sure that you follow our commit guidelines.

Translating

Mumble supports various languages. We are always looking for qualified people to contribute translations.

We are using Weblate as a translation platform. Register on Weblate, and join our translation project.

Building

For information on how to build Mumble, checkout the dedicated documentation.

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