ShroudBNC HOWTO

About shroudBNC

shroudBNC is a BNC like psyBNC and ZNC, which keeps you connected even when you disconnect from your IRC client. It works with some scripts like TCL and is easy to configure. shroud BNC will use one of your alloted ports.

Getting shroudBNC

Here are some simple steps to configure it.

In your shell, type:

$ wget http://mirror.shroudbnc.info/sbnc-1.2.tar.gz
$ tar -xzf sbnc-1.2.tar.gz
$ rm -f sbnc-1.2.tar.gz

Now is time to compile the source. Here at GSH, you need to request GCC access to do this.

Type:

$ cd sbnc-1.2
$ ./configure
$ make
$ make install

If no errors occur, type:

$ cd ../sbnc

You can optionally remove the source folder, because you won't need it any more.

Configuring shroudBNC

You can now run sBNC:

$ ./sbnc
shroudBNC (loader: 1.2 $Revision: 1080 $) - an object-oriented IRC bouncer
Fri Jul 11 10:31:24 2008: Log system initialized. No valid configuration file has been found. A basic configuration file can be created for you automatically. Please answer the following questions:

In the first step, you will set the sBNC port, which you can get from myports.

1. Which port should the bouncer listen on (valid ports are in the range 1025 - 65535): 63600

In the second step, you will set your username (e.g. thisguy in thewookie!thisguy@us.gshellz.org).

2. What should the first user's name be? thisguy

In the third step, you will set your password, and in the fourth step, you will confirm your password.

3. Please enter a password for the first user: <type your password>
4. Please confirm your password by typing it again: <retype your password>

Writing main configuration file... DONE
Writing first user's configuration file... DONE
Configuration has been successfully saved. Please restart shroudBNC now.

Now restart ShroudBNC using the following command so it will not spawn more than one process:

./sbnc --lpc

Now with your IRC client, connect to us.gshellz.org or eu.gshellz.org at the port that you set. When sBNC asks you for the password, you need to type:

/quote pass yourpass

The password is the same that you set in the step 3 and 4.

Now is time to configure your sBNC... To set a vhost, use the below syntax:

/sbnc set vhost my.milkshake.brings.boys.to.gshellz.org

To set your realname:

/sbnc set realname Zhi

To set your user modes type as an example

/sbnc set automodes +i

Now you can set the IRC server that sBNC will connect to. To do this, use this syntax:

/sbnc set server chat.freenode.net

sBNC will then try to connect to the server:

<-sBNC> Trying to reconnect to irc.freenode.net:8000 for user thewookie
<-sBNC> Connection initialized for user thewookie. Waiting for response...
<-sBNC> You were successfully connected to an IRC server.
<-sBNC> User thewookie connected to an IRC server.

For help, use /sbnc help.

Services authentication

For Freenode, type:

/sbnc nickserv set reply ns
/sbnc nickserv set password yourpassword
/sbnc nickserv set warning This nickname is registered and protected. If it is your

If you want to set delay join and other such things, /sbnc nickserv help will give you all you need to know.