irssi module for connecting to RobustIRC
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
src
.clang-format
.gitignore
CMakeLists.txt
COPYING
README.md

README.md

This is an irssi plugin which allows you to connect to a RobustIRC network without using a bridge.

The plugin is very new, hence there will likely be bugs. Please report them so that we get a chance to fix them.

Installing

On Debian testing, use:

sudo apt-get install irssi-plugin-robustirc

Building from source

To build:

git clone https://github.com/robustirc/irssi-robustirc.git
mkdir irssi-robustirc/build
cd irssi-robustirc/build
cmake .. && make
sudo make install

If you need to specify a custom path to the irssi sources, specify IRSSI_PATH:

cmake -DIRSSI_PATH:PATH=$HOME/irssi ..

To build with https://code.google.com/p/address-sanitizer/wiki/AddressSanitizer enabled:

cmake -DCMAKE_BUILD_TYPE:String="asan" ..

to use asan, run irssi 2>/tmp/asan.log. When memory errors are found, irssi will terminate and you can examine /tmp/asan.log

Using

If you just want to load the module and connect as quickly as possible, here is how you do it:

/load robustirc
/connect -robustirc robustirc.net

Persistent setup

To load the RobustIRC plugin automatically when starting irssi, use:

echo 'LOAD robustirc' >> ~/.irssi/startup

Converting an existing network

In case you were previously connecting to legacy-irc.robustirc.net, or to a bridge, open up ~/.irssi/config in an editor, find the corresponding network entry in the chatnets section and add:

type = "robustirc";

Then, find the corresponding server entry in the servers section and replace the address line with the address of the RobustIRC network, e.g.:

address = "robustirc.net";

Configuring a new network

Edit ~/.irssi/config and add a new network to the chatnets section:

<network> = { type = "robustirc"; };

Then, add a server to the servers section:

  {
    address = "robustirc.net";
    chatnet = "<network>";
    autoconnect = "yes";
  }

Here’s a full example:

chatnets = {
  robustirc = { type = "robustirc"; };
};

servers = (
  {
    address = "robustirc.net";
    chatnet = "robustirc";
    autoconnect = "yes";
  }
);