summaryrefslogtreecommitdiffstats
path: root/docs/startup-HOWTO.txt
blob: 90d278de6bfc4976135a5dd494d99c1799ce4147 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
Startup How-To

To new Irssi users (not to new IRC users ..)

Copyright (c) 2000-2002 by Timo Sirainen, release under [1]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!

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 liberachat
/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 PLAIN liberachat

These commands have many more options, see their help for details:

/HELP NETWORK
/HELP SERVER
/HELP CHANNEL
/HELP

If you want lines containing your nick to hilight:

/HILIGHT nick

Or, for irssi 0.8.18 or higher:

/SET hilight_nick_matches_everywhere ON

To get beeps on private messages or highlights:

/SET beep_msg_level MSGS HILIGHT DCCMSGS

No other irssi settings are needed (don’t enable bell_beeps), but there may be
settings to change in your terminal multiplexer (screen/tmux), your terminal,
or your desktop environment.

2. Basic user interface usage

Windows can be scrolled up/down with PgUp and PgDown keys. If they don’t work
for you, use Meta-p and Meta-n keys. For jumping to beginning or end of the
buffer, use /SB HOME and /SB END commands.

By default, irssi uses “hidden windows” for everything. Hidden windows are
created every time you /JOIN a channel or /QUERY someone. There’s several ways
you can change between these windows:

Meta-1, Meta-2, .. Meta-0 - Jump directly between windows 1-10
Meta-q .. Meta-o          - Jump directly between windows 11-19
/WINDOW <number>          - Jump to any window with specified number
Ctrl-P, Ctrl-N            - Jump to previous / next window

Clearly the easiest way is to use Meta-number keys. Meta usually means the ALT
key, but if that doesn’t work, you can use ESC.

Mac OS X users with ALT key issues might prefer using [2]iTerm2 instead of the
default terminal emulator.

Alt key as meta, for xterm/rxvt users

If you use xterm or rxvt, you may need to set a few X resources:

 XTerm*eightBitInput:   false
 XTerm*metaSendsEscape: true

With rxvt, you can also specify which key acts as Meta key. So if you want to
use ALT instead of Windows key for it, use:

 rxvt*modifier: alt

You could do this by changing the X key mappings:

 xmodmap -e "keysym Alt_L = Meta_L Alt_L"

And how exactly do you set these X resources? For Debian, there’s /etc/X11/
Xresources/xterm file where you can put them and it’s read automatically when X
starts. ~/.Xresources and ~/.Xdefaults files might also work. If you can’t get
anything else to work, just copy and paste those lines to ~/.Xresources and
directly call xrdb -merge ~/.Xresources in some xterm. The resources affect
only the new xterms you start, not existing ones.

Split windows and window items

Note: [3]this guide might be a better introduction to window splits

Irssi also supports split windows, they’ve had some problems in past but I
think they should work pretty well now :) Here’s some commands related to them:

/WINDOW NEW                    - Create new split window
/WINDOW NEW HIDE               - Create new hidden window
/WINDOW CLOSE                  - Close split or hidden window

/WINDOW HIDE [<number>|<name>] - Make the split window hidden window
/WINDOW SHOW <number>|<name>   - Make the hidden window a split window

/WINDOW SHRINK [<lines>]       - Shrink the split window
/WINDOW GROW [<lines>]         - Grow the split window
/WINDOW BALANCE                - Balance the sizes of all split windows

By default, irssi uses “sticky windowing” for split windows. This means that
windows created inside one split window cannot be moved to another split window
without some effort. For example you could have following window layout:

 Split window 1: win#1 - Status window, win#2 - Messages window
 Split window 2: win#3 - IRCnet/#channel1, win#4 - IRCnet/#channel2
 Split window 3: win#5 - efnet/#channel1, win#6 - efnet/#channel2

When you are in win#1 and press ALT-6, irssi jumps to split window #3 and moves
the efnet/#channel2 the active window.

With non-sticky windowing the windows don’t have any relationship with split
windows, pressing ALT-6 in win#1 moves win#6 to split window 1 and sets it
active, except if win#6 was already visible in some other split window irssi
just changes to that split window. This it the way windows work with ircii, if
you prefer it you can set it with

/SET autostick_split_windows OFF

Each window can have multiple channels, queries and other “window items” inside
them. If you don’t like windows at all, you disable automatic creating of them
with

/SET autocreate_windows OFF

And if you keep all channels in one window, you most probably want the channel
name printed in each line:

/SET print_active_channel ON

If you want to group only some channels or queries in one window, use

