154 lines
6.2 KiB
Markdown
154 lines
6.2 KiB
Markdown
![Mumble screenshot](screenshots/Mumble.png)
|
|
|
|
# Mumble - Open Source voice-chat software
|
|
|
|
[![https://www.mumble.info](https://img.shields.io/badge/Website-https%3A%2F%2Fwww.mumble.info-blue?style=for-the-badge)](https://www.mumble.info)
|
|
|
|
[![#mumble:matrix.org](https://img.shields.io/matrix/mumble:matrix.org?label=%23mumble:matrix.org&style=for-the-badge)](https://matrix.to/#/#mumble:matrix.org)
|
|
|
|
[![Codacy](https://img.shields.io/codacy/grade/262a5e20c83a40599050e22e700d8a3e?label=Codacy&style=for-the-badge)](https://app.codacy.com/manual/mumble-voip/mumble)
|
|
[![Azure](https://img.shields.io/azure-devops/build/Mumble-VoIP/c819eb06-7b22-4ef3-bbcd-860094454eb3/1?label=Azure&style=for-the-badge)](https://dev.azure.com/Mumble-VoIP/Mumble)
|
|
[![Cirrus CI](https://img.shields.io/cirrus/github/mumble-voip/mumble?label=Cirrus%20CI&style=for-the-badge)](https://cirrus-ci.com/github/mumble-voip/mumble)
|
|
[![Travis CI](https://img.shields.io/travis/com/mumble-voip/mumble?label=Travis%20CI&style=for-the-badge)](https://travis-ci.com/mumble-voip/mumble)
|
|
|
|
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, OpenBSD, 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](https://wiki.mumble.info/wiki/Main_Page). The
|
|
[FAQ](https://wiki.mumble.info/wiki/FAQ/English) can also be found there.
|
|
|
|
|
|
## Contributing
|
|
|
|
We always welcome contributions to the project. If you have some 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](COMMIT_GUIDELINES.md).
|
|
|
|
If you are new to the Mumble project, you may want to check out the general [introduction to the Mumble source code](docs/dev/TheMumbleSourceCode.md).
|
|
|
|
### 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](https://hosted.weblate.org/accounts/register/), and join [our translation project](https://hosted.weblate.org/projects/mumble/).
|
|
|
|
### Writing plugins
|
|
|
|
Mumble supports general-purpose plugins that can provide functionality that is not implemented in the main Mumble application. You can find more
|
|
information on how this works and how these have to be created in the [plugin documentation](docs/dev/plugins/README.md).
|
|
|
|
## Building
|
|
|
|
For information on how to build Mumble, check out [the dedicated documentation](docs/dev/build-instructions/README.md).
|
|
|
|
|
|
## 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](https://github.com/mumble-voip/mumble/issues/new/choose).
|
|
|
|
|
|
## Code Signing
|
|
|
|
We graciously acknowledge that this program uses free code signing provided by
|
|
[SignPath.io](https://signpath.io?utm_source=foundation&utm_medium=github&utm_campaign=mumble), and a free code signing certificate by the
|
|
[SignPath Foundation](https://signpath.org?utm_source=foundation&utm_medium=github&utm_campaign=mumble).
|
|
|
|
## Windows
|
|
|
|
### Running Mumble
|
|
|
|
After installation, you should have a new Mumble folder in your
|
|
Start Menu, from which you can start Mumble.
|
|
|
|
### Running Murmur
|
|
|
|
Double-click 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 distribution package
|
|
repository, you should be able to find Mumble in your start menu. No
|
|
additional steps are 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.
|
|
```
|
|
|
|
#### Build and run from Docker
|
|
|
|
On recent Docker versions, you can build images directly from sources on GitHub:
|
|
```bash
|
|
docker build --pull -t mumble-server github.com/mumble-voip/mumble#master
|
|
```
|
|
Example `--pull`s each time to check for updated base image, then downloads and builds `master` branch.
|
|
|
|
You can also specify the user ID (UID) and group ID (GID) for the *murmur* user in the image. This allows users who use bind mount volumes to use the same UID/GID in the container as in the host:
|
|
```bash
|
|
docker build --pull -t mumble-server --build-arg UID=1234 --build-arg GID=1234 github.com/mumble-voip/mumble#master
|
|
```
|
|
|
|
### 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:
|
|
```bash
|
|
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:
|
|
```bash
|
|
mumble-overlay gamename
|
|
```
|