node package manager
It’s your turn. Help us improve JavaScript. Take the 2017 JavaScript Ecosystem Survey »



Build Status NPM version NGN Dependencies

nanoirc is a very simple console IRC client based on node-irc IRC library.

All the messages of the channels joined are displayed in the console. The user can choice the channel pressing tab: the list of the channels is displayed. Then the user can add the message and press enter to send it. The user may send another message to that channel without prefixing it again with the name of the channel: the message is sent to the last channel used.

The messages are displayed with time, channel and user info. If a message contains the nick of the user, it is displayed in red.


To install with npm:

npm install -g nanoirc

Tested with Node.js v7.x.


nanoirc reads a file in the HOME directory: .nanoirc.json.

The configuration file contains the server, the channels, the nickname info and the colors to use.

For instance,

    "server": "",
    "nick": "mynick",
    "password": "mypassword",
    "showJoinMessages": false,
    "showPartMessages": false,
    "channels": {
        "": [
        "": [
    "colors": {
        "timestamp": "yellow",
        "channel": "yellow",
        "user": "green",
        "mentions": "red"

Then you can start the client:


You can connect to a server other than the one in .nanoirc.json with:

nanoirc <servername>

For example, nanoirc will connect to and join all of the channels in the channels: { [...]} section of your .nanoirc.json


 project  : node-nanoirc
 repo age : 4 years, 2 months
 active   : 57 days
 commits  : 96
 files    : 12
 authors  :
    78  icebox                  81.2%
     7  Joe Haines              7.3%
     5  Alberto Santini         5.2%
     3  albertosantini          3.1%
     2  clux                    2.1%
     1  Eirik Albrigtsen        1.0%