This is simple IRC bot allowing users to execute predefined set of shell commands on machine on which bot is running.
pip install ircmdbot
You can simply execute ircmdbot command passing two configuration file paths as arguments:
# ircmdbot <config_file.yaml> <commmands_file>
It is general configuration file.
Example contents:
server: port80a.se.quakenet.org
port: 6667
nickname: ircmdtdbd
secret: godsavethequeen
Configuration params are:
- server - hostname of IRC server to connect to
- port - TCP port to be used to connect to IRC server
- nickname - nickname to be used by bot
- secret - secret token to be used for authorization when sending commands to bot
Lists commands which can be run through the bot. Each command is keyed with alias and nickname.
Format of configuration line in commands_file is:
<user> <alias> <command>
Example contents:
frank dosth /home/frank/bin/dosth
frank dosth_different /home/frank/bin/dosth_different
steve dosth /home/steve/bin/dosth
Users interact with bot using private messages. Each command is single line in following format.
<secret> <command_alias>
<secret> must be equal to secret from config_file.yaml.
<command_alias> is one of aliases defined for user talking to bot in commands_file.
Special <command_alias> die is supported and kills bot process.