mumble-voip/mumble
GitHub: mumble-voip/mumble
Mumble 是一款基于 Qt 和 Opus 构建的开源低延迟语音聊天软件,采用客户端与服务端分离架构,支持自建服务器和游戏内覆盖显示。
Stars: 7799 | Forks: 1293

# Mumble - 开源语音聊天软件
[](https://www.mumble.info)
[](https://matrix.to/#/#mumble:matrix.org)
[](https://app.codacy.com/manual/mumble-voip/mumble)
[](https://dev.azure.com/Mumble-VoIP/Mumble)
[](https://cirrus-ci.com/github/mumble-voip/mumble)
[](https://travis-ci.com/mumble-voip/mumble)
Mumble 是一个开源、低延迟和高质量的语音聊天程序,
基于 Qt 和 Opus 构建。
Mumble 包含两个模块:客户端 (mumble) 和服务器 (mumble-server,前身是 murmur)。
客户端支持 Windows、Linux、FreeBSD、OpenBSD 和 macOS,
而服务器应该可以在任何可以安装 Qt 的平台上运行。
项目的文档可以在[网站](https://www.mumble.info/documentation/)上找到。
## 贡献
我们始终欢迎对项目的贡献。如果您有一些想要贡献的代码,请随时创建 PR。在这样做的同时,
请尽量确保您遵循我们的[提交指南](COMMIT_GUIDELINES.md)。
如果您是 Mumble 项目的新手,您可能想查看关于 [Mumble 源代码的通用介绍](docs/dev/TheMumbleSourceCode.md)。
### 翻译
Mumble 支持多种语言。我们一直在寻找合格的人员来贡献翻译。
我们使用 Weblate 作为翻译平台。[在 Weblate 上注册](https://hosted.weblate.org/accounts/register/),并加入[我们的翻译项目](https://hosted.weblate.org/projects/mumble/)。
### 编写插件
Mumble 支持通用插件,可以提供主 Mumble 应用程序中未实现的功能。您可以在[插件文档](docs/dev/plugins/README.md)中找到更多关于其工作原理以及如何创建这些插件的信息。
## 构建
有关如何构建 Mumble 的信息,请查看[专门的文档](docs/dev/build-instructions/README.md)。
确保切换到此存储库中的相应分支以获取正确的构建文档。当前的 ``master`` 分支包含
未来 Mumble 版本的不稳定代码。如果您想构建已发布的 Mumble 稳定版本,例如 ``1.5.735``,请选择
对应的分支,例如 ``1.5.x``,在上面的下拉菜单中。或者,使用相应发布压缩包中的文档。
## 报告问题
如果您想报告错误或创建功能请求,您可以在 [GitHub](https://github.com/mumble-voip/mumble/issues/new/choose) 上打开一个新问题(在您检查确认没有重复问题之后)。
## 代码签名
我们诚挚地感谢该程序使用了由 [SignPath.io](https://signpath.io?utm_source=foundation&utm_medium=github&utm_campaign=mumble) 提供的免费代码签名,
以及由 [SignPath Foundation](https://signpath.org?utm_source=foundation&utm_medium=github&utm_campaign=mumble) 提供的免费代码签名证书。
## Windows
### 运行 Mumble
安装后,您的开始菜单中应该会有一个新的 Mumble 文件夹,
您可以从中启动 Mumble。
### 运行 Mumble-Server
双击图标以启动 ``mumble-server``。您的任务栏上会有一个小图标,
您可以通过它查看日志。
要设置超级用户密码,请使用参数 `--set-su-pw ` 运行 ``mumble-server``。
## MacOS
### 运行 Mumble
要安装 Mumble,请将应用程序从下载的磁盘镜像拖拽到您的 `/Applications` 文件夹中。
### 运行 Mumble-Server
``mumble-server`` 在 MacOS 上与 Mumble 客户端分开分发。
它被称为 Static OS X Server,可以从主页下载。
下载后,可以像在任何其他类 Unix 系统上一样运行。
欲了解更多信息,请参阅下面 Linux/Unix 部分中的“Running mumble-server”。
## Linux/Unix
### 运行 Mumble
如果您通过发行版软件包仓库安装了 Mumble,您应该可以在开始菜单中找到 Mumble。
无需额外的步骤。
### 运行 Mumble-Server
``mumble-server`` 应该从命令行运行,因此启动一个 shell(命令提示符)
并转到您安装 Mumble 的位置。以
```
mumble-server [--set-su-pw ] [--ini ] [--foreground] [--verbose]
--set-su-pw 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, mumble-server will
set the password in the database and then exit.
--ini Use an inifile other than mumble-server.ini, use this to run several instances
of mumble-server from the same directory. Make sure each instance is using
a separate database.
--foreground Run in the foreground, logging to standard output.
--verbose More verbose logging.
```
#### Docker 镜像
我们的官方 Docker 镜像以及使用说明可以在 https://github.com/mumble-voip/mumble-docker 找到。
### 服务器配置
您可以在[此存储库](auxiliary_files/mumble-server.ini)中找到最新的 ``mumble-server`` 配置模板。
更多的服务器配置文档可以在[项目网站](https://www.mumble.info/documentation/administration/)上找到。
### OpenGL Overlay
OpenGL overlay 的工作原理是拦截缓冲区切换调用,并且
在缓冲区切换之前,我们绘制我们漂亮的 GUI。
要在启用 overlay 的情况下加载游戏,请像这样启动游戏:
```
LD_PRELOAD=/path/to/libmumble.so.1.1 gamename
```
如果您通过二进制包安装了 Mumble,可以通过
简单地输入以下命令来完成:
```
mumble-overlay gamename
```
标签:Bash脚本, Mumble, Murmur, Opus, UDP, VoIP, 低延迟, 免费, 加密通讯, 团队协作, 实时通讯, 客户端, 服务器, 游戏通讯, 语音聊天, 请求拦截, 调试插件, 音频处理, 高质量语音