/JOIN -window #channel
/QUERY -window nick

3. Server and channel automation

Irssi’s multiple IRC network support is IMHO very good - at least compared to
other clients :) Even if you’re only in one IRC network you should group all
your servers to be in the same IRC network as this helps with reconnecting if
your primary server breaks and is probably useful in some other ways too :) For
information how to actually use irssi correctly with multiple servers see the
chapter 6.

First you need to have your IRC network set, use /NETWORK command to see if
it’s already there. If it isn’t, use /NETWORK ADD yournetwork. If you want to
execute some commands automatically when you’re connected to some network, use
-autosendcmd option. Here’s some examples:

/NETWORK ADD -autosendcmd '^msg bot invite' IRCnet
/NETWORK ADD -autosendcmd "/^msg nickserv ident pass;wait 2000" OFTC

After that you need to add your servers. For example:

/SERVER ADD -auto -network IRCnet irc.kpnqwest.fi 6667
/SERVER ADD -auto -network worknet irc.mycompany.com 6667 password

The -auto option specifies that this server is automatically connected at
startup. You don’t need to make more than one server with -auto option to one
IRC network, other servers are automatically connected in same network if the
-auto server fails.

And finally channels:

/CHANNEL ADD -auto -bots *!*bot@host.org -botcmd "/^msg $0 op pass" #irssi efnet
/CHANNEL ADD -auto #secret IRCnet password

-bots and -botcmd should be the only ones needing a bit of explaining. They’re
used to send commands automatically to bot when channel is joined, usually to
get ops automatically. You can specify multiple bot masks with -bots option
separated with spaces (and remember to quote the string then). The $0 in
-botcmd specifies the first found bot in the list. If you don’t need the bot
masks (ie. the bot is always with the same nick, like chanserv) you can give
only the -botcmd option and the command is always sent.

4. Setting up windows and automatically restoring them at startup

First connect to all the servers, join the channels and create the queries you
want. If you want to move the windows or channels around use commands:

/WINDOW MOVE LEFT/RIGHT/number    - move window elsewhere
/WINDOW ITEM MOVE <number>|<name> - move channel/query to another window

When everything looks the way you like, use /LAYOUT SAVE command (and /SAVE, if
you don’t have autosaving enabled) and when you start irssi next time, irssi
remembers the positions of the channels, queries and everything. This
“remembering” doesn’t mean that simply using /LAYOUT SAVE would automatically
make irssi reconnect to all servers and join all channels, you’ll need the /
SERVER ADD -auto and /CHANNEL ADD -auto commands to do that.

If you want to change the layout, you just rearrange the layout like you want
it and use /LAYOUT SAVE again. If you want to remove the layout for some
reason, use /LAYOUT RESET.

5. Status and msgs windows & message levels

By default, all the “extra messages” go to status window. This means pretty
much all messages that don’t clearly belong to some channel or query. Some
people like it, some don’t. If you want to remove it, use

/SET use_status_window OFF

This doesn’t have any effect until you restart irssi. If you want to remove it
immediately, just /WINDOW CLOSE it.

Another common window is “messages window”, where all private messages go. By
default it’s disabled and query windows are created instead. To make all
private messages go to msgs window, say:

/SET use_msgs_window ON
/SET autocreate_query_level DCCMSGS  (or if you don't want queries to
                                      dcc chats either, say NONE)

use_msgs_window either doesn’t have any effect until restarting irssi. To
create it immediately say:

/WINDOW NEW HIDE     - create the window
/WINDOW NAME (msgs)  - name it to "(msgs)"
/WINDOW LEVEL MSGS   - make all private messages go to this window
/WINDOW MOVE 1       - move it to first window

Note that neither use_msgs_window nor use_status_window have any effect at all
if /LAYOUT SAVE has been used.

This brings us to message levels.. What are they? All messages that irssi
prints have one or more “message levels”. Most common are PUBLIC for public
messages in channels, MSGS for private messages and CRAP for all sorts of
messages with no real classification. You can get a whole list of levels with

/HELP levels

Status window has message level ALL -MSGS, meaning that all messages, except
private messages, without more specific place go to status window. The -MSGS is
there so it doesn’t conflict with messages window.

6. How support for multiple servers works in irssi

ircii and several other clients support multiple servers by placing the
connection into some window. IRSSI DOES NOT. There is no required relationship
between window and server. You can connect to 10 servers and manage them all in
just one window, or join channel in each one of them to one single window if
you really want to. That being said, here’s how you do connect to new server
without closing the old connection:

/CONNECT irc.server.org

