This repository was archived by the owner on Jan 31, 2019. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 1.3k
Expand file tree
/
Copy pathirc
More file actions
125 lines (69 loc) · 2.69 KB
/
irc
File metadata and controls
125 lines (69 loc) · 2.69 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
Example
-------
For [freenode](https://freenode.net/):
- Server: `chat.freenode.net`
- Room: `#CHANNELNAME`
- Message without join: _yes_
- Notice: _yes_
- Active: _yes_
Remember to allow [external messages](#message-without-join) and [colors](#no-colors) in the channel:
```
/msg ChanServ set #CHANNELNAME mlock -nc
```
Usage
-----
### Server
IRC server address.
> For freenode, use `chat.freenode.net`
### Port
Port to use when connecting to the IRC server (optional).
Default ports are `6667` (no SSL), and `6697` (SSL).
> [freenode servers](https://freenode.net/irc_servers.shtml) listen on `6665`, `6666`, `6667`, `8000`, `8001`, and `8002` (no SSL and SSL), and `6697`, `7000`, and `7070` (SSL only).
### Room
IRC channel (or channels) to which messages will be sent.
Supports single or multiple channels (comma separated). Also supports channel passwords (`CHANNELNAME::PASSWORD`). Prefixing the channel name with `#` is optional.
### Nick
Nickname to use when sending messages (optional).
### Branches
Names of the git branches (or refs) to monitor for events (comma-separated).
### Nickserv password
Password for the IRC server’s [NickServ](http://en.wikipedia.org/wiki/Internet_Relay_Chat_services) (optional).
> For freenode, see the [nickname setup instructions](https://freenode.net/faq.shtml#nicksetup).
### Password
Password for the IRC server (optional).
### Ssl
Enables connecting to the IRC server via SSL.
### Message without join
Enables sending messages to the channel without joining the channel first.
_Recommended_, as it decreases channel noise. Requires the IRC channel to allow external messages.
> On freenode, allow external messages to the channel by messaging [ChanServ](https://freenode.net/services.shtml):
>
> ```
> /msg ChanServ set #CHANNELNAME mlock -n
> ```
>
> On most other IRC networks, set the channel mode directly:
>
> ```
> /mode #CHANNELNAME -n
> ```
### No colors
Disables colors in messages.
_Enabling_ colors in messages may require the IRC channel to allow colors.
> On freenode, allow colors in the channel by messaging ChanServ:
>
> ```
> /msg ChanServ set #CHANNELNAME mlock -c
> ```
### Long url
Enables including full URLs in messages. When disabled, [git.io](https://git.io/) URLs will be used.
### Notice
Enables sending IRC notices instead of regular messages.
_Recommended_, as it decreases channel noise.
Troubleshooting
---------------
Diagnostic information can be retrieved from GitHub with an HTTP request.
Use your GitHub `USERNAME` and `PASSWORD` to authenticate, and specify the appropriate repository with `REPOUSER` and `REPONAME`.
```
curl -i -u 'USERNAME:PASSWORD' https://api.github.com/repos/REPOUSER/REPONAME/hooks
```