You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Russ Garrett 058f0f4eee
Add option to close TCP connection after message
7 lat temu
examples Add option to close TCP connection after message 7 lat temu
httplistener Improved HTTP logging 7 lat temu
tcplistener Add option to close TCP connection after message 7 lat temu
.travis.yml Add version info 7 lat temu
LICENSE License and readme 7 lat temu
README.md Auth list improvements 7 lat temu
auth.go Auth list improvements 7 lat temu
command.go Add auth for commands 7 lat temu
main.go Remove debug 7 lat temu

README.md

irccat

Build Status

A reimplementation of irccat, the original ChatOps tool, in Go.

irccat lets you easily send events to IRC channels from scripts and other applications.

Installation

Download the latest release from Github, put the example config in /etc/irccat.json or the local directory and customise it, and run!

 TCP → IRC

Just cat a string to the TCP port -- it’ll be sent to the first channel defined in your channel list:

echo "Hello world" | nc -q 0 irccat-host 12345

Or specify a channel or nickname to send to:

echo "#channel Hello world" | nc -q 0 irccat-host 12345
echo "@nick Hello world" | nc -q 0 irccat-host 12345

IRC formatting is supported (see a full list of codes):

echo "Status is%GREEN OK %NORMAL" | nc -q 0 irccat-host 12345a

HTTP → IRC

There’s a simple HTTP endpoint for sending messages:

curl -X POST http://irccat-host:8045/send -d
    '{"to": "#channel", "body": "Hello world"}

There are also endpoints which support app-specific webhooks, currently:

  • Grafana alerts can be sent to /grafana. They will be sent to the channel defined in http.listeners.grafana.

More HTTP listeners welcome!

Note that there is (currently) no authentication on the HTTP endpoints, so you should make sure you firewall them from the world.

IRC → Shell

You can use irccat to execute commands from IRC:

?commandname string of arguments

This will call your commands.handler script with the command-line arguments:

nickname [channel] respond_to commandname [string of arguments]

irccat will only recognise commands from users in private message if the user is joined to commands.auth_channel defined in the config.

Full list of differences from RJ/irccat

  • Supports TLS connections to IRC servers.
  • HTTP endpoint handlers.
  • Doesn’t support !join, !part commands, but does automatically reload the config and join new channels.
  • Arguments are passed individually to the command handler script, rather than in one string as a single argument.