node package manager
Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »



npm travis

Connects IRC and Friends channels by sending messages back and forth. Based on slack-irc.

Installation and usage

Use the newest version of io.js and npm (>= 1.8.1, >= 2.8.3) and follow the prerequisite steps for node-webrtc before continuing.

Install either through npm:

$ npm install -g friends-irc
$ friends-irc --config /path/to/config.json

or by cloning the repository:

In the repository folder:
$ npm install
$ node index.js --config /path/to/config.json


friends-irc requires a JSON-configuration file, where path can be given either through the CLI-option --config or the environment variable CONFIG_FILE. The configuration file needs to be an object or an array, depending on the number of IRC bots you want to run.

To set the log level to debug, export the environment variable NODE_ENV as development.

friends-irc also supports invite-only IRC channels, and will join any channels it's invited to as long as they're present in the channel mapping.

Example configuration

  // Bot 1 (minimum config): 
    "nickname": "test2",
    "server": "",
    "channelMapping": {
      "#cats": "#bettercats"
  // Bot 2: 
    "nickname": "test",
    "server": "",
    "autoSendCommands": [ // Commands that will be sent on connect 
      ["PRIVMSG", "NickServ", "IDENTIFY password"],
      ["MODE", "test", "+x"],
      ["AUTH", "test", "password"]
    "channelMapping": { // Maps each Swarm-channel to an IRC-channel, used to direct messages to the correct place 
      "friends": "#friends",
      "cats": "#fatcats channel-password" // Add channel keys after the channel name 
    "ircOptions": { // Optional node-irc options 
      "floodProtection": false, // On by default 
      "floodProtectionDelay": 1000 // 500 by default 

ircOptions is passed directly to node-irc (available options).


Run the tests with:

$ npm test


Contributions welcome! Please read the contributing guidelines first.