Mumble is an open-source, low-latency, high quality voice chat software.
Go to file
Davide Beatrici 68873e5ed0 FIX(positional-audio): Wrong character size used for wide strings
"wchar_t" is usually 4 bytes big. That's not the case on Windows, where it's 2 bytes instead.

We cannot rely on that type on Linux because the target process could be native or running through Wine.

Also, it's possible that a game uses the same size for "wchar_t" on both Linux and Windows.

This commit introduces two variants of utf16ToUtf8():

1. Accepts std::u16string, for Windows processes.
2. Accepts std::u32string, for Linux processes.

The old variant, which accepted std::wstring, is removed to prevent misuses.
2020-11-04 20:32:32 +01:00
.ci CI: Display install paths 2020-10-28 15:39:28 +01: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 FEAT(client): load PulseAudio at runtime 2020-09-13 20:12:54 +02:00
3rdPartyLicenses scripts/mklic.pl, 3rdPartyLicenses: add libffi license. 2018-02-11 11:54:20 +01:00
cmake BUILD(cmake): Only install shared libraries 2020-10-29 12:02:12 +01:00
docs Merge pull request #4557: DOCS: Added info for building with powershell 2020-11-01 12:56:47 +01:00
g15helper Merge pull request #4503: BUILD(cmake): Revamp install paths 2020-10-24 17:38:56 +02:00
helpers/vcpkg/ports/zeroc-ice DOCS: Restructure and include build-documentation 2020-10-12 08:16:01 +02:00
icons MAINT: Added Mumble PNG image 2020-10-18 09:15:58 +02: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 Merge pull request #4503: BUILD(cmake): Revamp install paths 2020-10-24 17:38:56 +02:00
overlay_gl Merge pull request #4503: BUILD(cmake): Revamp install paths 2020-10-24 17:38:56 +02:00
overlay_winx64 MAINT: Make use of cmake configure for version 2020-09-02 18:30:33 +02:00
plugins FIX(positional-audio): Wrong character size used for wide strings 2020-11-04 20:32:32 +01:00
samples Add sound for recording state change notifications 2010-08-25 23:24:37 +02:00
screenshots MAINT(docs): the Game bar trigger must be disabled for the guide button to work 2020-10-10 21:08:22 +02:00
scripts BUILD: Support working directories other than repository root 2020-10-30 22:30:18 +01:00
src TRANSLATION: Update translation files 2020-11-03 17:17:37 +01:00
themes FEAT(client): Indicate talking users when locally muted 2020-07-02 17:29:05 +02:00
.cirrus.yml CI: Enable gRPC support 2020-10-24 14:47:17 +02:00
.clang-format MAINT: Added clang-format support 2020-09-11 18:28:38 +02:00
.gitignore MAINT: Ignore build directory 2020-09-11 18:14:05 +02: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 Merge pull request #4503: BUILD(cmake): Revamp install paths 2020-10-24 17:38:56 +02:00
COMMIT_GUIDELINES.md MAINT: Added BUILD type to commit guidelines 2020-08-31 17:30:53 +02:00
Dockerfile MAINT(docker): Add ca-certificates package 2020-10-29 08:59:59 +01:00
Doxyfile Doxyfile: set "EXTRACT_ALL" to "YES" 2019-12-26 20:27:52 +01: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 DOCS: Restructure and include build-documentation 2020-10-12 08:16:01 +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 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.

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