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 .)
 107
 108 Q: How do I easily edit existing topic?
 109 A: /TOPIC <tab>
 110
 111 Q: How can I have /WHOIS replies to active window?
 112 A:  Currently there's no other way than to close the status window, or
 113    at least do /WINDOW LEVEL -CRAP in it, but that would make a lot other
 114    messages  show  up  in active window too. I don't have many good ideas
 115    how  this  could be easily fixed inside irssi (no, kludging it to only
 116    work  with  whois isn't a "fix") - it'd be possible to create a script
 117    do this though but currently it doesn't exist.