this is obsolete doc -- see http://doc.nethence.com/ instead

Irssi configuration 

 

Preamble 

Note. You can change the configuration file manually even while Irssi is running, 

/reload

Note. Either use GNU Screen or [Detach] (http://inglorion.net/software/detach/) to keep your IRC session alive. 

 

Basic configuration example 

Launch Irssi so you get the default configuration in place, then quit, 

cd ~/
irssi
/quit

 

Save the default configuration and proceed, 

cd .irssi/
cp config config.dist
vi config

 

Add your prefered IRC networks and server addresses at the top of the 'servers' section, 

  { address = "ircnet.club-internet.fr";
        chatnet = "IRCnet";
        autoconnect = "yes"; },
  { address = "kornbluth.freenode.net";
        chatnet = "Freenode";
        autoconnect = "yes"; },
  { address = "irc.online.net";
        chatnet = "Online";
        autoconnect = "no"; },

Note. old address for Dedibox was "irc.dedibox.fr". 

Note. Otherwise within Irssi, e.g., 

/server add -auto -network Freenode kornbluth.freenode.net
/save

 

Configure specific features on IRC networks in the ‘chatnets’ section, 

  Freenode = { type = "IRC";
        autosendcmd = "/msg nickserv identify PASSWORD_HERE; wait 2000"; };

Note. Otherwise within Irssi, e.g., 

/network add -autosendcmd "/msg nickserv identify PASSWORD_HERE; wait 2000" freenode
/save

 

Automatically join some channels with ‘channels’ e.g., 

  { name = "#netbsd"; chatnet = "IRCnet"; autojoin = "yes"; },
  { name = "#slackware"; chatnet = "IRCnet"; autojoin = "yes"; },

Note. Otherwise within Irssi, e.g., 

/channel add -auto ##sed Freenode
/save

 

Ready to go, 

cp config config.1
cd ../
irssi

 

Setup your real name, 

  core = {
    real_name = "Pierre-Philipp Braun (http://pbraun.nethence.com/)";
    user_name = "elge";
    nick = "elge";
  };

Note. Otherwise within Irssi, e.g., 

/set real_name FIRSTNAME NAME (HOME PAGE)
/save

Note. No quotes are necessary. 

 

Setup an alternate nickname (just below "fe-text" setting), 

  "irc/core" = { alternate_nick = "elge9"; };

Note. Otherwise within Irssi, e.g., 

/set alternate_nick ALTERNATE_NICKNAME
/save

 

Use an alternate completion character to name nicknames in the chat, use lowercase only and enable beeps, 

"fe-common/core" = { 

completion_char = ","; 

completion_nicks_lowercase = "yes"; 

bell_beeps = "yes"; 

}; 

Note. Otherwise within Irssi, e.g., 

/set completion_char ,
/set completion_nicks_lowercase on
/set bell_beeps on
/save

 

Usage 

To connect to a server that’s already registered in the configuration, e.g., 

/connect Online

or to connect to another server, 

/connect irc.server.address.or.ip

 

Clean up failing network connections, 

/rmreconns

 

Close a dead window, 

/window close

 

Optional 

Eventually deploy your preferred theme e.g. 'simpleii' here, 

cd ~/.irssi/
wget http://irssi.org/themefiles/simpleii.theme

and into irssi, 

/set theme simpleii

 

Eventually configure the ‘identd’ service on your server (listening on port 113, tcp or udp?). Or send a ‘return-rst’ on that port with the firewall. This removes the ‘~’ in front of your IRC user name. I mean the user name accompanied by your hostname, not the nickname.