apps/irssi/docs/faq.txt

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