Mumble is an open-source, low-latency, high quality voice chat software.
Go to file
Davide Beatrici 2ee48b07c0 macx/scripts: allow to specify custom source and binary directories
Our qmake project forcibly put binaries into the "release" folder, inside the repository.

With the CMake project this is not the case: the source and binary directories can even reside on different drives.

Unfortunately the binary directory was hardcoded in both "build-overlay-installer" and "osxdist.py".
As for the source directory, both scripts simply expected to be run from the repository's root.

This commit adds the "--source-dir" and "--binary-dir" options to "osxdist.py". Default values: "." and "build", respectively.

"build-overlay-installer" now expects its working directory to be the binary folder.
No options are added; they are not required because the script is executed by "osxdist.py", which takes care of setting the working directory.

Extra change: "build-overlay-installer" now uses "PlistBuddy" rather than "defaults", because the latter doesn't support reading from a file anymore in macOS Catalina (10.15).
2020-07-11 19:37:18 +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 3rdparty/mach-override-build: add CMake project 2020-07-11 19:34:49 +02:00
3rdPartyLicenses scripts/mklic.pl, 3rdPartyLicenses: add libffi license. 2018-02-11 11:54:20 +01:00
cmake Add CMake functions and modules 2020-07-11 19:34:49 +02:00
docs MAINT(readme): Move READMEs for static server into docs/ 2020-07-08 17:55:46 +02:00
g15helper g15helper: add CMakeLists.txt 2020-07-11 19:34:49 +02:00
icons themes: add "Classic - Old Style" theme 2019-03-21 07:27:29 +01:00
installer MAINT(readme): Deleted README in favor of README.md 2020-07-08 17:55:46 +02:00
macx macx/scripts: allow to specify custom source and binary directories 2020-07-11 19:37:18 +02:00
man man: update murmurd.1 to mention SIGHUP and SIGUSR1. 2017-04-24 22:31:32 +02:00
overlay overlay: add CMakeLists.txt files 2020-07-11 19:34:49 +02:00
overlay_gl overlay_gl: add CMakeLists.txt 2020-07-11 19:34:50 +02:00
overlay_winx64 Update copyright years in .plist and .rc files 2020-01-07 03:12:11 +01:00
plugins Plugins: add CMakeLists.txt files 2020-07-11 19:34:49 +02:00
qmake CXX-STANDARD: Enforce (at least) cpp14 2020-06-05 08:58:20 +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 Merge pull request #4147: FEAT(server): Add rememberduration option 2020-07-08 19:21:27 +02:00
src Tests: add CMakeLists.txt files 2020-07-11 19:34:49 +02:00
themes FEAT(client): Indicate talking users when locally muted 2020-07-02 17:29:05 +02:00
.azure-pipelines.yml CI: Added check for unprocessed translations 2020-05-10 13:01:57 +02:00
.cirrus.yml Merge pull request #3987: Make VersionCheck prepare asynchronously 2020-04-07 11:13:04 +02:00
.gitignore Update gitignore 2018-12-30 23:54:13 -06:00
.gitmodules 3rdparty: Removed sbcelt submodule as it is not used and broken 2020-05-07 08:14:09 +02:00
.lgtm.yml .lgtm.yml: Prepare for Ubuntu 19.10 2019-10-18 14:01:05 +02:00
.mailmap Added aliases of Robert Adam 2020-01-28 12:47:16 +01:00
.travis.yml Travis CI: disable SonarCloud scanner, incompatible with Ubuntu Bionic (18.04) 2019-10-15 02:59:55 +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 Add main CMakeLists.txt files 2020-07-11 19:34:49 +02:00
COMMIT_GUIDELINES.md MAINT: Create commit guidelines 2020-06-15 08:11:35 +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
main.pro Auto-update LICENSE.header in source files 2020-01-07 03:09:22 +01:00
README.md MAINT(readme): Added info about reporting issues 2020-07-09 16:33:35 +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 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.