apps/irssi/docs/faq.html

   1 <h2>FAQ</h2>
   2
   3 <h3>Q: Why doesn't irssi display colors even when ircii etc. displays them?</h3>
   4
   5 <p>A: They force ANSI colors even if terminal doesn't support them. By
   6 default, irssi uses colors only if terminfo/termcap so says. The correct
   7 way to fix this would be to change your TERM environment to a value where
   8 colors work, like xterm-color or color_xterm (eg. <code>TERM=xterm-color
   9 irssi</code>). If this doesn't help, then use the evil way of <code>/SET
  10 term_force_colors ON</code>.</p>
  11
  12
  13 <h3>Q: How do I easily write text to channel that starts with '/' character?</h3>
  14
  15 <p>A: <code>/ /text</code></p>
  16
  17
  18 <h3>Q: Why doesn't irssi update my realname (or whatever) after I change it
  19 with <code>/SET realname</code> and reconnect with <code>/RECONNECT</code>
  20 or <code>/SERVER</code>?</h3>
  21
  22 <p>A: Irssi is trying to be too smart. This will be fixed in future, but for
  23 now you should use <code>/DISCONNECT</code> and <code>/CONNECT</code>.</p>
  24
  25
  26 <h3>Q: I connected to some server which isn't responding but now irssi tries
  27 to connect back to it all the time! How can I stop it?</h3>
  28
  29 <p>A: Two ways. The "good way" to do it is with <code>/DISCONNECT</code>.
  30 Check the server tags first with <code>/SERVER</code> without giving it any
  31 parameters, reconnections are those that have tag starting with "recon"
  32 text. So most probably you're going to do <code>/DISCONNECT recon-1</code>.
  33 The other way is to remove all the reconnections with
  34 <code>/RMRECONNS</code>, easier but may remove some connections you actually
  35 wanted to reconnect (if you used multiple servers..).</p>
  36
  37
  38 <h3>Q: How do I add seconds to timestamp?</h3>
  39
  40 <p>A: <code>/FORMAT timestamp {timestamp %%H:%%M:%%S}</code> - and remember
  41 to add the trailing space :)</p>
  42
  43
  44 <h3>Q: Why does irssi say "Irssi: Channel not fully synchronized yet, try
  45 again after a while" when I try to use /BAN etc?</h3>
  46
  47 <p>A: Possibly a bug in irssi, or ircd you're using does something that
  48 irssi didn't really notice. The new code should make this happen far less
  49 often than before, but one known reason for this is when irssi doesn't
  50 notice that you were unable to join some channel. Currently however I don't
  51 know of any such events irssi doesn't know about.</p>
  52
  53 <p>Anyway, if this does happen, do <code>/RAWLOG SAVE ~/rawlog</code> soon
  54 after joining to channel, and either try to figure out yourself why irssi
  55 didn't get reply to WHO request, or send the whole log to cras@irssi.org. Note
  56 that the rawlog is by default only 200 lines and it may not be enough to
  57 show all needed information, so you might want to do <code>/SET rawlog_lines
  58 1000</code> or so.</p>
  59
  60 <p><code>MODE +b</code> still works fine though.</p>
  61
  62
  63 <h3>Q: Where's the GUI version?</h3>
  64
  65 <p>A: Read
  66 <a href="http://irssi.org/?page=about">http://irssi.org/?page=about</a></p>
  67
  68
  69 <h3>Q: How do I autorejoin channels after being kicked?</h3>
  70
  71 <p>A: That's evil and you shouldn't do it. If you get kicked, you should stay
  72 out, at least until the channel forgot you existed :) Most channels I've
  73 joined just ban you if you autorejoin after kick. If you're joined to
  74 channels who kick people for fun, try changing channels or something.</p>
  75
  76 <p>Anyway, if you REALLY want to do that, and you understand that you're doing
  77 evilness, you can use the autorejoin.pl script that comes with irssi. You'll
  78 still need to specify the channels you wish to rejoin with <code>/SET
  79 autorejoin_channels #chan1 #chan2 ...</code></p>
  80
  81
  82 <h3>Q: How do I announce that I'm away/back in all channels I've joined? Or
  83 how do I change my nick when setting myself away/back?</h3>
  84
  85 <p>A: That's even worse than autorejoin. Who could possibly care every time
  86 you come and go? Many channels will kick you for using this, and I for example
  87 have added several ignores so I'd never need to see these messages. Learn to
  88 use <code>/AWAY</code> command properly and tell its existence to people
  89 who don't know about it. <code>/WII yournick</code> shows your away reason
  90 much better for people who actually want to know if you're there or not.</p>
  91
  92
  93 <h3>Q: Why does irssi autojoin on invite by default?</h3>
  94
  95 <p>A: The setting is /SET join_auto_chans_on_invite - it's not the same
  96 as regular autojoin-on-invite, which irssi doesn't even have. The only
  97 channels that are joined on invite, are the ones you've added to config
  98 with /CHANNEL ADD -auto. This is very useful with +i channels when you
  99 need to first send an invite request to bot, or if you get accidentally
 100 kicked from channel, the kicker can invite you back immediately.</p>
 101
 102 <p>I don't see any bad side effects with this feature, so it's ON by
 103 default. I guess someone could start kicking/inviting you all the time
 104 but server connection shouldn't drop because of that, and you shouldn't
 105 join channels whose operators are that evil.</p>
 106
 107
 108 <h3>Q: How to make UTF-8 support work with irssi?</h3>
 109
 110 <p>A: Make sure your terminal supports UTF-8 (for example, <code>xterm -u8</code>).
 111 If you use screen, you may have to do <code>screen -U</code>. And in Irssi do
 112 <code>/SET term_charset utf-8</code>. (for 0.8.9 and older: <code>/SET term_type utf-8</code>)</p>
 113
 114
 115 <h3>Q: Will there be /DETACH-like feature?</h3>
 116
 117 <p>A: Maybe. Detach code already is there, attach is just missing :) But I
 118 don't have much interest in coding it,
 119 <a href="http://www.gnu.org/software/screen/screen.html">screen</a> and
 120 <a href="http://dtach.sf.net/">dtach</a> can be used to do it just fine.</p>
 121
 122
 123 <h3>Q: How do I run scripts automatically at startup?</h3>
 124
 125 <p>A: Put them into <code>~/.irssi/scripts/autorun/</code> directory. Or
 126 better would be if you placed them in <code>~/.irssi/scripts/</code> and
 127 created symlinks to autorun directory (eg. <code>cd
 128 ~/.irssi/scripts/autorun/ ; ln -s ../script.pl .</code>)</p>
 129
 130
 131 <h3>Q: How do I execute commands automatically at startup?</h3>
 132
 133 <p>A: Put them into <code>~/.irssi/startup</code> file, each command on its
 134 own line. The preceding slash (/) is not necessary.</p>
 135
 136
 137 <h3>Q: How do I easily edit existing topic?</h3>
 138
 139 <p>A: /TOPIC &lt;tab&gt;</p>
 140
 141 <h3>Q: How can I have /WHOIS replies to active window?</h3>
 142
 143 <p>A: You can disable the status window, or do <code>/WINDOW LEVEL
 144 -CRAP</code> in it which would also make several other messages show up in
 145 active window. You can also use a
 146 <a href="http://dgl.cx/irssi/hack-whois-in-current-window.pl">script</a>.</p>
 147
 148 <h3>Q: How do I add the active network to the statusbar</h3>
 149
 150 <p>A: Modify the window-line in statusbar section in config file to
 151 <code>window = "{sb $winref:$tag/$T{sbmode $M}}";</code></p>
 152