irccat

IRC bot that simplifies posting to IRC from shell scripts

IRCcat

As in cat to IRC.

IRCcat does 2 things:

1) Listens on a specific ip:port and writes incoming data to an IRC channel. This is useful for sending various announcements and log messages to irc from shell scripts, Nagios and other services.

2) Hands off commands issued on irc to a handler program (eg: shell script) and responds to irc with the output of the handler script. This only happens for commands addressed to irccat: or prefixed with ?. (easily extend irccat functionality with your own scripts)

Installation

Edit the irccat.xml so it knows which irc server, channel etc.. Check you have sun jvm >=1.5 (java -version)

This will build and package irccat as a jar:

$ ant dist

Then, using the appropriate config file:

$ ant -Dconfigfile=./examples/irccat.xml run

Also, you’ll probably want to install netcat.

Sending text to IRC

By default IRCCat listens on 127.0.0.1:12345, and sends data to the default (first) channels. In a networked server environment you will p robably want to make it listen on the private LAN interface.

Examples:

$ echo “Hello World” | netcat -q0 localhost 12345 $ tail -f /var/log/www/error.log | netcat localhost 12345

In a server environment, consider adding a hostname to your internal DNS or using a virtual IP for irccat to listen on, in case you want to move irccat to another box later.

Sending to specific channels

To send to a specific channel rather than the default, put the channel name as the first word in the data (the channel name will be stripped):

$ echo “#mychannel hello world” | netcat -q0 machinename 12345

This sends “hello world” to #mychannel

First word defines the recipients, you can use comma separated list.

prefix indicates channel, @ indicates a nick.

Examples:

- "#chan blah blah"
  just sends to #chan

- "@RJ psst, this is a pm"
  just sends via PM to user RJ

- "#channel1,#channel2,@RJ,@Russ blah blah this is the message"
  this sends to 2 channels, and 2 users (RJ, Russ)

- "#* Attention, something important"
  this sends to all channels the bot is in	

Built-in commands

There are a handful of built-in commands for instructing the bot at runtime.

Built-in commands are prefixed with a !

!join #chan pass		- joins another channel. pass is optional
!part #chan				- parts chan
!channels				- lists channels the bot is in
!spam blah blah..		- repeats your message in all joined channels
!exit					- System.exit()

Trust

Any command (?.. !..) uttered in a channel with irccat in is executed and implicitly trusted.

Any command PMed to irccat is ignored unless the user is joined to the default (first) channel in the config file.

SVN commit notifications

svn hooks let you announce commits etc. For example, try this in your SVN repo/hooks/post-commit file:

REPOS=“$1” REV=“$2” LOG=/usr/bin/svnlook log -r $REV $REPOS AUTHOR=/usr/bin/svnlook author -r $REV $REPOS echo “SVN commit by $AUTHOR (r$REV) ‘$LOG’ http://web-svn-interface.example.com/?rev=$REV” | netcat -q0 machinename 12345

Nagios alerts to irc

Buried in our nagios config is this, from misccommands.cfg:

define command { command_name host-notify-by-irc command_line /bin/echo “#sys Nagios: Host ‘$HOSTALIAS$’ is $HOSTSTATE$ - Info: $OUTPUT$” | /bin/netcat -q 1 irccathost 12345 }

define command { command_name service-notify-by-irc command_line /bin/echo “#sys Nagios: Service $SERVICEDESC$ on ‘$HOSTALIAS$’ is $SERVICESTATE$ - Info: $OUTPUT$” | /bin/netcat -q 1 irccathost 12345 }

And in contacts.cfg:

define contact{ contact_name irccat alias irccat service_notification_period 24x7 host_notification_period 24x7 service_notification_options w,c,r host_notification_options d,r service_notification_commands service-notify-by-irc host_notification_commands host-notify-by-irc email [email protected] }

Feedback

Email: [email protected] Web: http://www.last.fm/user/RJ (work, and the reason irccat exists) Web: http://www.metabrew.com/ (blog) Irc: irc://irc.audioscrobbler.com/audioscrobbler

Related Repositories

irccat

irccat

IRC bot that simplifies posting to IRC from shell scripts ...

irccat

irccat

cat to IRC ...

irccat

irccat

IRC bot that simplifies posting to IRC from shell scripts ...

willie-irccat

willie-irccat

Willie modules to provide irccat-like functionality to your IRC bot ...

supybot-irccat

supybot-irccat

Supybot plugin relaying data from a tcp port to irc channel(s) ...