wapircgw - multiuser wapirc gateway daemon for linux, with multi-channel and query support
DOWNLOAD: wapircgw-0.1.7.tar.gz
Previous versions:
wapircgw-0.1.6.tar.gz
wapircgw-0.1.5.tar.gz
wapircgw-0.1.4.tar.gz
Please send comments, found bugs or patches to nonoo aaaat nonoo doot hu
WHAT'S THIS?
With this software you can easily connect to irc networks using your wap browser on your mobile phone. You just need a Linux box with internet connection to act as a gateway between your mobile phone and the irc network. You can join to multiple channels and talk to others privately like when you use a real irc client.
wapircgw consists of 2 cooperative pieces: wapircphp and wapircd
wapircd is the daemon which handles connections to irc networks and requests from your mobile phone. wapircphp generates wml webpages that you can view with your mobile phone. So you'll need a web-server application with PHP and MySQL support (ex. Apache). MySQL support is needed because of the user administration and settings storage.
Example: when a user logs in with his/her mobile phone, wapircphp communicates with wapircd, requesting a new irc connection to be made. So wapircd connects to the given irc server and joins the channels which the user gave in his/her settings. When the user logs out (or does nothing for a few minutes), wapircd closes the connection with the irc server.
INSTALLATION
Don't forget to edit wapircd password in wapircd/src/config.h!
Then run ./configure and then make. PLEASE REMEMBER: you don't have to be root to run wapircd. It's more secure to run it as a single user. You'll find the wapircd binary in the src dir after running make, but if you're lazy you can run make install as root and it'll place the binary in /usr/local/bin. Run wapircd -h for further options. You don't have to have write access in the directory you start wapircd, because everything is stored in memory.
After starting wapircd, copy the contents of the wapircphp directory to your website. Add the following table to your MySQL database:
CREATE TABLE `wapirc` (
`user` varchar(20) default NULL,
`pass` varchar(20) default NULL,
`ircserver` varchar(50) default NULL,
`ircport` varchar(5) default '6667',
`ircuser` varchar(50) NOT NULL default 'wapirc',
`ircnick` varchar(50) default NULL,
`ircpass` varchar(20) default NULL,
`autojoin` varchar(255) default NULL,
`loglines` tinyint(3) unsigned NOT NULL default '20',
`loglineslong` tinyint(3) unsigned NOT NULL default '100',
`allowrawirccmds` tinyint(1) NOT NULL default '0'
) ENGINE=MyISAM DEFAULT CHARSET=latin1;
You can download this definition here.
Add your users into this table so they can use the service.
Edit config.inc.php and set your MySQL host, pass and database and your wapircd host, port and password what you have set in wapircd/src/config.h.
Now you're done, fire up your wap browser on your mobile phone and log in. Enjoy irc! ;)
Freshmeat: http://freshmeat.net/projects/wapircgw/
Sourceforge: http://www.sourceforge.net/projects/wapircgw