Instead of the /SERVER which disconnects the existing connection. To see list
of all active connections, use /SERVER without any parameters. You should see a
list of something like:

 -!- IRCNet: irc.song.fi:6667 (IRCNet)
 -!- OFTC: irc.oftc.net:6667 (OFTC)
 -!- RECON-1: 192.168.0.1:6667 () (02:59 left before reconnecting)

Here you see that we’re connected to IRCNet and OFTC networks. The IRCNet at
the beginning is called the “server tag” while the (IRCnet) at the end shows
the IRC network. Server tag specifies unique tag to refer to the server,
usually it’s the same as the IRC network. When the IRC network isn’t known it’s
some part of the server name. When there’s multiple connections to same IRC
network or server, irssi adds a number after the tag so there could be network,
network2, network3 etc.

Server tags beginning with RECON- mean server reconnections. Above we see that
connection to server at 192.168.0.1 wasn’t successful and irssi will try to
connect it again in 3 minutes.

To disconnect one of the servers, or to stop irssi from reconnecting, use

/DISCONNECT network   - disconnect server with tag "network"
/DISCONNECT recon-1  - stop trying to reconnect to RECON-1 server
/RMRECONNS           - stop all server reconnections

/RECONNECT recon-1   - immediately try reconnecting back to RECON-1
/RECONNECT ALL       - immediately try reconnecting back to all
                       servers in reconnection queue

Now that you’re connected to all your servers, you’ll have to know how to
specify which one of them you want to use. One way is to have an empty window,
like status or msgs window. In it, you can specify which server to set active
with

/WINDOW SERVER tag    - set server "tag" active
Ctrl-X                - set the next server in list active

When the server is active, you can use it normally. When there’s multiple
connected servers, irssi adds [servertag] prefix to all messages in non-channel
/query messages so you’ll know where it came from.

Several commands also accept -servertag option to specify which server it
should use:

/MSG -tag nick message
/JOIN -tag #channel
/QUERY -tag nick

/MSG tab completion also automatically adds the -tag option when nick isn’t in
active server.

Window’s server can be made sticky. When sticky, it will never automatically
change to anything else, and if server gets disconnected, the window won’t have
any active server. When the server gets connected again, it is automatically
set active in the window. To set the window’s server sticky use

/WINDOW SERVER -sticky tag

This is useful if you wish to have multiple status or msgs windows, one for
each server. Here’s how to do them (repeat for each server)

/WINDOW NEW HIDE
/WINDOW NAME (status)
/WINDOW LEVEL ALL -MSGS
/WINDOW SERVER -sticky network

/WINDOW NEW HIDE
/WINDOW NAME (msgs)
/WINDOW LEVEL MSGS
/WINDOW SERVER -sticky network

7. /LASTLOG and jumping around in scrollback

/LASTLOG command can be used for searching texts in scrollback buffer. Simplest
usages are

/LASTLOG word     - print all lines with "word" in them
/LASTLOG word 10  - print last 10 occurances of "word"
/LASTLOG -topics  - print all topic changes

If there’s more than 1000 lines to be printed, irssi thinks that you probably
made some mistake and won’t print them without -force option. If you want to
save the full lastlog to file, use

/LASTLOG -file ~/irc.log

With -file option you don’t need -force even if there’s more than 1000 lines. /
LASTLOG has a lot of other options too, see /HELP lastlog for details.

Once you’ve found the lines you were interested in, you might want to check the
discussion around them. Irssi has /SCROLLBACK (or alias /SB) command for
jumping around in scrollback buffer. Since /LASTLOG prints the timestamp when
the message was originally printed, you can use /SB GOTO hh:mm to jump directly
there. To get back to the bottom of scrollback, use /SB END command.

8. Logging

Irssi can automatically log important messages when you’re set away (/AWAY
reason). When you set yourself unaway (/AWAY), the new messages in away log are
printed to screen. You can configure it with:

/SET awaylog_level MSGS HILIGHT     - Specifies what messages to log
/SET awaylog_file ~/.irssi/away.log - Specifies the file to use

Easiest way to start logging with Irssi is to use autologging. With it Irssi
logs all channels and private messages to specified directory. You can turn it
on with

/SET autolog ON

By default it logs pretty much everything execept CTCPS or CRAP (/WHOIS
requests, etc). You can specify the logging level yourself with

/SET autolog_level ALL -CRAP -CLIENTCRAP -CTCPS (this is the default)

By default irssi logs to ~/irclogs/<servertag>/<target>.log. You can change
this with

/SET autolog_path ~/irclogs/$tag/$0.log (this is the default)

