|
@@ -2,8 +2,18 @@
|
2
|
2
|
[![Build Status](https://travis-ci.org/irccloud/irccat.svg?branch=master)](https://travis-ci.org/irccloud/irccat)
|
3
|
3
|
|
4
|
4
|
A reimplementation of [irccat](https://github.com/RJ/irccat), the
|
5
|
|
-original ChatOps tool, in Go. irccat lets you easily send events
|
6
|
|
-to IRC channels from scripts and other applications.
|
|
5
|
+original ChatOps tool, in Go.
|
|
6
|
+
|
|
7
|
+irccat lets you easily send events to IRC channels from scripts and
|
|
8
|
+other applications.
|
|
9
|
+
|
|
10
|
+## Installation
|
|
11
|
+
|
|
12
|
+Download the [latest
|
|
13
|
+release](https://github.com/irccloud/irccat/releases) from Github, put
|
|
14
|
+the [example
|
|
15
|
+config](https://github.com/irccloud/irccat/blob/master/examples/irccat.json)
|
|
16
|
+in `/etc/irccat.json` or the local directory, and run!
|
7
|
17
|
|
8
|
18
|
## TCP → IRC
|
9
|
19
|
Just cat a string to the TCP port - it'll be sent to the first channel
|
|
@@ -38,12 +48,12 @@ so you should make sure you firewall them from the world.
|
38
|
48
|
## IRC → Shell
|
39
|
49
|
You can use irccat to execute commands from IRC:
|
40
|
50
|
|
41
|
|
- ?commandname arguments
|
|
51
|
+ ?commandname string of arguments
|
42
|
52
|
|
43
|
53
|
This will call your `commands.handler` script with the command-line
|
44
|
54
|
arguments:
|
45
|
55
|
|
46
|
|
- nickname, [channel], respond_to, commandname, [arguments]
|
|
56
|
+ nickname [channel] respond_to commandname [string of arguments]
|
47
|
57
|
|
48
|
58
|
irccat will only recognise commands from users in private message if
|
49
|
59
|
the user is joined to `commands.auth_channel` defined in the config.
|