CGI:IRC 0.3.4 -- http://cgiirc.sourceforge.net/ ----- Installation Quick install (replace /home/httpd/cgi-bin/ with the path to your cgi-bin directory) and run these commands in a shell cp form.cgi irc.cgi nph-irc.cgi userlist.cgi config ipaccess /home/httpd/cgi-bin/ cd /home/httpd/cgi-bin/ chmod 755 form.cgi irc.cgi nph-irc.cgi userlist.cgi chmod 644 config ipaccess You will also need to copy the images to a part of your webserver where they can be read. The default set-up may work on some servers but most cgi-bin directories that are set-up properly don't allow static content to be read. So place the images in a directory on your webserver and then add that (the path as seen by the outside world) to the config in the imagepath directive. This command will copy them into the /home/httpd/html/images directory: cp -r images /home/httpd/html If you don't have shell access to your web host then copy all three scripts and the 'config' and 'ipaccess' files into your cgi-bin directory (using ftp or scp) . Make sure that the scripts are executable and readable by the user that runs the webserver and that the line at the top of the file points correctly to where your perl 5 binary is installed. You will probally also want to have a good look in the config section where you can add access controls, and change lots of settings. You may also want to take a look at the styles section where you can change the colours of the output and add themes. If you wish to put the clean-up code in cron instead of being run each time CGI:IRC starts then remove the autocleanup variable from the config file and use the rm-stale.pl script instead. ------ The Identd server This requires root access to your hosting machine but it makes the script much nicer to use, instead of nobody@yourhost it's either the users encoded IP address or the nickname. To install it edit the /etc/inetd.conf file and add this line, (you will have to adjust the path of where you have put the file, i recommend /usr/local/sbin/identd.pl) ident stream tcp nowait nobody /usr/local/irc/identd.pl (it may begin with auth, depends on your system, see /etc/services on your system and look for either auth or ident and use the one you find). This has not been tested very well so if you have any problems feel free to email me. ------ Usage Go to http://yourhost.com/cgi-bin/irc.cgi (or wherever the irc.cgi script is installed. Fill out the form with suitable values and click Login, you may join multiple channels by seperating them with spaces. If you want to find out the real ip of a user (so you can ban them from your service or whatever), do /ctcp nick USERINFO, which will give you the ip address and web browser they are using, or if you have the encoded_ips enabled yse the decode.pl script along with the start of the whois output (minus the square brackets) There is more information on using CGI:IRC in the docs.html file in the tarball as well as a basic template for writing your own html file to launch irc.cgi in launch.html ------ Copyright and License Copyright David Leadbeater 2000 (cgiirc@dgl.cx) CGI:IRC comes with ABSOLUTELY NO WARRANTY Please leave the link on /quit so I have some credit for my work, thanks. This is free software, and you are welcome to redistribute it under certain conditions; see the GNU General Public Licence v2 in the file COPYING for details.