Browse Source

Docs updates

tags/v0.1.5
Russ Garrett 7 years ago
parent
commit
e0013fbf9f
No account linked to committer's email address
2 changed files with 21 additions and 11 deletions
  1. 14
    4
      README.md
  2. 7
    7
      examples/irccat.json

+ 14
- 4
README.md View File

@@ -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.

+ 7
- 7
examples/irccat.json View File

@@ -6,20 +6,20 @@
6 6
     "tls_key": "",
7 7
     "tls_cert": "",
8 8
     "listeners": {
9
-      "grafana": "#russtest"
9
+      "grafana": "#channel"
10 10
     }
11 11
   },
12 12
   "irc": {
13
-    "server": "irc.irccloud.com:6667",
14
-    "tls": false,
15
-    "tls_skip_verify": true,
16
-    "nick": "irccat2",
13
+    "server": "irc.example.com:6697",
14
+    "tls": true,
15
+    "tls_skip_verify": false,
16
+    "nick": "irccat",
17 17
     "realname": "IRCCat",
18 18
     "identify_pass": "",
19
-    "channels": ["#russtest"]
19
+    "channels": ["#channel"]
20 20
   },
21 21
   "commands": {
22
-    "auth_channel": "#russtest",
22
+    "auth_channel": "#channel",
23 23
     "handler": "./examples/command_runner.py",
24 24
     "max_response_lines": 15
25 25
   }

Loading…
Cancel
Save