💬 Bot that synchronises messages from gitter and irc
Latest commit cdfcca3 Mar 29, 2016 @finnp Merge pull request #27 from jleclanche/patch-1
Update readme.md with authentication/SASL instructions
Failed to load latest commit information.
.gitignore testenv Jul 2, 2015
app.json add documentation for admin feature Dec 28, 2015
bin.js irc admin log Dec 23, 2015
gitter.js test faye client Dec 27, 2015
index.js standard format Feb 13, 2016
package.json 1.5.1 Dec 29, 2015
readme.md Update readme.md Mar 29, 2016




Bot that synchronises messages from a gitter room and an irc channel.

Install with npm install gitter-irc-bot.

If you want to test this bot, go to the gitter channel and join #gitterircbot on Freenode.

How to use

You need to set the following env variables

  • GITTERBOT_APIKEY Log in with your github/gitter bot here and take the personal access token. Important: This shouldn't be your personal GitHub account, but a designated bot account.
  • GITTERBOT_GITTER_ROOM The Gitter Room, e.g. datproject/discussions
  • GITTERBOT_IRC_CHANNEL IRC Channel name, e.g. #dat
  • GITTERBOT_IRC_NICK The IRC user nick of the bot

The following options are optional:

  • GITTERBOT_IRC_SERVER IRC Server name, e.g. irc.freenode.net
  • GITTERBOT_IRC_OPTS JSON string with options passed to node-irc
  • GITTERBOT_IRC_ADMIN If specified this person receives error logs via pm.

Then start the bot with npm start, or if you install globally run gitter-irc-bot.


To authenticate to the IRC server, you will need to supply password in GITTERBOT_IRC_OPTS. For example: GITTERBOT_IRC_OPTS='{"password": "hunter2"}'.

Using SASL is recommended if the IRC server supports it. You can enable it by supplying "sasl": true and the appropriate userName. Example: GITTERBOT_IRC_OPTS='{"userName": "gitter-example", "password": "hunter2", "sasl": true}'

Deploy on heroku

When deploying to heroku you need to set HEROKU_URL to the url of your heroku app. Otherwise heroku will spin down your free heroku instance after a few minutes.