Docs For Latest release version: 1.2.0
Startup How-To
Copyright (c) 2000-2002 by Timo Sirainen, release under GNU FDL 1.1 license.
Index with some FAQ questions that are answered in the chapter:
  1. First Steps
  2. Basic user interface usage
    • Split windows work in weird way
    • How can I easily switch between windows?
    • But alt-1 etc. don’t work!
  3. Server and channel automation
    • How do I automatically connect to servers at startup?
    • How do I automatically join to channels at startup?
    • How do I automatically send commands to server at connect?
  4. Setting up windows and automatically restoring them at startup
  5. Status and msgs windows & message levels
    • I want /WHOIS to print reply to current window
    • I want all messages to go to one window, not create new windows
  6. How support for multiple servers works in irssi
    • I connected to some server that doesn’t respond and now irssi keeps trying to reconnect to it again and again, how can I stop it??
    • I want to have own status and/or msgs window for each servers
  7. /LASTLOG and jumping around in scrollback
    • How can I save all texts in a window to file?
  8. Logging
  9. Changing keyboard bindings
    • How do I make F1 key do something?
  10. Proxies and IRC bouncers
  11. Irssi’s settings
    • For all the ircII people
  12. Statusbar
    • I loaded a statusbar script but it’s not visible anywhere!
Documentation
  • Frequently Asked Questions
  • Startup How-To
  • Check the built-in /HELP
  • Settings
  • Design
  • Manual, a bit dated and unfinished
  • Contributing
Miscellaneous
  • Tips & Tricks
  • Irssi Proxy, the mini-bnc module
  • Colour Formats
  • Special Variables
  • Irssi 0.8.17 Tips
Tutorials
  • General guide to Irssi and GNU screen
  • Split windows handling
  • Split windows handling Addendum
  • Showing events in different windows
  • Connecting to networks with SASL
Scripting
  • Scripting Tutorial, by Juerd
  • Perl Scripting Reference
  • Signals
  • (Unofficial) Irssi Scripting and Documentation Wiki
1. First steps
IRC Networks are made of servers, and servers have channels. The default config has a few predefined networks, to list them:
/NETWORK LIST
And to connect to one of those networks and join a channel:
/CONNECT Freenode
/JOIN #irssi
To add more networks:
/NETWORK ADD ExampleNet
Then add some servers (with -auto to automatically connect):
/SERVER ADD -auto -network ExampleNet irc.example.net
Automatically join to channels after connected to server:
/CHANNEL ADD -auto #lounge ExampleNet
To modify existing networks (or servers, or channels) just ADD again using the same name as before. This configures a network to identify with nickserv and wait for 2 seconds before joining channels:
/NETWORK ADD -autosendcmd "/^msg nickserv ident pass;wait 2000" ExampleNet
If you have irssi 0.8.18 or higher and the irc network supports it, you can use SASL instead of nickserv, which is more reliable:
/NETWORK ADD -sasl_username yourname -sasl_password yourpassword -sasl_mechanism P