Penguin
Note: You are viewing an old revision of this page. View the current version.

Irssi is a powerfull command line IRC client.

How to set up your IRC to auto reconnect every time you launch Irssi. For this example I will assume you want to connect to #wlug on UnderNet.

  1. Fire up irssi
  2. Irssi defines IRC networks as IRCNet's, so you need to add a IRCnet, the command to do this is "/IRCNET ADD yourircnet" so in this case "/IRCNET ADD unet"
  3. After this you need to set a server to connect to, the command to do this is "/SERVER ADD -auto -ircnet unet eu.undernet.org 6667" (sub your IRCnet and server names if not connecting to UnderNet)
  4. Now add your channel, "/CHANNEL ADD -auto #wlug unet"
  5. Now you want to save this, the command for this is "save" it will write a file "/.irssi/config" which I would not recommend editing by hand.
  6. If you have more than 1 channel and you want them to always appear in the same windows in Irssi every time you run the program then you will want to "/layout save"
  7. Exit Irssi and reopen it, it should auto connect to your server then join your channel(s)

This has now set up Irssi to auto connect to eu.undernet.org and join #wlug. If you want to connect to another IRC network then simpley add another IRCnet and server/channel connections.

Pretty much this whole page can be found by reading the Irssi FAQ located at www.irssi.org

Some more helpfull things

Queries

/SET autocreate_own_query ON
Should new query window be created when you send message to someone (with /msg).

/SET autocreate_query_level MSGS
New query window should be created when receiving messages with this level. MSGS, DCCMSGS and NOTICES levels work currently. You can disable this with /SET -clear autocrate_query_level.

/SET autoclose_query 0
Query windows can be automatically closed after certain time of inactivity. Queries with unread messages aren't closed and active window is neither never closed. The value is given in seconds.

Windows

/SET use_msgs_window OFF
Create messages window at startup. All private messages go to this window. This only makes sense if you've disabled automatic query windows. Message window can also be created manually with /WINDOW LEVEL MSGS, /WINDOW NAME (msgs).

/SET use_status_window ON
Create status window at startup. All messages that don't really have better place go here, like all /WHOIS replies etc. Status window can also be created manually with /WINDOW LEVEL ALL -MSGS, /WINDOW NAME (status).

/SET autocreate_windows ON
Should we create new windows for new window items or just place everything in one window

/SET autoclose_windows ON
Should window be automatically closed when the last item in them is removed (ie. /PART, /UNQUERY).

/SET reuse_unused_windows OFF
When finding where to place new window item (channel, query) Irssi first tries to use already existing empty windows. If this is set ON, new window will always be created for all window items. This setting is ignored if autoclose_windows is set ON.

/SET window_auto_change OFF
Should Irssi automatically change to automatically created windows - usually queries when someone sends you a message. To prevent accidentally sending text meant to some other channel/nick, Irssi clears the input buffer when changing the window. The text is still in scrollback buffer, you can get it back with pressing arrow up key.

/SET print_active_channel OFF
When you keep more than one channel in same window, Irssi prints the messages coming to active channel as "<nick> text" and other channels as "<nick:channel> text". If this setting is set ON, the messages to active channels are also printed in the latter way.

/SET window_history OFF
Should command history be kept separate for each window.

User information

/SET nick
Your nick name

/SET alternate_nick
Your alternate nick.

/SET user_name
Your username, if you have ident enabled this doesn't affect anything

/SET real_name
Your real name.

Server information

/SET skip_motd OFF
Should we hide server's MOTD (Message Of The Day).

/SET server_reconnect_time 300
Seconds to wait before connecting to same server again. Don't set this too low since it usually doesn't help at all - if the host is down, the few extra minutes of waiting won't hurt much.

/SET lag_max_before_disconnect 300
Maximum server lag in seconds before disconnecting and trying to reconnect. This happens mostly only when network breaks between you and IRC server.

Appearance

/SET timestamps ON
Show timestamps before each message.

/SET hide_text_style OFF
Hide all bolds, underlines, MIRC colors, etc.

/SET show_nickmode ON
Show the nick's mode before nick in channels, ie. ops have <@nick>, voices <+nick> and others < nick>

/SET show_nickmode_empty ON
If the nick doesn't have a mode, use one space. ie. ON: < nick>, OFF: <nick>

/SET show_quit_once OFF
Show quit message only once in some of the channel windows the nick was in instead of in all windows.

/SET lag_min_show 100
Show the server lag in status bar if it's bigger than this, the unit is 1/100 of seconds (ie. the default value of 100 = 1 second).

/SET indent 10
When lines are longer than screen width they have to be split to multiple lines. This specifies how much space to put at the beginning of the line before the text begins. This can be overridden in text formats with %| format.

/SET activity_hide_targets
If you don't want to see window activity in some certain channels or queries, list them here. For example "#boringchannel =bot1 =bot2". If any highlighted text or message for you appears in that window, this setting is ignored and the activity is shown.

Nick completion

/SET completion_auto OFF
Automatically complete the nick if line begins with start of nick and the completion character. Learn to use the tab-completion instead, it's a lot better ;)

/SET completion_char :
Completion character to use.

CategoryNotes