Home

mumbot

Bots that join your Mumble server like a person would: post alerts, drive tests, fill channels.

Mumbot is one small binary (or Docker image) with headless bots for Mumble voice chat. Every bot logs in with its own certificate, exactly like a person with a Mumble client. It works with any unmodified, standard Mumble server: no server plugin, no server config change, no protocol extension.

Mumbot comes from the makers of Mumcord, a modern Mumble client. You do not need Mumcord to use it.

Modules

Module	What it does	Status
Webhook	A script, monitoring or CI sends one HTTP request with an API key; the bot posts it into a channel. See Webhook.	Available
Test bot	A scripted second participant for automated tests: chat, user state, admin steps, expect checks, voice checks. See Test bot CLI.	Available
Load test	Fills a local server with up to 1000 users. See Voice checks and load test.	Available
Music, History, Peer, Modular	Planned. See Roadmap.	Coming

Quick links

• Installation: binaries, Docker, from source
• Configuration: the bot.toml file
• Webhook: HTTP API and curl examples
• Examples: ready-made Docker Compose setups
• Security: API keys, certificate, TLS
• Development and testing and Roadmap

Quick start

docker pull ghcr.io/mumcord/mumbot:0.1.1

Then follow Installation and Webhook. The full reference docs live in the repository.