Miau IRC Bouncer

From DD-WRT Wiki

Revision as of 07:28, 18 May 2007 by CoFRJacq (Talk | contribs)
Jump to: navigation, search

DD-WRT allows you to install the Miau IRC Bouncer, which enables you to keep your IRC nickname and channels open while the client pc is disconnected from the server.


Contents

Prerequesites

DD-WRT Installed

ipkg up to date

jffs enabled


Installation

The current ipkg update doesn't seem to include miau although it is listed as being a supported package. The current version of miau in .ipk form is on sourceforge, so you'll need to download it to the router to install it. At an ssh prompt, change directory to /jffs and type:

wget http://downloads.sourceforge.net/miau/miau_0.6.3-1_mipsel_ipv4.ipk?modtime=1169077591&big_mirror=0

Once it's downloaded, type:

ipkg -d root install miau_0.6.3-1_mipsel_ipv4.ipk


Note: miau supports ipv6 but you need to change the 4 to a 6 in the above link to get the version with that feature compiled in

Configuration

Miau holds its settings in a config file called miaurc, which has a lot of options you can set, these are all explained here. This is an example of a working config file, set to connect to efnet with the nickname mynick, accepting connections from any ip address. It is set to join #testchannel when it connects to the server, and to attempt to rejoin those channels whenever it re-connects.

nicknames = { 
    "mynick" 
}
realname = "none"
username = "user" 
password = "password" 
listenport = "44123" 
servers = { 
    "irc.efnet.org":"6667" 
}
connhosts = { 
    "*.*.*.*" 
}
channels = { 
    "#testchannel" 
}
rejoin = "true" 


Usage

You can run the bouncer by typing miau at the command prompt. It seems to look in /tmp/root/.miau for its files by default, I'm not sure if you can change the default location. To use the config file you created, type:

miau -d <the folder where you put your miaurc file>

miau should start and connect to the server, listening on the port you specified in miaurc. To connect to the bouncer, in your favourite irc client, type:

/server <the ip of your router>:<listening port> <your set password here>

Make sure that your ident is set to the same value as the username you set in miaurc or miau will reject the connection.

If you're connecting to the bouncer externally, it's probably a good idea to set the listenhost variable in miaurc to localhost, and tunnel the connection via SSH (how to do this in linux and in windows using PuTTY).

For ways to get miau to run when the router starts up, look here