README.md

friends-irc

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

Configuration

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": "irc.testbot.org",
    "channelMapping": {
      "#cats": "#bettercats"
    }
  },

  // Bot 2:
  {
    "nickname": "test",
    "server": "irc.bottest.org",
    "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).

Tests

Run the tests with:

$ npm test

Contributing

Contributions welcome! Please read the contributing guidelines first.

License

MIT