commitbot/README.markdown

commitbot

Commitbot is an XMPP bot that notifies multi-user chat rooms (MUCs) of git repository commits.

It uses the GitHub post-receive web hook to get push notifications of repository changes.

Dependencies

• Twisted 8.1.x or later
• Wokkel 0.4 or later
• simplejson

Note that on Ubuntu/Debian systems Twisted is split into various pieces. You will want:

• python-twisted-words
• python-twisted-names

in addition to the normal Twisted package.

Usage

Copy commitbot.tac.example to commitbot.tac changing the JID, password, room name, and room nickname to something appropriate. Then launch it with twistd.

twistd -y commitbot.tac