Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 10 additions & 10 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
# Slack IRC Plugin

IRC integration with [slack](http://slack.com).
Bidirectional IRC integration with [slack](http://slack.com), with simple functionality like avoiding higlighting yourself on IRC, etc.

## Usage

```javascript
git clone https://github.com/jimmyhillis/slack-irc-plugin.git
git clone https://github.com/jaykul/slack-irc-plugin.git
cd slack-irc-plugin
npm install
```
Expand All @@ -15,11 +15,9 @@ Write your own configuration file (`config-example.js`) is a good starting point
```javascript
var config = {
// required
server: 'irc.freenode.com',
port: 6667,
secure: false,
password: '(optional)',
server: 'irc.freenode.net',
nick: 'slackbot',
password: '(optional)',
username: 'slackbot-username',
token: 'XXXX-XXXXXXXXXX-XXXXXXXXXX-XXXXXXXXXX-XXXXXX',
channels: {
Expand All @@ -28,9 +26,6 @@ var config = {
users: {
'~irclogin': 'slackuser'
},
// optionals
silent: false // default
// node-irc options
floodProtection: true
}
```
Expand All @@ -49,5 +44,10 @@ This will launch the bot in your terminal based on provided configuration.
- `token`: Your Slack API token, get your token at https://api.slack.com/
- `channels`: Map of IRC channel to Slack channel names, with optional password
- `users`: Map of IRC nick to Slack username
- `silent`: Set to true to stop IRC bot from speaking into the channel
- `highlight:` Set to true to turn off unicode zero-width character insertion in nicks for IRC
- `slackmark:` Any text value will be appended to usernames from IRC when sent to slack

Note that additionally, some nodejs irc settings are allowed:

`floodProtection`, `port`, `debug`, `showErrors`, `autoRejoin`, `autoConnect`, `secure`, `selfSigned`, `certExpired`, `floodProtection`, `floodProtectionDelay`, `sasl`, `stripColors`, `channelPrefixes`, `messageSplit`, `password`

5 changes: 3 additions & 2 deletions config-example.js
Original file line number Diff line number Diff line change
@@ -1,12 +1,13 @@
var slackbot = require('./lib/bot');

var config = {
server: 'irc.freenode.com',
server: 'irc.freenode.net',
nick: 'slackbot',
username: 'slackbot-username',
token: 'XXXX-XXXXXXXXXX-XXXXXXXXXX-XXXXXXXXXX-XXXXXX',
// use all lowercase. use # on IRC channel, but not on slack channel
channels: {
'#irc-channel password(optional)': '#slack-channel'
'#irc-channel password(optional)': 'slack-channel'
},
users: {
'~irclogin': 'slackuser'
Expand Down
Loading