|Jonas Jelten b099f9cb0f mumble: update protobuf generated file||6 months ago|
|bin||3 years ago|
|doc||3 years ago|
|sftbot||6 months ago|
|.gitignore||3 years ago|
|COPYING||3 years ago|
|LICENSE||3 years ago|
|Makefile||3 years ago|
|README.md||3 years ago|
|run||3 years ago|
|setup.py||3 years ago|
|sftbot.conf.example||3 years ago|
This bot provides a text bridge between an IRC channel and a Mumble server.
You can directly run sftbot by typing
python2 -m sftbot.
To permanently install sftbot, type
sudo ./setup.py install. Then, you can run it by typing
You need to provide a config file that (among others) contains user credentials for the bot. An example conf file can be found in
You can either specify a conf file path as a command line argument (
sftbot myconffile.conf), or place it at
By default, the bot
However, this behaviour can be altered easily by editing
sftbot/__main__.py, which contains several fairly self-explainatory callback functions that will be automatically invoked at the appropriate times.
For example, certain IRC messages may be ignored by adding a line
if message.contains('bannedtext'): return to the top of
More complex, 'botty' behaviour may be implemented the same way; note that you can call
mumble.sendTextMessage() from everywhere within the callback functions.
Nice-to-have features (which we don't plan to implement right now, but feel free to do it yourself):
<your distribution here>
Mumble uses Google Protobuf for most of its communications; this means that one code file needs to be auto-generated (that's what the
Makefile is there for). Unfortunately,
protoc does not officially support
python3, so we're forced to deal with
python2 and all its string buffer ugliness.
You can find us at
irc.freenode.net/#sfttech. If you found a bug, feel free to join and randomly insult channel OPs until someone fixes it (or bans you).
Alternatively, fix it yourself and send a pull request.
COPYING. The license is GPLv3 or higher.