1
0
mirror of https://github.com/irssi/irssi.git synced 2024-12-04 14:46:39 -05:00
irssi/README
Timo Sirainen d29ca0b107 rest of the ~rewrite?
git-svn-id: http://svn.irssi.org/repos/irssi/trunk@172 dbcabf3a-b0e7-0310-adc4-f8d773084564
2000-04-26 08:10:09 +00:00

107 lines
3.8 KiB
Plaintext

irssi
* ABOUT
Irssi is an IRC client made with GTK+ toolkit and (optional) GNOME
libraries. A small text mode version is also somewhat working, there's
also a really simple daemon version which just loads "bot" plugin. I'd
also like to see KDE version.
* FEATURES
See docs/COMMANDS file for list of (almost) all commands irssi knows.
See docs/PERL for some documentation of Perl scripting.
I've been asked quite a lot about why should one use irssi, what does it do
that other IRC clients don't? Well, to tell you the truth, I have no idea :)
Still I've got a lot of mails saying it's the best GUI IRC client they've
ever used :) Let's see.. It should be easy to use, it has most of the
features IRC client needs and it's pretty stable. Here's a small list of what
it does:
- Nice configuration :) Especially the color settings.
- You can connect to multiple servers. Irssi is also IRC network aware so
you can specify some settings to work only in specified IRC networks.
- Automatically connect to IRC server(s) at startup, automatically join to
channels when connected.
- All code is nonblocking, it won't hang while connecting to server or
opening DCC connection. Host lookups are done in separate processes.
- DCC send, receive and chat with GUI
- GNOME panel support, channels and queries are displayed in GNOME panel
where you can easily see which channels have been updated (label turns to
red) and click in them to open the channel.
- Doubleclicking URL in text widget launches specified web/ftp/email client,
also doubleclicking channel/nick join to channel or creates query.
- Aliases, ignores, autoignoring when flooding, notify lists, completing
specified words with tab (like home<tab> -> http://my.home.page),
hilighting lines with specified texts
- Smart nick completion
- Configurable logging support
- Plugins support, creating plugins is really easy.
- Extremely flexible Perl scripting support.
- Lots of nice GUI stuff :)
* PROXY PLUGIN
Usage:
Start irssi-text in screen,
connect to some irc server
/load proxy <password> [ip address to listen [port to listen]]
Finished, default port to listen in is 2777 and default ip is the ip
where your irc server is connected. Now just connect your clients to
the proxy. There's not much features yet, if you want to use multiple
servers you'll need to start multiple irssi-texts now..
* INSTALLATION
./configure
make
make install
Configure can use these parameters (all of these defaults to yes):
--with-servertest Build test irc server which you can use to try crash
irc clients
--with-socks Build with socks library
--with-mysql=dir Build with mysql plugin
--without-gtk Build without GTK frontend
--without-textui Build without text frontend
--without-bot Build without irssibot
--without-gnome Build without GNOME libraries
--without-gnome-panel Build without GNOME panel
--without-imlib Build without Imlib library (you can use only .xpm
files as backgrounds)
--enable-memdebug Enable memory debugging, great for finding memory
leaks
--enable-gtk-hebrew Enable Hebrew support - see README-HEBREW
--disable-perl Disable Perl support
There's also some others, you can get a full list with ./configure --help
* COMMAND LINE PARAMETERS
--no-applet Don't start gnome panel applet
--connect -c <server> Connect to server at startup
--port -p <port> - specify port
--noconnect -! Don't autoconnect to any servers at startup
--nick -n Specify what nick to use
--hostname -h Specify what host name to use
* BUGS / SUGGESTIONS
See TODO file if it is already listed in there - if not send me email..
* AUTHOR
Timo Sirainen, tss@iki.fi, cras/ircnet/#irssi, http://xlife.dhs.org/irssi/