This plugin listens on a socket (either TCP or UNIX) and whenever someone sends
a message to the socket, it dumps it to a channel.  It has no commands and
requires a bit of a configuration to be useful.

Its original purpose was to parse email messages from Glympse
[http://glympse.com/] piped to it via procmail and announce the enclosed URL.
Script and sample .procmailrc for doing this are included in the archive.

Installation:

1) Copy (or link) the 'MsgPipe' directory to your bot's plugin directory.

2) Configure the bot. First, set the channel (here, #mychan) to which the
   incoming messages are announced:

      !config channel #mychan supybot.plugins.MsgPipe.announce on

   Next, you need to configure where will the plugin listen for the incoming
   messages. There are two possibilities: it can either use unix socket, or a
   network socket. The network socket is preferable if the machine receiving
   the email is not the same machine where the bot is running.

   Using unix socket:

      !config supybot.plugins.MsgPipe.unix on
      !config supybot.plugins.MsgPipe.socketFile /path/to/the/socket

   Using network socket:

      !config supybot.plugins.MsgPipe.unix off
      !config supybot.plugins.MsgPipe.host 0.0.0.0
      !config supybot.plugins.MsgPipe.port 12345

   This will make the bot listen on all interfaces/addresses on port 12345. You
   may also want to set up a firewall so that no one else than the machine on
   which the mail is received can connect

   You have to reload the plugin to actually change those settings.

      !reload MsgPipe

3) Configure the email delivery. Example procmail configuration file that
   pipes all messages from glympse.com to the msgpipe-glympse.py script which
   parses it and sends the url to the bot's socket is provided.

   You may want to adjust the paths to the script and the socket.