Slack/IRC Heroku Bridge

This project will allow you to deploy the aeirola/slack-irc-client project to Heroku to act as an IRC bouncer and as a bridge between IRC and Slack.

This means that a) Your IRC username will always be online, and b) any messages in the channels you join will be forwarded to Slack.

Setup

Create new Slack team at https://slack.com/create
- Don't invite anyone else to the team
Rename the #general Slack channel to the IRC channel you wish to join.
- Delete Slack channels that you don't want to join on IRC (like #random)
- Add any other IRC channels you want to join as new Slack channels

Edit your Slack user profile at https://slack.com/account/profile

Set the "What I do field" to JSON formatted string

For example, for Freenode, you will need the following:

{
  "server": "irc.freenode.net",
  "port": 6697,
  "userName": "NICKNAME",
  "nsPassword": "PASSWORD",
  "sasl": true,
  "nick": "NICKNAME",
  "password": "PASSWORD",
  "realName": "Your Real Name",
  "secure": true
}

You may also want to ignore some common IRC actions. Add this to the JSON configuration:

  "muteIrcEvents": ["join", ...]

Valid values for this field are as follows:

Value	Description
`join`	Mute JOIN messages in the channel
`kick`	Mute KICK messages in the channel
`kill`	Mute KILL messages in the channel
`motd`	Mute MOTD direct messages from slackbot on join
`names`	Mute membership list in the channel on join
`part`	Mute PART messages in the channel
`quit`	Mute QUIT messages in the channel
`topic`	Don't set the topic in the channel on join

Clone this repository:

$ git clone git@github.com:di/slack-irc-heroku-bridge.git

Create a new Heroku app:
```
$ heroku create <SOME APP NAME>
```
Scale down the web dyno:
```
$ heroku ps:scale web=0
```
Generate a test token for your newly created team at http://aeirola.github.io/slack-irc-client/
Set an environmental variable for the token you just created:
```
$ heroku config:set SLACK_API_TOKEN=<YOUR GENERATED TOKEN>
```
Push the app to heroku:
```
git push heroku master
```
Scale up a single worker dyno:
```
$ heroku ps:scale worker=1
```

You should start receiving messages from Slackbot and in the Slack channels you've created!

Debugging

To debug, take a look at heroku logs to see if there's any connection issues.

slack-irc-heroku-bridge

Commits

Add new mute values

Bump release

Bump release

Bump slack-irc-client to 0.3.1

Add muting config

Initial commit

README

Slack/IRC Heroku Bridge

Setup

Debugging