PYMUMBLE python library
This library is a fork of a fork of a fork (initial from https://github.com/Robert904/pymumble). But we will try to make
pymumble better. So I consider this fork (the @Azlux one) the current fork alive of
The wiki/API explanation is HERE.
The Python 2 version is available in the master branch. It's working! But since we have moved on to Python 3, the Python 2 version will not receive future improvements.
List of applications using
For a client application example, you can check this list :
- Compatible with Mumble 1.2.4 and normally 1.2.3 and 1.2.2
- Support OPUS. Speex is not supported
- Receive and send audio, get users and channels status
- Set properties for users (mute, comments, etc.) and go to a specific channel
- Callback mechanism to react on server events
- Manage the blobs (images, long comments, etc.)
- Can send text messages to user and channel
- Ping statistics
What is missing:
I don't need those features, so if you want one, open an issue and I will work on it.
- UDP media. Currently it works only in TCP tunneling mode (the standard fallback of Mumble when UDP is not working)
- basically server management (user creation and registration, ACLs, groups, bans, etc.)
- Positioning is not managed, but it should be easy to add
- Audio targets (whisper, etc.) is not managed in outgoing audio, and has very basic support in incoming
- Probably a lot of other small features
The library is based on the Mumble object, which is basically a thread. When started, it will try to connect to the server and start exchange the connections messages with the server. This thread is in a loop that take care of the pings, send the commands to the server, check for incoming messages including audio and check for audio to be sent. The rate of that loop is controlled by how long it will wait for an incoming message before going further.
You can now check if the thread is alive with
mumble_object.isAlive(). The Mumble object will stop itself if it is disconnected from the server.
Useful if you need to restart it with a loop are a supervisor.
requirement.txt to know the versions of
pip3 because it's a Python 3 library (
apt-get install python3-pip) to install dependencies (
pip3 install -r requirements.txt).
Copyright Robert Hendrickx email@example.com - 2014
pymumble is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.