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 b7e8db2ad1
Merge PR #4426: FIX(packaging): Enable mac-script to run multiple times
20 hours ago
.ci CI(azure): Disable environment caching 3 days ago
.github .github/stale.yml: Configure stale-bot 4 months ago
.tx Add transifex client configuration for project. 6 years ago
3rdPartyLicenses scripts/mklic.pl, 3rdPartyLicenses: add libffi license. 2 years ago
3rdparty 3rdparty/mach-override-build: add CMake project 1 month ago
cmake FIX(cmake): set CMAKE_WIX_UPGRADE_GUID and generate CMAKE_WIX_PRODUCT_GUID 4 days ago
docs MAINT(readme): Move READMEs for static server into docs/ 1 month ago
g15helper Add install() directives, for "install" step and CPack 1 month ago
icons themes: add "Classic - Old Style" theme 1 year ago
installer installer: add WiX files for CPack 1 month ago
macx FIX(packaging): Enable mac-script to run multiple times 21 hours ago
man man: update murmurd.1 to mention SIGHUP and SIGUSR1. 3 years ago
overlay FIX(overlay): only use minhook for 64 bit overlay library 3 weeks ago
overlay_gl Added experimental check for g++-multilib when compiling 32bit overlay 1 month ago
overlay_winx64 Update copyright years in .plist and .rc files 7 months ago
plugins Add install() directives, for "install" step and CPack 1 month ago
qmake CXX-STANDARD: Enforce (at least) cpp14 2 months ago
samples Add sound for recording state change notifications 10 years ago
screenshots screenshots: Added Mumble screenshots 4 months ago
scripts CI(installer): Only build a few cultures by default 1 week ago
src FIX(client): Compile error without manual plugin 1 day ago
themes FEAT(client): Indicate talking users when locally muted 1 month ago
.cirrus.yml CI: Build with CMake 1 month ago
.gitignore Update gitignore 1 year ago
.gitmodules 3rdparty: Removed sbcelt submodule as it is not used and broken 3 months ago
.lgtm.yml .lgtm.yml: Prepare for Ubuntu 19.10 10 months ago
.mailmap Added aliases of Robert Adam 6 months ago
.travis.yml REFAC(ci): move scripts to dedicated ".ci" folder 4 weeks ago
AUTHORS AUTHORS: update via scripts/generate-AUTHORS.py. 7 months ago
CHANGES Update AUTHORS and CHANGES. 3 years ago
CMakeLists.txt MAINT: Disable warnings for 3rdparty projects 6 days ago
COMMIT_GUIDELINES.md MAINT: Create commit guidelines 2 months ago
Dockerfile Dockerfile: use regex for protobuf and grpc package names 3 months ago
Doxyfile Doxyfile: set "EXTRACT_ALL" to "YES" 7 months ago
INSTALL INSTALL: undocument 'no-directsound' option 10 months ago
LICENSE LICENSE, LICENSE.header: add 2020 to the copyright range 7 months ago
LICENSE.header LICENSE, LICENSE.header: add 2020 to the copyright range 7 months ago
README.md MAINT(readme): Added info about reporting issues 1 month ago
SECURITY.md Add link to advisories in SECURITY.md 2 months ago
main.pro Auto-update LICENSE.header in source files 7 months ago
sonar-project.properties Travis CI: add SonarCloud integration for static code analysis 1 year ago

README.md

Mumble screenshot

Mumble - Open Source voice-chat software

https://www.mumble.info

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

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