Go to file
2013-03-23 17:16:45 +01:00
modules Source plugin now handles groups 2013-03-23 17:16:45 +01:00
modules-available Source plugin ini diverged from py defaults. 2013-03-23 17:16:44 +01:00
tools Make non-module folders also look like modules to improve handling in PyDev 2013-03-23 17:16:44 +01:00
config_test.py Add source module to mumo 2013-03-23 17:16:44 +01:00
config.py Use RawConfigParser so we can load python style template syntax from configs 2013-03-23 17:16:44 +01:00
init-script Example init script for mumo 2012-08-25 18:25:31 -07:00
mumo_manager_test.py Sink log output in unit tests 2013-03-23 17:16:44 +01:00
mumo_manager.py Fix misleading error message 2011-04-16 05:25:59 +02:00
mumo_module.py Modify idlemove module to be able to chain thresholds for moving and add source channel filters 2010-12-27 02:42:23 +01:00
mumo.ini Improve mumo behavior with platforms in which Ice.getSliceDir behaves unexpected 2013-03-23 17:16:31 +01:00
mumo.py Improve mumo behavior with platforms in which Ice.getSliceDir behaves unexpected 2013-03-23 17:16:31 +01:00
README Remove outdated sketches.txt and add run instructions to README 2013-03-23 17:16:45 +01:00
testsuite.py Add source module to mumo 2013-03-23 17:16:44 +01:00
worker_test.py Sink log output in unit tests 2013-03-23 17:16:44 +01:00
worker.py Nearly finished basic mumo application. config, worker and mumo_module have test coverage. mumo_manager is not yet covered and most likely not right yet. 2010-11-20 03:36:50 +01:00

mumo - The Mumble moderator
===========================

Mumo is meant to provide a platform on which python based Mumble server
plugins can be built upon. The goal is to reduce the boilerplate needed
to interact with the Mumble server to a minimum.

To achieve this goal tasks like Ice interface setup, basic error
handling, configuration management, logging and more are provided
by mumo. Developers can focus on their specific functionality instead.

Currently mumo comes with the following modules:

 * bf2: Battlefield 2 game management plugin that can dynamically
        move players into appropriate channels and groups to fit
        the in-game command structure. This is achieved by using
        data gathered from Mumble's positional audio system and does
        not require cooperation by the game server. 

 * idlemove: Plugin for moving players that have been idle for
        a configurable amount of time into a idle channel. Optionally
        the players can be muted/deafened on move.

 * onjoin: Moves players into a specific channel on connect regardless
        of which channel they were in when they left last time.

 * seen: Makes the server listen for a configurable keyword to ask for
        the last time a specific nick was seen on the server.

 * source: Source game management plugin that can dynamically move
        players into on-the-fly created channel structures representing
        in-game team setup. This is achieved by using data gathered from
        Mumble's positional uadio system and does not require cooperation
        by the game server. Currently the following source engine based
        games are supported: Team Fortress 2, Day of Defeat: Source,
        CounterStrike: Source, Half Life 2: Death Match.

 * test: A debugging plugin that registers for all possible events and
        outputs every call with parameters into the debug log.

If you have a module that you would like to see shipped with mumo or
have any improvements or suggestions please contact us. Whether you
prefer a pull request, visiting us in IRC in #mumble on Freenode or
starting a thread in our forums at http://sourceforge.net/apps/phpbb/mumble/ is up to you.

To configure and run mumo take a look at the mumo.ini and the module
specific configurations in modules-available folder. Enabling modules
is done by linking the configuration in modules-available to the
modules-enabled folder.

mumo requires:
 - python 2.7*
 - python-zeroc-ice
 - murmur >=1.2.3*

* Not tested with lower versions yet