Miau IRC Bouncer

From DD-WRT Wiki

(Difference between revisions)
Jump to: navigation, search
Revision as of 01:56, 15 February 2007 (edit)
Whiteboy (Talk | contribs)

← Previous diff
Revision as of 13:58, 14 March 2007 (edit) (undo)
Jts (Talk | contribs)

Next diff →
Line 1: Line 1:
DD-WRT allows you to install the [http://miau.sourceforge.net Miau IRC Bouncer], which enables you to keep your IRC nickname and channels open while the client pc is disconnected from the server. DD-WRT allows you to install the [http://miau.sourceforge.net Miau IRC Bouncer], which enables you to keep your IRC nickname and channels open while the client pc is disconnected from the server.
-A detailed installation guide for installing the OpenWRT Miau ipkg can be found at http://www.linksysinfo.org/portal/forums/showthread.php?t=36018+ 
 +== 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 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 [http://miau.sourceforge.net/manual.html#SEC7 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 [http://www.revsys.com/writings/quicktips/ssh-tunnel.html linux] and in [http://www.gb.nrao.edu/pubcomputing/tunnel-howto.shtml windows using PuTTY]).
 + 
 + 
 + 
[[Category:English documentation]] [[Category:English documentation]]
[[Category:Basic tutorials]] [[Category:Basic tutorials]]

Revision as of 13:58, 14 March 2007

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 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).