Miau IRC Bouncer

From DD-WRT Wiki

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.


[edit] Prerequesites

DD-WRT Installed

ipkg up to date

JFFS enabled: CLI or Web Interface - if the web interface does not appear to work, use the CLI

[edit] 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.5-1_mipsel_ipv4.ipk?modtime=1193170098&big_mirror=0

It will say "Connecting to downloads.sourceforge.net (". Press enter again and the file should finish downloading. Once that is done, run


If it put an extension on the file you downloaded, then you will need to run

mv miau_0.6.5-1_mipsel_ipv4.ipk?modtime\=1193170098 miau_0.6.5-1_mipsel_ipv4.ipk

After that, type:

ipkg -d root install miau_0.6.5-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

[edit] 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 = { 
realname = "none"
username = "user" 
password = "password" 
listenport = "44123" 
servers = { 
connhosts = { 
channels = { 
rejoin = "true" 

First, telnet in, and do

mkdir .miau
cd .miau

Then type

vi miaurc

Fill out the sample config listed above in a text editor on your computer, and when you are finished, right click in the SSH window and select "Paste". Note that the password variable is the password for the router's IRC bouncer, not for your IRC username. You do not set your IRC password in this config file.

Check to make sure it pasted correctly, then press Escape and do

:w! <press enter>

then do

:q <press enter>

[edit] 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; in the telnet, you created the config file here. Simply type


and it should start.

If you made a config file in a different location, run

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

For example, if you put it in /jffs/usr/bin, then run

miau -d /jffs/usr/bin

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