The path is automatically created if it doesn’t exist. $0 specifies the target
(channel/nick). You can make irssi automatically rotate the logs by adding date
/time formats to the file name. The formats are in “man strftime” format. For
example

/SET autolog_path ~/irclogs/%Y/$tag/$0.%m-%d.log

For logging only some specific channels or nicks, see /HELP log

9. Changing keyboard bindings

You can change any keyboard binding that terminal lets irssi know about. It
doesn’t let irssi know everything, so for example shift-backspace can’t be
bound unless you modify xterm resources somehow.

/HELP bind tells pretty much everything there is to know about keyboard
bindings. However, there’s the problem of how to bind some non-standard keys.
They might differ a bit with each terminal, so you’ll need to find out what
exactly the keypress produces. Easiest way to check that would be to see what
it prints in cat. Here’s an example for pressing F1 key:

 [cras@hurina] ~% cat
 ^[OP

So in irssi you would use /BIND ^[OP /ECHO F1 pressed. If you use multiple
terminals which have different bindings for the key, it would be better to use
eg.:

/BIND ^[OP key F1
/BIND ^[11~ key F1
/BIND F1 /ECHO F1 pressed.

10. Proxies and IRC bouncers

Irssi supports connecting to IRC servers via a proxy. All server connections
are then made through it, and if you’ve set up everything properly, you don’t
need to do any /QUOTE SERVER commands manually.

Here’s an example: You have your bouncer (lets say, BNC or BNC-like) listening
in irc.bouncer.org port 5000. You want to use it to connect to servers
irc.dal.net and irc.efnet.org. First you’d need to setup the bouncer:

/SET use_proxy ON
/SET proxy_address irc.bouncer.org
/SET proxy_port 5000

/SET proxy_password YOUR_BNC_PASSWORD_HERE
/SET -clear proxy_string
/SET proxy_string_after conn %s %d

Then you’ll need to add the server connections. These are done exactly as if
you’d want to connect directly to them. Nothing special about them:

/SERVER ADD -auto -network dalnet irc.dal.net
/SERVER ADD -auto -network efnet irc.efnet.org

With the proxy /SETs however, irssi now connects to those servers through your
BNC. All server connections are made through them so you can just forget that
your bouncer even exists.

If you don’t want to use the proxy for some reason, there’s -noproxy option
which you can give to /SERVER and /SERVER ADD commands.

Proxy specific settings:

All proxies except irssi proxy and socks proxy have these settings in common:

/SET use_proxy ON
/SET proxy_address <Proxy host address>
/SET proxy_port <Proxy port>

HTTP proxy

Use these settings with HTTP proxies:

/SET -clear proxy_password
/EVAL SET proxy_string CONNECT %s:%d HTTP/1.0\n\n

BNC

/SET proxy_password your_pass
/SET -clear proxy_string
/SET proxy_string_after conn %s %d

dircproxy

dircproxy separates the server connections by passwords. So, if you for example
have network connection with password ircpass and OFTC connection with
oftcpass, you would do something like this:

/SET -clear proxy_password
/SET -clear proxy_string

/SERVER ADD -auto -network IRCnet fake.network 6667 ircpass
/SERVER ADD -auto -network OFTC fake.oftc 6667 oftcpass

The server name and port you give isn’t used anywhere, so you can put anything
you want in there.

psyBNC

psyBNC has internal support for multiple servers. However, it could be a bit
annoying to use, and some people just use different users for connecting to
different servers. You can manage this in a bit same way as with dircproxy, by
creating fake connections:

/SET -clear proxy_password
/SET -clear proxy_string

/NETWORK ADD -user networkuser IRCnet
/SERVER ADD -auto -network IRCnet fake.network 6667 ircpass
/NETWORK ADD -user oftcuser OFTC
/SERVER ADD -auto -network OFTC fake.oftc 6667 oftcpass

So, you’ll specify the usernames with /NETWORK ADD command, and the user’s
password with /SERVER ADD.

Irssi proxy

Irssi contains it’s own proxy which you can build giving \--with-proxy option
to configure. You’ll still need to run irssi in a screen to use it though.

Irssi proxy is a bit different than most proxies, normally proxies create a new
connection to IRC server when a new client connects to it, but irssi proxy
shares your existing IRC connection(s) to multiple clients. And even more
clearly: You can use only one IRC server connection of the irssi proxy to IRC
with as many clients as you want. Can anyone figure out even more easier ways
to say this, so I wouldn’t need to try to explain this thing for minutes every
time? :)

Irssi proxy supports sharing multiple server connections in different ports,
like you can share network in port 2777 and efnet in port 2778.

Usage in proxy side:

/LOAD proxy
/SET irssiproxy_password <password>
/SET irssiproxy_ports <network>=<port> ... (eg. IRCnet=2777 efnet=2778)

NOTE: you MUST add all the servers you are using to server and network lists
with /SERVER ADD and /NETWORK ADD. ..Except if you really don’t want to for
some reason, and you only use one server connection, you may simply set:

/SET irssiproxy_ports *=2777

Usage in client side:

Just connect to the irssi proxy like it is a normal server with password
specified in /SET irssiproxy_password. For example:

/SERVER ADD -network IRCnet my.irssi-proxy.org 2777 secret
/SERVER ADD -network efnet my.irssi-proxy.org 2778 secret

Irssi proxy works fine with other IRC clients as well.

SOCKS

Irssi can be compiled with socks support (--with-socks option to configure),
which requires “dante” and routes all connections through the proxy specified
in the system-wide /etc/socks.conf. This method is known to have issues in Mac
OS X.

Note that /SET proxy settings don’t have anything to do with socks.

Using [4]proxychains-ng is recommended over recompiling irssi.

Others

IRC bouncers usually work like IRC servers, and want a password. You can give
it with:

/SET proxy_password <password>

Irssi’s defaults for connect strings are

/SET proxy_string CONNECT %s %d
/SET proxy_string_after

The proxy_string is sent before NICK/USER commands, the proxy_string_after is
sent after them. %s and %d can be used with both of them.

11. Irssi’s settings

Here’s some settings you might want to change (the default value is shown):
Also check the [5]Settings Documentation

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 autocreate_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.

For all the ircII people

I don’t like automatic query windows, I don’t like status window, I do like
msgs window where all messages go:

/SET autocreate_own_query OFF
/SET autocreate_query_level DCCMSGS
/SET use_status_window OFF
/SET use_msgs_window ON

Disable automatic window closing when /PARTing channel or /UNQUERYing query:

/SET autoclose_windows OFF
/SET reuse_unused_windows ON

Here’s the settings that make irssi work exactly like ircII in window
management (send me a note if you can think of more):

/SET autocreate_own_query OFF
/SET autocreate_query_level NONE
/SET use_status_window OFF
/SET use_msgs_window OFF
/SET reuse_unused_windows ON
/SET windows_auto_renumber OFF

/SET autostick_split_windows OFF
/SET autoclose_windows OFF
/SET print_active_channel ON

12. Statusbar

/STATUSBAR displays a list of the current statusbars, along with their position
and visibility:

 Name                           Type   Placement Position Visible
 window                         window bottom    0        always
 window_inact                   window bottom    1        inactive
 prompt                         root   bottom    100      always
 topic                          root   top       1        always

/STATUSBAR <name> prints the statusbar settings (type, placement, position,
visibility) as well as its items. /STATUSBAR <name> ENABLE|DISABLE enables/
disables the statusbar. /STATUSBAR <name> RESET resets the statusbar to its
default settings, or if the statusbar was created by you, it will be removed.

The statusbar type can be either window or root. If the type is window, then a
statusbar will be created for each split window, otherwise it will be created
only once. Placement can be top or bottom, which refers to the top or bottom of
the screen. Position is a number, the higher the value the lower it will appear
in-screen. Visible can be always, active or inactive. Active/inactive is useful
only with split windows; one split window is active and the rest are inactive.
To adjust these settings, the following commands are available:

/STATUSBAR <name> TYPE window|root
/STATUSBAR <name> PLACEMENT top|bottom
/STATUSBAR <name> POSITION <num>
/STATUSBAR <name> VISIBLE always|active|inactive

Statusbar items can also be added or removed via command. Note that when
loading new statusbar scripts that add items, you will need to specify where
you want to show the item and how it is aligned. This can be accomplished using
the below commands:

/STATUSBAR <name> ADD [-before | -after <item>] [-priority #] [-alignment left|right] <item>
/STATUSBAR <name> REMOVE <item>

For statusbar scripts, the item name is usually equivalent to the script name.
The documentation of the script ought to tell you if this is not the case. For
example, to add mail.pl before the window activity item, use: /STATUSBAR window
ADD -before act mail.


References:

[1] https://www.gnu.org/licenses/fdl.html
[2] https://www.iterm2.com/
[3] https://quadpoint.org/articles/irssisplit/
[4] https://github.com/rofl0r/proxychains-ng
[5] https://irssi.org/documentation/settings/