2022-04-24 16:06:12 +02:00

2404 lines
163 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!doctype html>
<html class="no-js">
<head><meta charset="utf-8"/>
<meta name="viewport" content="width=device-width,initial-scale=1"/>
<meta name="color-scheme" content="light dark"><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
<link rel="index" title="Index" href="../genindex.html" /><link rel="search" title="Search" href="../search.html" /><link rel="prev" title="script" href="help/script.html" />
<meta name="generator" content="sphinx-4.4.0, furo 2022.03.04"/>
<title>Settings Documentation - Neırssi documentation</title>
<link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
<link rel="stylesheet" type="text/css" href="../_static/styles/furo.css?digest=935aa2abcc5c1da4283d1dc201fb1f0add16d23a" />
<link rel="stylesheet" type="text/css" href="../_static/styles/furo-extensions.css?digest=25ceb02ed1c46dc30f2321ff83e92799f69dfdb9" />
<link rel="stylesheet" type="text/css" href="../_static/theme_tweak.css" />
<style>
body {
--color-code-background: #f8f8f8;
--color-code-foreground: black;
}
@media not print {
body[data-theme="dark"] {
--color-code-background: #202020;
--color-code-foreground: #d0d0d0;
}
@media (prefers-color-scheme: dark) {
body:not([data-theme="light"]) {
--color-code-background: #202020;
--color-code-foreground: #d0d0d0;
}
}
}
</style></head>
<body>
<script>
document.body.dataset.theme = localStorage.getItem("theme") || "auto";
</script>
<svg xmlns="http://www.w3.org/2000/svg" style="display: none;">
<symbol id="svg-toc" viewBox="0 0 24 24">
<title>Contents</title>
<svg stroke="currentColor" fill="currentColor" stroke-width="0" viewBox="0 0 1024 1024">
<path d="M408 442h480c4.4 0 8-3.6 8-8v-56c0-4.4-3.6-8-8-8H408c-4.4 0-8 3.6-8 8v56c0 4.4 3.6 8 8 8zm-8 204c0 4.4 3.6 8 8 8h480c4.4 0 8-3.6 8-8v-56c0-4.4-3.6-8-8-8H408c-4.4 0-8 3.6-8 8v56zm504-486H120c-4.4 0-8 3.6-8 8v56c0 4.4 3.6 8 8 8h784c4.4 0 8-3.6 8-8v-56c0-4.4-3.6-8-8-8zm0 632H120c-4.4 0-8 3.6-8 8v56c0 4.4 3.6 8 8 8h784c4.4 0 8-3.6 8-8v-56c0-4.4-3.6-8-8-8zM115.4 518.9L271.7 642c5.8 4.6 14.4.5 14.4-6.9V388.9c0-7.4-8.5-11.5-14.4-6.9L115.4 505.1a8.74 8.74 0 0 0 0 13.8z"/>
</svg>
</symbol>
<symbol id="svg-menu" viewBox="0 0 24 24">
<title>Menu</title>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather-menu">
<line x1="3" y1="12" x2="21" y2="12"></line>
<line x1="3" y1="6" x2="21" y2="6"></line>
<line x1="3" y1="18" x2="21" y2="18"></line>
</svg>
</symbol>
<symbol id="svg-arrow-right" viewBox="0 0 24 24">
<title>Expand</title>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather-chevron-right">
<polyline points="9 18 15 12 9 6"></polyline>
</svg>
</symbol>
<symbol id="svg-sun" viewBox="0 0 24 24">
<title>Light mode</title>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="feather-sun">
<circle cx="12" cy="12" r="5"></circle>
<line x1="12" y1="1" x2="12" y2="3"></line>
<line x1="12" y1="21" x2="12" y2="23"></line>
<line x1="4.22" y1="4.22" x2="5.64" y2="5.64"></line>
<line x1="18.36" y1="18.36" x2="19.78" y2="19.78"></line>
<line x1="1" y1="12" x2="3" y2="12"></line>
<line x1="21" y1="12" x2="23" y2="12"></line>
<line x1="4.22" y1="19.78" x2="5.64" y2="18.36"></line>
<line x1="18.36" y1="5.64" x2="19.78" y2="4.22"></line>
</svg>
</symbol>
<symbol id="svg-moon" viewBox="0 0 24 24">
<title>Dark mode</title>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="icon-tabler-moon">
<path stroke="none" d="M0 0h24v24H0z" fill="none" />
<path d="M12 3c.132 0 .263 0 .393 0a7.5 7.5 0 0 0 7.92 12.446a9 9 0 1 1 -8.313 -12.454z" />
</svg>
</symbol>
<symbol id="svg-sun-half" viewBox="0 0 24 24">
<title>Auto light/dark mode</title>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="icon-tabler-shadow">
<path stroke="none" d="M0 0h24v24H0z" fill="none"/>
<circle cx="12" cy="12" r="9" />
<path d="M13 12h5" />
<path d="M13 15h4" />
<path d="M13 18h1" />
<path d="M13 9h4" />
<path d="M13 6h1" />
</svg>
</symbol>
</svg>
<input type="checkbox" class="sidebar-toggle" name="__navigation" id="__navigation">
<input type="checkbox" class="sidebar-toggle" name="__toc" id="__toc">
<label class="overlay sidebar-overlay" for="__navigation">
<div class="visually-hidden">Hide navigation sidebar</div>
</label>
<label class="overlay toc-overlay" for="__toc">
<div class="visually-hidden">Hide table of contents sidebar</div>
</label>
<div class="page">
<header class="mobile-header">
<div class="header-left">
<label class="nav-overlay-icon" for="__navigation">
<div class="visually-hidden">Toggle site navigation sidebar</div>
<i class="icon"><svg><use href="#svg-menu"></use></svg></i>
</label>
</div>
<div class="header-center">
<a href="../index.html"><div class="brand">Neırssi documentation</div></a>
</div>
<div class="header-right">
<div class="theme-toggle-container theme-toggle-header">
<button class="theme-toggle">
<div class="visually-hidden">Toggle Light / Dark / Auto color theme</div>
<svg class="theme-icon-when-auto"><use href="#svg-sun-half"></use></svg>
<svg class="theme-icon-when-dark"><use href="#svg-moon"></use></svg>
<svg class="theme-icon-when-light"><use href="#svg-sun"></use></svg>
</button>
</div>
<label class="toc-overlay-icon toc-header-icon" for="__toc">
<div class="visually-hidden">Toggle table of contents sidebar</div>
<i class="icon"><svg><use href="#svg-toc"></use></svg></i>
</label>
</div>
</header>
<aside class="sidebar-drawer">
<div class="sidebar-container">
<div class="sidebar-sticky"><a class="sidebar-brand" href="../index.html">
<span class="sidebar-brand-text">Neırssi documentation</span>
</a><form class="sidebar-search-container" method="get" action="../search.html" role="search">
<input class="sidebar-search" placeholder=Search name="q" aria-label="Search">
<input type="hidden" name="check_keywords" value="yes">
<input type="hidden" name="area" value="default">
</form>
<div id="searchbox"></div><div class="sidebar-scroll"><div class="sidebar-tree">
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="../Getting.html">Getting the software</a></li>
<li class="toctree-l1"><a class="reference internal" href="../New-users.html">New users guide</a></li>
<li class="toctree-l1"><a class="reference internal" href="../User-interface.html">User interface</a></li>
<li class="toctree-l1 has-children"><a class="reference internal" href="../news/index.html">NEWS</a><input class="toctree-checkbox" id="toctree-checkbox-1" name="toctree-checkbox-1" role="switch" type="checkbox"/><label for="toctree-checkbox-1"><div class="visually-hidden">Toggle child pages in navigation</div><i class="icon"><svg><use href="#svg-arrow-right"></use></svg></i></label><ul>
<li class="toctree-l2"><a class="reference internal" href="../news/Irssi-1.3.html">Irssi 1.3</a></li>
<li class="toctree-l2"><a class="reference internal" href="../news/Irssi-1.4.html">Irssi 1.4</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../Modules.html">Modules</a></li>
<li class="toctree-l1 current has-children"><a class="reference internal" href="index.html">On-line help</a><input checked="" class="toctree-checkbox" id="toctree-checkbox-2" name="toctree-checkbox-2" role="switch" type="checkbox"/><label for="toctree-checkbox-2"><div class="visually-hidden">Toggle child pages in navigation</div><i class="icon"><svg><use href="#svg-arrow-right"></use></svg></i></label><ul class="current">
<li class="toctree-l2 has-children"><a class="reference internal" href="help/index.html">Help</a><input class="toctree-checkbox" id="toctree-checkbox-3" name="toctree-checkbox-3" role="switch" type="checkbox"/><label for="toctree-checkbox-3"><div class="visually-hidden">Toggle child pages in navigation</div><i class="icon"><svg><use href="#svg-arrow-right"></use></svg></i></label><ul>
<li class="toctree-l3 has-children"><a class="reference internal" href="help/cat_Connection.html">Connection</a><input class="toctree-checkbox" id="toctree-checkbox-4" name="toctree-checkbox-4" role="switch" type="checkbox"/><label for="toctree-checkbox-4"><div class="visually-hidden">Toggle child pages in navigation</div><i class="icon"><svg><use href="#svg-arrow-right"></use></svg></i></label><ul>
<li class="toctree-l4"><a class="reference internal" href="help/connect.html">connect</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/disconnect.html">disconnect</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/network.html">network</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/quit.html">quit</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/rawlog.html">rawlog</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/reconnect.html">reconnect</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/rmreconns.html">rmreconns</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/server.html">server</a></li>
</ul>
</li>
<li class="toctree-l3 has-children"><a class="reference internal" href="help/cat_Core%20Commands.html">Core Commands</a><input class="toctree-checkbox" id="toctree-checkbox-5" name="toctree-checkbox-5" role="switch" type="checkbox"/><label for="toctree-checkbox-5"><div class="visually-hidden">Toggle child pages in navigation</div><i class="icon"><svg><use href="#svg-arrow-right"></use></svg></i></label><ul>
<li class="toctree-l4"><a class="reference internal" href="help/channel.html">channel</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/cycle.html">cycle</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/join.html">join</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/msg.html">msg</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/names.html">names</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/query.html">query</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/unquery.html">unquery</a></li>
</ul>
</li>
<li class="toctree-l3 has-children"><a class="reference internal" href="help/cat_Window%20Commands.html">Window Commands</a><input class="toctree-checkbox" id="toctree-checkbox-6" name="toctree-checkbox-6" role="switch" type="checkbox"/><label for="toctree-checkbox-6"><div class="visually-hidden">Toggle child pages in navigation</div><i class="icon"><svg><use href="#svg-arrow-right"></use></svg></i></label><ul>
<li class="toctree-l4"><a class="reference internal" href="help/clear.html">clear</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/lastlog.html">lastlog</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/layout.html">layout</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/scrollback.html">scrollback</a></li>
<li class="toctree-l4 has-children"><a class="reference internal" href="help/window.html">window</a><input class="toctree-checkbox" id="toctree-checkbox-7" name="toctree-checkbox-7" role="switch" type="checkbox"/><label for="toctree-checkbox-7"><div class="visually-hidden">Toggle child pages in navigation</div><i class="icon"><svg><use href="#svg-arrow-right"></use></svg></i></label><ul>
<li class="toctree-l5"><a class="reference internal" href="help/window_creation.html">creation</a></li>
<li class="toctree-l5"><a class="reference internal" href="help/window_changing.html">changing</a></li>
<li class="toctree-l5"><a class="reference internal" href="help/window_properties.html">attribute manipulation</a></li>
<li class="toctree-l5"><a class="reference internal" href="help/window_items.html">items</a></li>
<li class="toctree-l5"><a class="reference internal" href="help/window_moving.html">moving/number changing</a></li>
<li class="toctree-l5"><a class="reference internal" href="help/window_resizing.html">resizing</a></li>
<li class="toctree-l5"><a class="reference internal" href="help/window_navigation.html">navigation</a></li>
<li class="toctree-l5"><a class="reference internal" href="help/window_split_moving.html">moving</a></li>
<li class="toctree-l5"><a class="reference internal" href="help/window_logging.html">logging</a></li>
</ul>
</li>
</ul>
</li>
<li class="toctree-l3 has-children"><a class="reference internal" href="help/cat_Settings.html">Settings</a><input class="toctree-checkbox" id="toctree-checkbox-8" name="toctree-checkbox-8" role="switch" type="checkbox"/><label for="toctree-checkbox-8"><div class="visually-hidden">Toggle child pages in navigation</div><i class="icon"><svg><use href="#svg-arrow-right"></use></svg></i></label><ul>
<li class="toctree-l4"><a class="reference internal" href="help/alias.html">alias</a></li>
<li class="toctree-l4 has-children"><a class="reference internal" href="help/bind.html">bind</a><input class="toctree-checkbox" id="toctree-checkbox-9" name="toctree-checkbox-9" role="switch" type="checkbox"/><label for="toctree-checkbox-9"><div class="visually-hidden">Toggle child pages in navigation</div><i class="icon"><svg><use href="#svg-arrow-right"></use></svg></i></label><ul>
<li class="toctree-l5"><a class="reference internal" href="help/bind_-list.html">bind -list</a></li>
</ul>
</li>
<li class="toctree-l4"><a class="reference internal" href="help/completion.html">completion</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/dehilight.html">dehilight</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/format.html">format</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/hilight.html">hilight</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/ignore.html">ignore</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/log.html">log</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/recode.html">recode</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/reload.html">reload</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/save.html">save</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/set.html">set</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/statusbar.html">statusbar</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/toggle.html">toggle</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/unalias.html">unalias</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/unignore.html">unignore</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/upgrade.html">upgrade</a></li>
</ul>
</li>
<li class="toctree-l3 has-children"><a class="reference internal" href="help/cat_Misc.html">Misc</a><input class="toctree-checkbox" id="toctree-checkbox-10" name="toctree-checkbox-10" role="switch" type="checkbox"/><label for="toctree-checkbox-10"><div class="visually-hidden">Toggle child pages in navigation</div><i class="icon"><svg><use href="#svg-arrow-right"></use></svg></i></label><ul>
<li class="toctree-l4"><a class="reference internal" href="help/beep.html">beep</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/cat.html">cat</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/cd.html">cd</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/echo.html">echo</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/eval.html">eval</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/exec.html">exec</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/help.html">help</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/load.html">load</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/unload.html">unload</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/uptime.html">uptime</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/version.html">version</a></li>
</ul>
</li>
<li class="toctree-l3 has-children"><a class="reference internal" href="help/cat_IRC%20Commands.html">IRC Commands</a><input class="toctree-checkbox" id="toctree-checkbox-11" name="toctree-checkbox-11" role="switch" type="checkbox"/><label for="toctree-checkbox-11"><div class="visually-hidden">Toggle child pages in navigation</div><i class="icon"><svg><use href="#svg-arrow-right"></use></svg></i></label><ul>
<li class="toctree-l4"><a class="reference internal" href="help/accept.html">accept</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/action.html">action</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/admin.html">admin</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/away.html">away</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/ban.html">ban</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/ctcp.html">ctcp</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/dcc.html">dcc</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/deop.html">deop</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/devoice.html">devoice</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/die.html">die</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/hash.html">hash</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/info.html">info</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/invite.html">invite</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/ison.html">ison</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/kick.html">kick</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/kickban.html">kickban</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/kill.html">kill</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/knock.html">knock</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/knockout.html">knockout</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/links.html">links</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/list.html">list</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/lusers.html">lusers</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/map.html">map</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/me.html">me</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/mircdcc.html">mircdcc</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/mode.html">mode</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/motd.html">motd</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/nctcp.html">nctcp</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/netsplit.html">netsplit</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/nick.html">nick</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/notice.html">notice</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/notify.html">notify</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/op.html">op</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/oper.html">oper</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/part.html">part</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/ping.html">ping</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/quote.html">quote</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/rehash.html">rehash</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/restart.html">restart</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/sconnect.html">sconnect</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/servlist.html">servlist</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/silence.html">silence</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/squery.html">squery</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/squit.html">squit</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/stats.html">stats</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/time.html">time</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/topic.html">topic</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/trace.html">trace</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/ts.html">ts</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/unban.html">unban</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/unnotify.html">unnotify</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/unsilence.html">unsilence</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/userhost.html">userhost</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/ver.html">ver</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/voice.html">voice</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/wait.html">wait</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/wall.html">wall</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/wallops.html">wallops</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/who.html">who</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/whois.html">whois</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/whowas.html">whowas</a></li>
</ul>
</li>
<li class="toctree-l3 has-children"><a class="reference internal" href="help/cat_IRC%20Proxy.html">IRC Proxy</a><input class="toctree-checkbox" id="toctree-checkbox-12" name="toctree-checkbox-12" role="switch" type="checkbox"/><label for="toctree-checkbox-12"><div class="visually-hidden">Toggle child pages in navigation</div><i class="icon"><svg><use href="#svg-arrow-right"></use></svg></i></label><ul>
<li class="toctree-l4"><a class="reference internal" href="help/irssiproxy.html">irssiproxy</a></li>
</ul>
</li>
<li class="toctree-l3 has-children"><a class="reference internal" href="help/cat_Other%20pages.html">Other pages</a><input class="toctree-checkbox" id="toctree-checkbox-13" name="toctree-checkbox-13" role="switch" type="checkbox"/><label for="toctree-checkbox-13"><div class="visually-hidden">Toggle child pages in navigation</div><i class="icon"><svg><use href="#svg-arrow-right"></use></svg></i></label><ul>
<li class="toctree-l4"><a class="reference internal" href="help/flushbuffer.html">flushbuffer</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/levels.html">levels</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/otr.html">otr</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/rmrejoins.html">rmrejoins</a></li>
<li class="toctree-l4"><a class="reference internal" href="help/script.html">script</a></li>
</ul>
</li>
</ul>
</li>
<li class="toctree-l2 current current-page"><a class="current reference internal" href="#">Settings</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference external" href="https://scripts.irssi.org/">Scripts</a></li>
<li class="toctree-l1"><a class="reference external" href="https://irssi.org/themes/">Themes</a></li>
<li class="toctree-l1"><a class="reference external" href="https://github.com/ailin-nemui/irssi">Source Code</a></li>
<li class="toctree-l1"><a class="reference external" href="https://liberapay.com/Nei">💜 Send money</a></li>
</ul>
</div>
</div>
</div>
</div>
</aside>
<div class="main">
<div class="content">
<div class="article-container">
<a href="#" class="back-to-top muted-link">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
<path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8v12z"></path>
</svg>
<span>Back to top</span>
</a>
<div class="content-icon-container"><div class="theme-toggle-container theme-toggle-content">
<button class="theme-toggle">
<div class="visually-hidden">Toggle Light / Dark / Auto color theme</div>
<svg class="theme-icon-when-auto"><use href="#svg-sun-half"></use></svg>
<svg class="theme-icon-when-dark"><use href="#svg-moon"></use></svg>
<svg class="theme-icon-when-light"><use href="#svg-sun"></use></svg>
</button>
</div>
<label class="toc-overlay-icon toc-content-icon" for="__toc">
<div class="visually-hidden">Toggle table of contents sidebar</div>
<i class="icon"><svg><use href="#svg-toc"></use></svg></i>
</label>
</div>
<article role="main">
<section id="settings-documentation">
<h1>Settings Documentation<a class="headerlink" href="#settings-documentation" title="Permalink to this headline"> </a></h1>
<p>Irssi settings notes. Updated for 1.3.0</p>
<p>This is not an attempt to document Irssi completely. It should be used along with the documents at <span class="xref myst">Documentation</span> for more complete understanding of how Irssi works. For example, the startup HOWTO and tips/tricks show sample uses for these settings, including some very useful stuff.</p>
<p>See the <span class="xref myst">appendix</span> for credits and license information of this document.</p>
<section id="completion">
<h2>[completion]<a class="headerlink" href="#completion" title="Permalink to this headline"> </a></h2>
<dl class="simple myst" id="completion-auto">
<dt><code class="docutils literal notranslate"><span class="pre">completion_auto</span></code> <strong><code class="docutils literal notranslate"><span class="pre">OFF</span></code></strong></dt><dd><p>Tell Irssi to detect incomplete nicknames in your input and look up their completions automatically. Incomplete nicknames are detected when you input text that matches /^(\S+)${completion_character}/. For example:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>vis: hello
</pre></div>
</div>
<p>will be expanded to</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>visitors: hello
</pre></div>
</div>
<p>when you press enter. So will:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>vis:hello
Vis::Hello(12);
</pre></div>
</div>
<p>This will eventually bite you.</p>
</dd>
</dl>
<dl class="simple myst" id="completion-char">
<dt><code class="docutils literal notranslate"><span class="pre">completion_char</span></code> <strong><code class="docutils literal notranslate"><span class="pre">:</span></code></strong></dt><dd><p>The text that Irssi puts after a tab-completed nickname, or that it uses to detect nicknames when you have completion_auto turned on. Some people alter this to colorize the completion character, creating the oft-dreaded bold colon.</p>
</dd>
</dl>
<dl class="simple myst" id="completion-empty-line">
<dt><code class="docutils literal notranslate"><span class="pre">completion_empty_line</span></code> <strong><code class="docutils literal notranslate"><span class="pre">ON</span></code></strong></dt><dd><p>When this setting is OFF, tab completion will be disabled when the input line is empty. Disabling it is useful when pasting text that starts with a tab character, since that normally results in a /msg to a recent target.</p>
<p>Added in Irssi 1.0.0</p>
</dd>
</dl>
<dl class="simple myst" id="completion-keep-word">
<dt><code class="docutils literal notranslate"><span class="pre">completion_keep_word</span></code> <strong><code class="docutils literal notranslate"><span class="pre">ON</span></code></strong></dt><dd><p>Whether to keep the original word that was completed, in the list of completions. This way, you can “undo” accidential completions more easily with Shift-Tab.</p>
<p>Added in Irssi 1.2.0</p>
</dd>
</dl>
<dl class="simple myst" id="completion-keep-privates">
<dt><code class="docutils literal notranslate"><span class="pre">completion_keep_privates</span></code> <strong><code class="docutils literal notranslate"><span class="pre">10</span></code></strong></dt><dd><p>Irssi keeps a list of nicknames from private messages (sent and received) to search during nick completion. This setting determines how many nicknames are held.</p>
</dd>
</dl>
<dl class="simple myst" id="completion-keep-publics">
<dt><code class="docutils literal notranslate"><span class="pre">completion_keep_publics</span></code> <strong><code class="docutils literal notranslate"><span class="pre">50</span></code></strong></dt><dd><p>Irssi keeps a list of nicknames from public messages (sent and received) to search during nick completion. This setting determines how many nicknames are held.</p>
</dd>
</dl>
<dl class="simple myst" id="completion-nicks-lowercase">
<dt><code class="docutils literal notranslate"><span class="pre">completion_nicks_lowercase</span></code> <strong><code class="docutils literal notranslate"><span class="pre">OFF</span></code></strong></dt><dd><p>When enabled, Irssi forces completed nicknames to lowercase. Manually typed nicknames retain their case.</p>
</dd>
</dl>
<dl class="simple myst" id="completion-strict">
<dt><code class="docutils literal notranslate"><span class="pre">completion_strict</span></code> <strong><code class="docutils literal notranslate"><span class="pre">OFF</span></code></strong></dt><dd><p>When on, nicknames are matched strictly. That is, the partial nickname you enter must be at the beginning of a nickname in one of Irssis lists.</p>
<p>When off, Irssi will first try a strict match. If a strict match cant be found, Irssi will look for nicknames that match when their leading non-alphanumeric characters are removed. For example:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>vis: hello
</pre></div>
</div>
<p>With strict completion on, it will only match nicknames beginning with vis. With strict completion off, it may match visitors or <em>visitors</em> or [visitors], and so on.</p>
</dd>
</dl>
<dl class="simple myst" id="completion-nicks-match-case">
<dt><code class="docutils literal notranslate"><span class="pre">completion_nicks_match_case</span></code> <strong><code class="docutils literal notranslate"><span class="pre">auto</span></code></strong></dt><dd><p>Whether to enforce the case of the letters you typed while completing nicks. Accepted values:</p>
<dl class="simple myst">
<dt><code class="docutils literal notranslate"><span class="pre">never</span></code></dt><dd><p>ignore the case of nicks when completing.</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">always</span></code></dt><dd><p>nicks are only completed when the case matches.</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">auto</span></code> (default)</dt><dd><p>as soon as you type an uppercase letter, the nick case has to match.</p>
</dd>
</dl>
<p>Added in Irssi 1.0.0</p>
</dd>
</dl>
</section>
<section id="dcc">
<h2>[dcc]<a class="headerlink" href="#dcc" title="Permalink to this headline"> </a></h2>
<dl class="simple myst" id="dcc-autoaccept-lowports">
<dt><code class="docutils literal notranslate"><span class="pre">dcc_autoaccept_lowports</span></code> <strong><code class="docutils literal notranslate"><span class="pre">OFF</span></code></strong></dt><dd><p>When this setting is OFF, Irssi will not auto-accept DCC requests from privileged ports (those below 1024) even when auto-accept is otherwise on.</p>
</dd>
</dl>
<dl class="simple myst" id="dcc-autochat-masks">
<dt><code class="docutils literal notranslate"><span class="pre">dcc_autochat_masks</span></code> <strong><code class="docutils literal notranslate"> </code></strong></dt><dd><p>Set dcc_autochat_masks with user masks to auto-accept chat requests from. When unset, Irssis auto-accept settings work for everyone who tries to DCC chat you. The drawbacks can range from annoying through downright dangerous. Use auto-accept with care.</p>
</dd>
</dl>
<dl class="simple myst" id="dcc-autoget">
<dt><code class="docutils literal notranslate"><span class="pre">dcc_autoget</span></code> <strong><code class="docutils literal notranslate"><span class="pre">OFF</span></code></strong></dt><dd><p>Turn DCC auto-get on or off. When on, Irssi will attempt to auto-get files sent to you.</p>
<p>This feature can be abused, so it is usually off by default. If you enable it, consider also setting dcc_autoget_masks and dcc_autoget_max_size to make this feature more secure.</p>
</dd>
</dl>
<dl class="simple myst" id="dcc-autoget-masks">
<dt><code class="docutils literal notranslate"><span class="pre">dcc_autoget_masks</span></code> <strong><code class="docutils literal notranslate"> </code></strong></dt><dd><p>Set dcc_autoget_masks with user masks to automatically accept files sent to you via DCC. When unset, Irssis auto-get settings will work for everyone who attempts to send you files.</p>
<p>This setting is only significant if dcc_autoget is ON.</p>
</dd>
</dl>
<dl class="simple myst" id="dcc-autoget-max-size">
<dt><code class="docutils literal notranslate"><span class="pre">dcc_autoget_max_size</span></code> <strong><code class="docutils literal notranslate"><span class="pre">0k</span></code></strong></dt><dd><p>Set to nonzero to limit the size of files that Irssi will auto-get.</p>
<p>Note: Because of the way DCC works, someone may advertise a file at once size but try to send you something larger. According to src/irc/dcc/dcc-autoget.c, this only filters the request based on the advertised size.</p>
<p>This setting is only significant if dcc_autoget is ON.</p>
</dd>
</dl>
<dl class="simple myst" id="dcc-autorename">
<dt><code class="docutils literal notranslate"><span class="pre">dcc_autorename</span></code> <strong><code class="docutils literal notranslate"><span class="pre">OFF</span></code></strong></dt><dd><p>Turn on this setting to automatically rename received files so they dont overwrite existing files.</p>
<p>I think this setting may thwart dcc_autoresume, since the auto-resume feature looks for existing filenames when resuming. Auto-renaming downloads makes sure that filenames never conflict, so resuming is not possible.</p>
</dd>
</dl>
<dl class="simple myst" id="dcc-autoresume">
<dt><code class="docutils literal notranslate"><span class="pre">dcc_autoresume</span></code> <strong><code class="docutils literal notranslate"><span class="pre">OFF</span></code></strong></dt><dd><p>When on, dcc_autoresume will cause Irssi to look for existing files with the same name as a new DCC transfer. If a file already exists by that name, Irssi will try to resume the transfer by appending any new data to the existing file.</p>
<p>I think this option clashes with dcc_autorename. See dcc_autorename for more information.</p>
<p>Dcc_autoresume is ignored if dcc_autoget is off.</p>
</dd>
</dl>
<dl class="simple myst" id="dcc-download-path">
<dt><code class="docutils literal notranslate"><span class="pre">dcc_download_path</span></code> <strong><code class="docutils literal notranslate"><span class="pre">~</span></code></strong></dt><dd><p>The path to a directory where Irssi will store DCC downloads.</p>
</dd>
</dl>
<dl class="simple myst" id="dcc-file-create-mode">
<dt><code class="docutils literal notranslate"><span class="pre">dcc_file_create_mode</span></code> <strong><code class="docutils literal notranslate"><span class="pre">644</span></code></strong></dt><dd><p>The mode in which new files are created.</p>
<blockquote>
<div><p>644 is read/write by you, and readable by everybody else.</p>
<p>600 is read/write by you, nobody else can read or write.</p>
</div></blockquote>
</dd>
</dl>
<dl class="simple myst" id="dcc-mirc-ctcp">
<dt><code class="docutils literal notranslate"><span class="pre">dcc_mirc_ctcp</span></code> <strong><code class="docutils literal notranslate"><span class="pre">OFF</span></code></strong></dt><dd><p>Tells Irssi to send CTCP messages that are compatible with mIRC clients. This lets you use /me actions in DCC chats with mIRC users, among other things.</p>
</dd>
</dl>
<dl class="simple myst" id="dcc-own-ip">
<dt><code class="docutils literal notranslate"><span class="pre">dcc_own_ip</span></code> <strong><code class="docutils literal notranslate"> </code></strong></dt><dd><p>Set dcc_own_ip to force Irssi to always send DCC requests from a particular virtual host (vhost). Irssi will always bind sockets to this address when answering DCC requests. Otherwise Irssi will determine your IP address on its own.</p>
</dd>
</dl>
<dl class="simple myst" id="dcc-port">
<dt><code class="docutils literal notranslate"><span class="pre">dcc_port</span></code> <strong><code class="docutils literal notranslate"><span class="pre">0</span></code></strong></dt><dd><p>The smallest port number that Irssi will use when initiating DCC requests. Irssi picks a port at random when this is set to zero.</p>
<p>dcc_port can be two ports, separated by a space. In that case, Irssi will pick a port between the two numbers, inclusively. For example:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>/set dcc_port 10000 20000
</pre></div>
</div>
</dd>
</dl>
<dl class="simple myst" id="dcc-send-replace-space-with-underscore">
<dt><code class="docutils literal notranslate"><span class="pre">dcc_send_replace_space_with_underscore</span></code> <strong><code class="docutils literal notranslate"><span class="pre">OFF</span></code></strong></dt><dd><p>When enabled, Irssi will replace spaces with underscores in the names of files you send. It should only be necessary when sending files to clients that dont support quoted filenames, or if you hate spaces in filenames.</p>
</dd>
</dl>
<dl class="simple myst" id="dcc-timeout">
<dt><code class="docutils literal notranslate"><span class="pre">dcc_timeout</span></code> <strong><code class="docutils literal notranslate"><span class="pre">5min</span></code></strong></dt><dd><p>How long to keep track of pending DCC requests. Requests that do not receive responses within this time will be automatically canceled.</p>
</dd>
</dl>
<dl class="simple myst" id="dcc-upload-path">
<dt><code class="docutils literal notranslate"><span class="pre">dcc_upload_path</span></code> <strong><code class="docutils literal notranslate"><span class="pre">~</span></code></strong></dt><dd><p>The path where you keep public files available to send via DCC.</p>
</dd>
</dl>
</section>
<section id="flood">
<h2>[flood]<a class="headerlink" href="#flood" title="Permalink to this headline"> </a></h2>
<dl class="simple myst" id="autoignore-time">
<dt><code class="docutils literal notranslate"><span class="pre">autoignore_time</span></code> <strong><code class="docutils literal notranslate"><span class="pre">5min</span></code></strong></dt><dd><p>Irssi can auto-ignore people who are flooding. autoignore_time sets the amount of time to keep someone ignored. Irssi will automatically unignore them after this period of time has elapsed.</p>
</dd>
</dl>
<dl class="simple myst" id="autoignore-level">
<dt><code class="docutils literal notranslate"><span class="pre">autoignore_level</span></code> <strong><code class="docutils literal notranslate"> </code></strong></dt><dd><p>The type or types of messages that will trigger auto-ignore.</p>
</dd>
</dl>
<p id="flood-max-msgs"><code class="docutils literal notranslate"><span class="pre">flood_max_msgs</span></code> <strong><code class="docutils literal notranslate"><span class="pre">4</span></code></strong></p>
<dl class="simple myst" id="flood-timecheck">
<dt><code class="docutils literal notranslate"><span class="pre">flood_timecheck</span></code> <strong><code class="docutils literal notranslate"><span class="pre">8</span></code></strong></dt><dd><p>Irssi will treat text as flooding if more than flood_max_msgs messages are received during flood_timecheck seconds. In the case above, five or more messages matching autoignore_level over the course of eight seconds will trigger flood protection. See autoignore_time to set the amount of time someone will remain ignored if its determined that theyre flooding.</p>
</dd>
</dl>
<dl class="simple myst" id="cmds-max-at-once">
<dt><code class="docutils literal notranslate"><span class="pre">cmds_max_at_once</span></code> <strong><code class="docutils literal notranslate"><span class="pre">5</span></code></strong></dt><dd><p>How many commands you can send immediately before server-side flood protection starts.</p>
<p>IRC servers also perform flood checking, and they will gleefully disconnect you if you are abusing them. The cmds_max_at_once setting lets Irssi know how many rapid messages it can get away with while remaining under the IRC servers radar.</p>
</dd>
</dl>
<dl class="simple myst" id="cmd-queue-speed">
<dt><code class="docutils literal notranslate"><span class="pre">cmd_queue_speed</span></code> <strong><code class="docutils literal notranslate"><span class="pre">2200msec</span></code></strong></dt><dd><p>The time to wait between sending commands to an IRC server. Used to prevent Irssi from flooding you off if you must auto-kick/ban lots of people at once.</p>
</dd>
</dl>
<dl class="simple myst" id="max-ctcp-queue">
<dt><code class="docutils literal notranslate"><span class="pre">max_ctcp_queue</span></code> <strong><code class="docutils literal notranslate"><span class="pre">5</span></code></strong></dt><dd><p>The maximum number of pending CTCP requests to keep. Requests beyond max_ctcp_queue will be discarded.</p>
</dd>
</dl>
</section>
<section id="history">
<h2>[history]<a class="headerlink" href="#history" title="Permalink to this headline"> </a></h2>
<dl class="simple myst" id="max-command-history">
<dt><code class="docutils literal notranslate"><span class="pre">max_command_history</span></code> <strong><code class="docutils literal notranslate"><span class="pre">100</span></code></strong></dt><dd><p>The number of lines of your own input to keep for recall.</p>
</dd>
</dl>
<dl class="simple myst" id="rawlog-lines">
<dt><code class="docutils literal notranslate"><span class="pre">rawlog_lines</span></code> <strong><code class="docutils literal notranslate"><span class="pre">200</span></code></strong></dt><dd><p>Irssis raw log is a buffer of raw IRC messages. Its used for debugging Irssi and maybe some other things. This setting tells Irssi how many raw messages to keep around.</p>
</dd>
</dl>
<dl class="simple myst" id="scroll-page-count">
<dt><code class="docutils literal notranslate"><span class="pre">scroll_page_count</span></code> <strong><code class="docutils literal notranslate"><span class="pre">/2</span></code></strong></dt><dd><p>How many pages to scroll the scrollback buffer when pressing page-up or page-down. Expressed as a number of lines, or as a fraction of the screen:</p>
<dl class="simple myst">
<dt>/2</dt><dd><p>Scroll half a page.</p>
</dd>
<dt>.33</dt><dd><p>Scroll about a third of a page.</p>
</dd>
<dt>4</dt><dd><p>Scroll four lines.</p>
</dd>
</dl>
</dd>
</dl>
<dl class="simple myst" id="scrollback-burst-remove">
<dt><code class="docutils literal notranslate"><span class="pre">scrollback_burst_remove</span></code> <strong><code class="docutils literal notranslate"><span class="pre">10</span></code></strong></dt><dd><p>This is a speed optimization: Dont bother removing messages from the scrollback buffer until the line limit has been exceeded by scrollback_burst_remove lines. This lets Irssi do its memory management in chunks rather than one line at a time.</p>
</dd>
</dl>
<dl class="simple myst" id="scrollback-lines">
<dt><code class="docutils literal notranslate"><span class="pre">scrollback_lines</span></code> <strong><code class="docutils literal notranslate"><span class="pre">500</span></code></strong></dt><dd><p>The maximum number of messages to keep in your scrollback history. Set to 0 if you dont want to limit scrollback by a line count. The scrollback_time setting will be used even if scrollback_lines is zero.</p>
<p>Setting scrollback_lines to zero also seems to thwart the scrollback_burst_remove optimization.</p>
</dd>
</dl>
<dl class="simple myst" id="scrollback-time">
<dt><code class="docutils literal notranslate"><span class="pre">scrollback_time</span></code> <strong><code class="docutils literal notranslate"><span class="pre">1day</span></code></strong></dt><dd><p>Keep at least scrollback_time worth of messages in the scrollback buffer, even if it means having more than scrollback_lines lines in the buffer.
Valid formats for the setting are:</p>
<blockquote>
<div><p>day/hour/minute/min/second/sec/millisecond/millisec/msecond/msec</p>
</div></blockquote>
<p>and the plural forms of the above: days, hours etc</p>
<p>The maximum value is 24 days</p>
</dd>
</dl>
<dl class="simple myst" id="scrollback-max-age">
<dt><code class="docutils literal notranslate"><span class="pre">scrollback_max_age</span></code> <strong><code class="docutils literal notranslate"><span class="pre">0</span></code></strong></dt><dd><p>Delete messages older than the given time in each scrollback buffer. The given time has the same format as the scrollback_time setting. Note: messages can only be deleted when there is activity in a buffer. Thus, “day changed” messages will trigger deletion in inactive buffers.</p>
<p>Currently, the oldest time you can set is 24days.</p>
<p>Added in Irssi 1.3</p>
</dd>
</dl>
<dl class="simple myst" id="window-history">
<dt><code class="docutils literal notranslate"><span class="pre">window_history</span></code> <strong><code class="docutils literal notranslate"><span class="pre">OFF</span></code></strong></dt><dd><p>When turned ON, command history will be kept per-window. When off, Irssi uses a single command history for all windows.</p>
</dd>
</dl>
</section>
<section id="log">
<h2>[log]<a class="headerlink" href="#log" title="Permalink to this headline"> </a></h2>
<dl class="simple myst" id="autolog">
<dt><code class="docutils literal notranslate"><span class="pre">autolog</span></code> <strong><code class="docutils literal notranslate"><span class="pre">OFF</span></code></strong></dt><dd><p>Automatically log everything, or at least the types of messages defined by autolog_level.</p>
</dd>
</dl>
<dl class="simple myst" id="autolog-colors">
<dt><code class="docutils literal notranslate"><span class="pre">autolog_colors</span></code> <strong><code class="docutils literal notranslate"><span class="pre">OFF</span></code></strong></dt><dd><p>Whether to save colors in autologs. Colors make logs harder to parse and grep, but they may be vital for channels that deal heavily in ANSI art, or something.</p>
</dd>
</dl>
<dl class="simple myst" id="autolog-ignore-targets">
<dt><code class="docutils literal notranslate"><span class="pre">autolog_ignore_targets</span></code> <strong><code class="docutils literal notranslate"> </code></strong></dt><dd><p>A space separated list of targets to exclude from autologging</p>
<p>See <code class="docutils literal notranslate"><span class="pre">activity_hide_targets</span></code> for additional ways to specify targets in Irssi 1.0.0+.</p>
<p>Added in Irssi 0.8.13</p>
</dd>
</dl>
<dl class="simple myst" id="autolog-level">
<dt><code class="docutils literal notranslate"><span class="pre">autolog_level</span></code> <strong><code class="docutils literal notranslate"><span class="pre">all</span> <span class="pre">-crap</span> <span class="pre">-clientcrap</span> <span class="pre">-ctcps</span></code></strong></dt><dd><p>The types of messages to auto-log. See the autolog setting.</p>
</dd>
</dl>
<dl class="simple myst" id="autolog-path">
<dt><code class="docutils literal notranslate"><span class="pre">autolog_path</span></code> <strong><code class="docutils literal notranslate"><span class="pre">~/irclogs/$tag/$0.log</span></code></strong></dt><dd><p>The path where autolog saves logs.</p>
<p>$0 is the target (channel or query name usually)<br/>
$1 is the server tag (same as $tag)</p>
<p>See Appendix B for Irssis special variables. Irssis special variables can be used to do fancy things like daily log rotations.</p>
</dd>
</dl>
<dl class="simple myst" id="autolog-only-saved-channels">
<dt><code class="docutils literal notranslate"><span class="pre">autolog_only_saved_channels</span></code> <strong><code class="docutils literal notranslate"><span class="pre">OFF</span></code></strong></dt><dd><p>Only autolog channels that are added in /channel list</p>
<p>Added in Irssi 1.2.0</p>
</dd>
</dl>
<dl class="simple myst" id="awaylog-colors">
<dt><code class="docutils literal notranslate"><span class="pre">awaylog_colors</span></code> <strong><code class="docutils literal notranslate"><span class="pre">ON</span></code></strong></dt><dd><p>Whether to store color information in /away logs.</p>
</dd>
</dl>
<dl class="simple myst" id="awaylog-file">
<dt><code class="docutils literal notranslate"><span class="pre">awaylog_file</span></code> <strong><code class="docutils literal notranslate"><span class="pre">~/.irssi/away.log</span></code></strong></dt><dd><p>Where to log messages while youre away.</p>
<p>I assume Irssis special variables also work here. See Appendix B for more information about them.</p>
</dd>
</dl>
<dl class="simple myst" id="awaylog-level">
<dt><code class="docutils literal notranslate"><span class="pre">awaylog_level</span></code> <strong><code class="docutils literal notranslate"><span class="pre">msgs</span> <span class="pre">hilight</span></code></strong></dt><dd><p>The types of messages to log to awaylog_file while youre away.</p>
</dd>
</dl>
<dl class="simple myst" id="log-close-string">
<dt><code class="docutils literal notranslate"><span class="pre">log_close_string</span></code> <strong><code class="docutils literal notranslate"><span class="pre">---</span> <span class="pre">Log</span> <span class="pre">closed</span> <span class="pre">%a</span> <span class="pre">%b</span> <span class="pre">%d</span> <span class="pre">%H:%M:%S</span> <span class="pre">%Y</span></code></strong></dt><dd><p>The message to log when logs are closed.</p>
<p>See Appendix C for the meanings of Irssis time format codes.</p>
</dd>
</dl>
<dl class="simple myst" id="log-create-mode">
<dt><code class="docutils literal notranslate"><span class="pre">log_create_mode</span></code> <strong><code class="docutils literal notranslate"><span class="pre">600</span></code></strong></dt><dd><p>The permissions to use when creating log files.</p>
<p>600 is read/write by you, but nobody else can see them. A sensible default mode. It can also be set to 644 if you want the rest of the world to read your logs.</p>
</dd>
</dl>
<dl class="simple myst" id="log-day-changed">
<dt><code class="docutils literal notranslate"><span class="pre">log_day_changed</span></code> <strong><code class="docutils literal notranslate"><span class="pre">---</span> <span class="pre">Day</span> <span class="pre">changed</span> <span class="pre">%a</span> <span class="pre">%b</span> <span class="pre">%d</span> <span class="pre">%Y</span></code></strong></dt><dd><p>The message to log when a new day begins.</p>
<p>See Appendix C for the meanings of Irssis time format codes.</p>
</dd>
</dl>
<dl class="simple myst" id="log-open-string">
<dt><code class="docutils literal notranslate"><span class="pre">log_open_string</span></code> <strong><code class="docutils literal notranslate"><span class="pre">---</span> <span class="pre">Log</span> <span class="pre">opened</span> <span class="pre">%a</span> <span class="pre">%b</span> <span class="pre">%d</span> <span class="pre">%H:%M:%S</span> <span class="pre">%Y</span></code></strong></dt><dd><p>The message to log when a log is opened.</p>
<p>See Appendix C for the meanings of Irssis time format codes.</p>
</dd>
</dl>
<dl class="simple myst" id="log-theme">
<dt><code class="docutils literal notranslate"><span class="pre">log_theme</span></code> <strong><code class="docutils literal notranslate"> </code></strong></dt><dd><p>Logs can have a different theme than what you see on the screen. This can be used to create machine-parseable versions of logs, for example.</p>
</dd>
</dl>
<dl class="simple myst" id="log-timestamp">
<dt><code class="docutils literal notranslate"><span class="pre">log_timestamp</span></code> <strong><code class="docutils literal notranslate"><span class="pre">%H:%M</span> </code></strong></dt><dd><p>The time format for log timestamps.</p>
<p>See Appendix C for the meanings of Irssis time format codes.</p>
</dd>
</dl>
<dl class="simple myst" id="log-server-time">
<dt><code class="docutils literal notranslate"><span class="pre">log_server_time</span></code> <strong><code class="docutils literal notranslate"><span class="pre">auto</span></code></strong></dt><dd><p>Whether to log the timestamp as sent by the server, or the time when this message was received by Irssi. Also see /SET show_server_time</p>
<dl class="simple myst">
<dt><code class="docutils literal notranslate"><span class="pre">off</span></code></dt><dd><p>log timestamp when received</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">on</span></code></dt><dd><p>log timestamp as provided by server</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">auto</span></code> (default)</dt><dd><p>follow show_server_time setting</p>
</dd>
</dl>
<p>Added in Irssi 1.3</p>
</dd>
</dl>
</section>
<section id="lookandfeel">
<h2>[lookandfeel]<a class="headerlink" href="#lookandfeel" title="Permalink to this headline"> </a></h2>
<dl class="simple myst" id="active-window-ignore-refnum">
<dt><code class="docutils literal notranslate"><span class="pre">active_window_ignore_refnum</span></code> <strong><code class="docutils literal notranslate"><span class="pre">ON</span></code></strong></dt><dd><p>When set ON, the active_window key (meta-a by default) switches to the window with the highest activity level that was last activated.</p>
<p>When set OFF, the pre-0.8.15 behavior is used: it switches to the window with the highest activity level with the lowest refnum.</p>
<p>Added in Irssi 0.8.15</p>
</dd>
</dl>
<dl class="simple myst" id="activity-hide-level">
<dt><code class="docutils literal notranslate"><span class="pre">activity_hide_level</span></code> <strong><code class="docutils literal notranslate"> </code></strong></dt><dd><p>Message levels that dont count towards channel activity. That is, channels wont be marked as active if messages of these types appear.</p>
</dd>
</dl>
<dl class="simple myst" id="activity-hide-targets">
<dt><code class="docutils literal notranslate"><span class="pre">activity_hide_targets</span></code> <strong><code class="docutils literal notranslate"> </code></strong></dt><dd><p>Sometimes you dont care at all about a windows activity. This can be set to a space separated list of windows that will never appear to be active.</p>
<div class="table-wrapper"><table class="colwidths-auto docutils align-default">
<thead>
<tr class="row-odd"><th class="head"><p>Syntax</p></th>
<th class="head"><p>Version added</p></th>
<th class="head"><p>Description</p></th>
</tr>
</thead>
<tbody>
<tr class="row-even"><td><p>exactname</p></td>
<td><p>0.8.0</p></td>
<td><p>Ignore activity in window exactname</p></td>
</tr>
<tr class="row-odd"><td><p>tag/exactname</p></td>
<td><p>0.8.6</p></td>
<td><p>Ignore activity on network tag and window exactname</p></td>
</tr>
<tr class="row-even"><td><p>*</p></td>
<td><p>1.0.0</p></td>
<td><p>Ignore activity in all windows</p></td>
</tr>
<tr class="row-odd"><td><p>tag/*</p></td>
<td><p>1.0.0</p></td>
<td><p>Ignore all activity on network tag</p></td>
</tr>
<tr class="row-even"><td><p>::all</p></td>
<td><p>1.1.0</p></td>
<td><p>Ignore activity in all windows</p></td>
</tr>
<tr class="row-odd"><td><p>::channels</p></td>
<td><p>1.1.0</p></td>
<td><p>Ignore activity in all channels</p></td>
</tr>
<tr class="row-even"><td><p>::queries</p></td>
<td><p>1.1.0</p></td>
<td><p>Ignore activity in all queries</p></td>
</tr>
<tr class="row-odd"><td><p>::dccqueries</p></td>
<td><p>1.1.0</p></td>
<td><p>Ignore activity in all dcc chats</p></td>
</tr>
<tr class="row-even"><td><p>#chan|[=]nick</p></td>
<td><p>1.1.0</p></td>
<td><p>Ignore activity in named target(channel, query, dcc chat)</p></td>
</tr>
<tr class="row-odd"><td><p>tag/::all</p></td>
<td><p>1.1.0</p></td>
<td><p>Ignore all activity on network tag</p></td>
</tr>
<tr class="row-even"><td><p>tag/::channels</p></td>
<td><p>1.1.0</p></td>
<td><p>Ignore activity in all channels on network tag</p></td>
</tr>
<tr class="row-odd"><td><p>tag/::queries</p></td>
<td><p>1.1.0</p></td>
<td><p>Ignore activity in all queries on network tag</p></td>
</tr>
<tr class="row-even"><td><p>tag/::dccqueries</p></td>
<td><p>1.1.0</p></td>
<td><p>Ignore activity in all dcc chats on network tag</p></td>
</tr>
<tr class="row-odd"><td><p>tag/#chan|[=]nick</p></td>
<td><p>1.1.0</p></td>
<td><p>Ignore activity in named channel/query/dcc chat on network tag</p></td>
</tr>
</tbody>
</table></div>
</dd>
</dl>
<dl class="simple myst" id="activity-hilight-level">
<dt><code class="docutils literal notranslate"><span class="pre">activity_hilight_level</span></code> <strong><code class="docutils literal notranslate"><span class="pre">MSGS</span> <span class="pre">DCCMSGS</span></code></strong></dt><dd><p>There are times when you want to highlight channel activity in a window. Like when someone sends you a private message, or a DCC message. activity_hilight_level sets the kind of messages you think are extra important.</p>
</dd>
</dl>
<dl class="simple myst" id="activity-msg-level">
<dt><code class="docutils literal notranslate"><span class="pre">activity_msg_level</span></code> <strong><code class="docutils literal notranslate"><span class="pre">PUBLIC</span></code></strong></dt><dd><p>Flag a channel as active when messages of this type are displayed there.</p>
</dd>
</dl>
<dl class="simple myst" id="activity-hide-window-hidelevel">
<dt><code class="docutils literal notranslate"><span class="pre">activity_hide_window_hidelevel</span></code> <strong><code class="docutils literal notranslate"><span class="pre">ON</span></code></strong></dt><dd><p>Do not flag a window as active if the message is hidden with /window hidelevel</p>
<p>Added in Irssi 1.2.0</p>
</dd>
</dl>
<dl class="simple myst" id="activity-hide-visible">
<dt><code class="docutils literal notranslate"><span class="pre">activity_hide_visible</span></code> <strong><code class="docutils literal notranslate"><span class="pre">ON</span></code></strong></dt><dd><p>Whether to hide the active flag when the window is visible.</p>
<p>Added in Irssi 1.2.0</p>
</dd>
</dl>
<dl class="simple myst" id="actlist-names">
<dt><code class="docutils literal notranslate"><span class="pre">actlist_names</span></code> <strong><code class="docutils literal notranslate"><span class="pre">OFF</span></code></strong></dt><dd><p>Turn on to add active items names in act statusbar item.</p>
</dd>
</dl>
<dl class="simple myst" id="actlist-prefer-window-name">
<dt><code class="docutils literal notranslate"><span class="pre">actlist_prefer_window_name</span></code> <strong><code class="docutils literal notranslate"><span class="pre">OFF</span></code></strong></dt><dd><p>Whether to show the window name instead of the item name when actlist_names is enabled.</p>
<p>Added in Irssi 1.3</p>
</dd>
</dl>
<dl class="simple myst" id="actlist-sort">
<dt><code class="docutils literal notranslate"><span class="pre">actlist_sort</span></code> <strong><code class="docutils literal notranslate"><span class="pre">refnum</span></code></strong></dt><dd><p>Specifies the sorting type used for the activity bar. Accepted values:</p>
<dl class="simple myst">
<dt><code class="docutils literal notranslate"><span class="pre">refnum</span></code> (default)</dt><dd><p>windows are listed in numeric order</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">recent</span></code></dt><dd><p>windows with more recent activity appear first</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">level</span></code></dt><dd><p>sort by window level (hilight, msg, etc), same ordering used by active_window command. Windows with the same level are sorted by refnum.</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">level,recent</span></code></dt><dd><p>same as level, but windows with the same level are sorted by recent.</p>
</dd>
</dl>
<p>Added in Irssi 0.8.12. Before Irssi 0.8.12, a boolean <code class="docutils literal notranslate"><span class="pre">actlist_moves</span></code> setting existed, which was equivalent to setting actlist_sort to refnum.</p>
</dd>
</dl>
<dl class="simple myst" id="actlist-separator">
<dt><code class="docutils literal notranslate"><span class="pre">actlist_separator</span></code> <strong><code class="docutils literal notranslate"><span class="pre">,</span></code></strong></dt><dd><p>Which separator to use between windows in the Act: list.</p>
<p>Added in Irssi 1.4</p>
</dd>
</dl>
<dl class="simple myst" id="autoclose-query">
<dt><code class="docutils literal notranslate"><span class="pre">autoclose_query</span></code> <strong><code class="docutils literal notranslate"><span class="pre">0</span></code></strong></dt><dd><p>Automatically close query windows after autoclose_query seconds of inactivity. Setting autoclose_query to zero will keep them open until you decide to close them yourself.</p>
</dd>
</dl>
<dl class="simple myst" id="autoclose-windows">
<dt><code class="docutils literal notranslate"><span class="pre">autoclose_windows</span></code> <strong><code class="docutils literal notranslate"><span class="pre">ON</span></code></strong></dt><dd><p>Automatically close windows when nobody is in them. This keeps your window list tidy, but it means that query windows may rearrange as people log off then privately message you later.</p>
</dd>
</dl>
<dl class="simple myst" id="autocreate-own-query">
<dt><code class="docutils literal notranslate"><span class="pre">autocreate_own_query</span></code> <strong><code class="docutils literal notranslate"><span class="pre">ON</span></code></strong></dt><dd><p>Turn on to automatically create query windows when you /msg someone.</p>
</dd>
</dl>
<dl class="simple myst" id="autocreate-query-level">
<dt><code class="docutils literal notranslate"><span class="pre">autocreate_query_level</span></code> <strong><code class="docutils literal notranslate"><span class="pre">MSGS</span> <span class="pre">DCCMSGS</span></code></strong></dt><dd><p>Automatically create query windows when receiving these types of messages.</p>
</dd>
</dl>
<dl class="simple myst" id="autocreate-windows">
<dt><code class="docutils literal notranslate"><span class="pre">autocreate_windows</span></code> <strong><code class="docutils literal notranslate"><span class="pre">ON</span></code></strong></dt><dd><p>When on, create new windows for certain operations, such as /join. When off, everything is just dumped into one window.</p>
</dd>
</dl>
<dl class="simple myst" id="autocreate-split-windows">
<dt><code class="docutils literal notranslate"><span class="pre">autocreate_split_windows</span></code> <strong><code class="docutils literal notranslate"><span class="pre">OFF</span></code></strong></dt><dd><p>Automatically created windows will be created as split windows with this setting on.</p>
<p>Split windows are the kind where multiple windows are on one screen.</p>
</dd>
</dl>
<dl class="simple myst" id="autofocus-new-items">
<dt><code class="docutils literal notranslate"><span class="pre">autofocus_new_items</span></code> <strong><code class="docutils literal notranslate"><span class="pre">ON</span></code></strong></dt><dd><p>Switch the focus to a new item when its created. This may be disturbing at first when combined with query window auto-creation, and it may be downright dangerous if it causes you to accidentally misdirect messages.</p>
</dd>
</dl>
<dl class="simple myst" id="autostick-split-windows">
<dt><code class="docutils literal notranslate"><span class="pre">autostick_split_windows</span></code> <strong><code class="docutils literal notranslate"><span class="pre">OFF</span></code></strong></dt><dd><p>Whether creating split windows (or showing windows) will automatically stick them to the split window (/window stick on)</p>
<p>The default was changed to <code class="docutils literal notranslate"><span class="pre">OFF</span></code> in Irssi 1.2.0</p>
</dd>
</dl>
<dl class="simple myst" id="autounstick-windows">
<dt><code class="docutils literal notranslate"><span class="pre">autounstick_windows</span></code> <strong><code class="docutils literal notranslate"><span class="pre">ON</span></code></strong></dt><dd><p>Whether windows should automatically unstick when you try to /window show or /window hide them</p>
<p>Added in Irssi 1.2.0</p>
</dd>
</dl>
<dl class="simple myst" id="beep-msg-level">
<dt><code class="docutils literal notranslate"><span class="pre">beep_msg_level</span></code> <strong><code class="docutils literal notranslate"> </code></strong></dt><dd><p>Beep when messages match this level mask.</p>
</dd>
</dl>
<dl class="simple myst" id="beep-when-away">
<dt><code class="docutils literal notranslate"><span class="pre">beep_when_away</span></code> <strong><code class="docutils literal notranslate"><span class="pre">ON</span></code></strong></dt><dd><p>Should beeps be noisy when youre /away? Great for people who sleep near their terminals or keep Irssi running at work. :)</p>
</dd>
</dl>
<dl class="simple myst" id="beep-when-window-active">
<dt><code class="docutils literal notranslate"><span class="pre">beep_when_window_active</span></code> <strong><code class="docutils literal notranslate"><span class="pre">ON</span></code></strong></dt><dd><p>Should beeps be noisy in a window youre watching? Perhaps not, since you are theoretically watching that window. You ARE watching it, arent you?</p>
</dd>
</dl>
<dl class="simple myst" id="bell-beeps">
<dt><code class="docutils literal notranslate"><span class="pre">bell_beeps</span></code> <strong><code class="docutils literal notranslate"><span class="pre">OFF</span></code></strong></dt><dd><p>Removed in Irssi 1.0.0.</p>
<p>Tell Irssi whether bell characters (chr 7, ^G) included inside IRC messages should actually cause beeps. This doesnt mean that highlights will make a beep sound, this means that anyone in any irc channel can cause unexplained beeps.</p>
<p>Since its only purpose is to be annoying, we decided to remove this. <a class="reference external" href="https://github.com/irssi/irssi/issues/524">See this issue for details</a>.</p>
<p>Any guide that recommended enabling this to make beeps work is wrong. This setting is not needed for that.</p>
</dd>
</dl>
<dl class="simple myst" id="break-wide">
<dt><code class="docutils literal notranslate"><span class="pre">break_wide</span></code> <strong><code class="docutils literal notranslate"><span class="pre">OFF</span></code></strong></dt><dd><p>When on, wide characters (fullwidth / CJK / east asian) are always considered line breaking points then wrapping lines for display, instead of only wrapping on space characters.</p>
<p>Example:</p>
<div class="highlight-ascidia.repl#fig_break_wide notranslate"><div class="highlight"><pre><span></span> ╔═══════════════════════════════════════════════════════════╗
OFF: ║10:31 -!- 火火火火火火火火火火ab ║
║ cd火火火火火火火火火火胡火火火火火后ab ║
║ cd火火火火火火火火火火火 ║
╚═══════════════════════════════════════════════════════════╝
╔═══════════════════════════════════════════════════════════╗
ON: ║10:31 -!- 火火火火火火火火火火ab cd火火火火火火火火火火胡火║
║ 火火火火后ab cd火火火火火火火火火 ║
╚═══════════════════════════════════════════════════════════╝
</pre></div>
</div>
<p>Added in Irssi 1.1.0</p>
</dd>
</dl>
<dl class="simple myst" id="chanmode-expando-strip">
<dt><code class="docutils literal notranslate"><span class="pre">chanmode_expando_strip</span></code> <strong><code class="docutils literal notranslate"><span class="pre">OFF</span></code></strong></dt><dd><p>When on, $M will not return mode parameters.</p>
<p>This means for example that the channel limit and channel key wont be shown in your statusbar (a common place where $M is used) (but also not in all other places that refer to $M for whatever reason).</p>
</dd>
</dl>
<dl class="simple myst" id="colors">
<dt><code class="docutils literal notranslate"><span class="pre">colors</span></code> <strong><code class="docutils literal notranslate"><span class="pre">ON</span></code></strong></dt><dd><p>Enable or disable colors.</p>
</dd>
</dl>
<dl class="simple myst" id="emphasis">
<dt><code class="docutils literal notranslate"><span class="pre">emphasis</span></code> <strong><code class="docutils literal notranslate"><span class="pre">ON</span></code></strong></dt><dd><p>Enable or disable real underlining and bolding when someone says <code class="docutils literal notranslate"><span class="pre">*bold*</span></code> or <code class="docutils literal notranslate"><span class="pre">_underlined_</span></code>.</p>
</dd>
</dl>
<dl class="simple myst" id="emphasis-italics">
<dt><code class="docutils literal notranslate"><span class="pre">emphasis_italics</span></code> <strong><code class="docutils literal notranslate"><span class="pre">OFF</span></code></strong></dt><dd><p>Enable or disable applying real italics when someone says <code class="docutils literal notranslate"><span class="pre">/italics/</span></code>.</p>
<p>Note: not all terminals support this. Most notably, if the TERM environment variable is set to screen, it wont work.</p>
<p>Added in Irssi 0.8.17</p>
</dd>
</dl>
<dl class="simple myst" id="emphasis-multiword">
<dt><code class="docutils literal notranslate"><span class="pre">emphasis_multiword</span></code> <strong><code class="docutils literal notranslate"><span class="pre">OFF</span></code></strong></dt><dd><p>Turn on to allow <code class="docutils literal notranslate"><span class="pre">*more</span> <span class="pre">than</span> <span class="pre">one</span> <span class="pre">word</span> <span class="pre">bold*</span></code> and <code class="docutils literal notranslate"><span class="pre">_multiple</span> <span class="pre">underlined</span> <span class="pre">words_</span></code>. Used in conjunction with the emphasis setting.</p>
</dd>
</dl>
<dl class="simple myst" id="emphasis-replace">
<dt><code class="docutils literal notranslate"><span class="pre">emphasis_replace</span></code> <strong><code class="docutils literal notranslate"><span class="pre">OFF</span></code></strong></dt><dd><p>If emphasis is turned on, the <code class="docutils literal notranslate"><span class="pre">*</span></code> or <code class="docutils literal notranslate"><span class="pre">_</span></code> characters indicating emphasis will be removed when the word is made bold or underlined. Some people find this looks cleaner.</p>
<p>See the emphasis setting for more information.</p>
</dd>
</dl>
<dl class="simple myst" id="expand-escapes">
<dt><code class="docutils literal notranslate"><span class="pre">expand_escapes</span></code> <strong><code class="docutils literal notranslate"><span class="pre">OFF</span></code></strong></dt><dd><p>Detect escapes in input, and expand them to the characters they describe. For example</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>\t
</pre></div>
</div>
<p>Is literally ' and t when expand_escapes is off, but its the tab character (chr 9) when expand_escapes is on.</p>
</dd>
</dl>
<dl class="simple myst" id="hide-colors">
<dt><code class="docutils literal notranslate"><span class="pre">hide_colors</span></code> <strong><code class="docutils literal notranslate"><span class="pre">OFF</span></code></strong></dt><dd><p>Hide mIRC and ANSI colors when turned on. This can be used to eliminate angry fruit salad syndrome in some channels.</p>
</dd>
</dl>
<dl class="simple myst" id="hide-server-tags">
<dt><code class="docutils literal notranslate"><span class="pre">hide_server_tags</span></code> <strong><code class="docutils literal notranslate"><span class="pre">OFF</span></code></strong></dt><dd><p>Server tags are prefixes to some messages (server messages?) that let you know which server the message came from. Theyre often considered noisy, so this option lets you hide them.</p>
</dd>
</dl>
<dl class="simple myst" id="hide-text-style">
<dt><code class="docutils literal notranslate"><span class="pre">hide_text_style</span></code> <strong><code class="docutils literal notranslate"><span class="pre">OFF</span></code></strong></dt><dd><p>Hide bold, blink, underline, and reverse attributes.</p>
</dd>
</dl>
<dl class="simple myst" id="hilight-act-color">
<dt><code class="docutils literal notranslate"><span class="pre">hilight_act_color</span></code> <strong><code class="docutils literal notranslate"><span class="pre">%M</span></code></strong></dt><dd><p>The color to use to highlight window activity in the status bar. Thats the section that shows [Act: …].</p>
<p>See Appendix D for Irssis color codes.</p>
</dd>
</dl>
<dl class="simple myst" id="hilight-color">
<dt><code class="docutils literal notranslate"><span class="pre">hilight_color</span></code> <strong><code class="docutils literal notranslate"><span class="pre">%Y</span></code></strong></dt><dd><p>The default color for /hilight.</p>
<p>See Appendix D for Irssis color codes.</p>
</dd>
</dl>
<dl class="simple myst" id="hilight-level">
<dt><code class="docutils literal notranslate"><span class="pre">hilight_level</span></code> <strong><code class="docutils literal notranslate"><span class="pre">PUBLIC</span> <span class="pre">DCCMSGS</span></code></strong></dt><dd><p>The types of messages that can be highlighted.</p>
</dd>
</dl>
<dl class="simple myst" id="hilight-nick-matches">
<dt><code class="docutils literal notranslate"><span class="pre">hilight_nick_matches</span></code> <strong><code class="docutils literal notranslate"><span class="pre">ON</span></code></strong></dt><dd><p>Tell Irssi whether it should automatically highlight text that starts with your nickname.</p>
</dd>
</dl>
<dl class="simple myst" id="hilight-nick-matches-everywhere">
<dt><code class="docutils literal notranslate"><span class="pre">hilight_nick_matches_everywhere</span></code> <strong><code class="docutils literal notranslate"><span class="pre">OFF</span></code></strong></dt><dd><p>Turn on to extend hilight_nick_matches to match your nickname everywhere in messages, not just at the beginning.</p>
<p>Added in Irssi 0.8.18</p>
</dd>
</dl>
<dl class="simple myst" id="indent">
<dt><code class="docutils literal notranslate"><span class="pre">indent</span></code> <strong><code class="docutils literal notranslate"><span class="pre">10</span></code></strong></dt><dd><p>How many columns to indent subsequent lines of a wrapped message.</p>
<p>Attention: This can be overwritten by themes.</p>
</dd>
</dl>
<dl class="simple myst" id="indent-always">
<dt><code class="docutils literal notranslate"><span class="pre">indent_always</span></code> <strong><code class="docutils literal notranslate"><span class="pre">OFF</span></code></strong></dt><dd><p>Should we indent the long words that are forcibly wrapped to the next line? This can break long words such as URLs by inserting spaces in the middle of them.</p>
<p>Turn off if you would like to copy/paste or otherwise use URLs from your terminal.</p>
</dd>
</dl>
<dl class="simple myst" id="mirc-blink-fix">
<dt><code class="docutils literal notranslate"><span class="pre">mirc_blink_fix</span></code> <strong><code class="docutils literal notranslate"><span class="pre">OFF</span></code></strong></dt><dd><p>Some terminals interpret bright background colors as blinking text. mIRC doesnt support blinking at all. This fixes the blinky terminals by replacing high colors with their low equivalents.</p>
<p>From Irssis ChangeLog:</p>
<blockquote>
<div><p>/SET mirc_blink_fix - if ON, the bright/blink bit is stripped
from MIRC colors. Set this to ON, if your terminal shows bright
background colors as blinking.</p>
</div></blockquote>
</dd>
</dl>
<dl class="simple myst" id="colors-ansi-24bit">
<dt><code class="docutils literal notranslate"><span class="pre">colors_ansi_24bit</span></code> <strong><code class="docutils literal notranslate"><span class="pre">OFF</span></code></strong></dt><dd><p>Enable the use of 24-bit color codes.</p>
<p>Note: not all terminals support this. If yours does not, it may result in horrible screen distortion.</p>
<p>Irssi up to 1.3 need to be compiled with <code class="docutils literal notranslate"><span class="pre">-Denable-true-color=yes</span></code>.</p>
<p>Added in Irssi 0.8.17</p>
</dd>
</dl>
<dl class="simple myst" id="names-max-columns">
<dt><code class="docutils literal notranslate"><span class="pre">names_max_columns</span></code> <strong><code class="docutils literal notranslate"><span class="pre">6</span></code></strong></dt><dd><p>Maximum number of columns to use for /names listing. Also shown on channel join. Set to 0 for as many as fit in your terminal.</p>
</dd>
</dl>
<dl class="simple myst" id="names-max-width">
<dt><code class="docutils literal notranslate"><span class="pre">names_max_width</span></code> <strong><code class="docutils literal notranslate"><span class="pre">0</span></code></strong></dt><dd><p>Maximum number of columns to consume with a /names listing. Overrides names_max_columns if non-zero. Set to 0 for as many as fit in your terminal.</p>
</dd>
</dl>
<dl class="simple myst" id="print-active-channel">
<dt><code class="docutils literal notranslate"><span class="pre">print_active_channel</span></code> <strong><code class="docutils literal notranslate"><span class="pre">OFF</span></code></strong></dt><dd><p>Always print the channel with the nickname (like nick:channel) even if the message is from the channel you currently have active.</p>
</dd>
</dl>
<dl class="simple myst" id="query-track-nick-changes">
<dt><code class="docutils literal notranslate"><span class="pre">query_track_nick_changes</span></code> <strong><code class="docutils literal notranslate"><span class="pre">ON</span></code></strong></dt><dd><p>Query windows will track nick changes when this is on. That is, when receiving a message from an unknown nick, it looks for a query with a matching user@host before creating a new one, and if it finds one, it gets renamed to use the new nick.</p>
</dd>
</dl>
<dl class="simple myst" id="reuse-unused-windows">
<dt><code class="docutils literal notranslate"><span class="pre">reuse_unused_windows</span></code> <strong><code class="docutils literal notranslate"><span class="pre">OFF</span></code></strong></dt><dd><p>When set on, Irssi will reuse unused windows when looking for a new window to put something in. Otherwise unused windows are ignored, and new ones are always created.</p>
</dd>
</dl>
<dl class="simple myst" id="scroll">
<dt><code class="docutils literal notranslate"><span class="pre">scroll</span></code> <strong><code class="docutils literal notranslate"><span class="pre">ON</span></code></strong></dt><dd><p>Set scroll ON to have Irssi scroll your screen when it fills up. Set it OFF to require manual scrolling.</p>
<p>Warning: If set to OFF, this will stop scrolling in all windows and not reenable scrolling even if you set it back to ON. (You need to manually scroll to the bottom in each window first.)</p>
</dd>
</dl>
<dl class="simple myst" id="show-away-once">
<dt><code class="docutils literal notranslate"><span class="pre">show_away_once</span></code> <strong><code class="docutils literal notranslate"><span class="pre">ON</span></code></strong></dt><dd><p>When on, only show /away messages in the window thats currently open. Otherwise the message will appear in every window you share with the away person.</p>
</dd>
</dl>
<dl class="simple myst" id="away-notify-public">
<dt><code class="docutils literal notranslate"><span class="pre">away_notify_public</span></code> <strong><code class="docutils literal notranslate"><span class="pre">OFF</span></code></strong></dt><dd><p>Whether to show /away changes of other users in the channel. Only affects servers that actively inform about away changes.</p>
<p>Added in Irssi 1.3</p>
</dd>
</dl>
<dl class="simple myst" id="show-names-on-join">
<dt><code class="docutils literal notranslate"><span class="pre">show_names_on_join</span></code> <strong><code class="docutils literal notranslate"><span class="pre">ON</span></code></strong></dt><dd><p>Display the list of names in a channel when you join that channel. Its generally recommended, but you can disable it for pathologically huge channels or in case you just dont care. Also see show_names_on_join_limit, which overrules this setting.</p>
</dd>
</dl>
<dl class="simple myst" id="show-names-on-join-limit">
<dt><code class="docutils literal notranslate"><span class="pre">show_names_on_join_limit</span></code> <strong><code class="docutils literal notranslate"><span class="pre">18</span></code></strong></dt><dd><p>Do not show the NAMES list on join if there are more than show_names_on_join_limit users in the channel.</p>
<p>Added in Irssi 1.3</p>
</dd>
</dl>
<dl class="simple myst" id="show-extended-join">
<dt><code class="docutils literal notranslate"><span class="pre">show_extended_join</span></code> <strong><code class="docutils literal notranslate"><span class="pre">OFF</span></code></strong></dt><dd><p>Whether to show extended join information (real name and services account) when others users join the channel. Only affects servers that send extended joins information.</p>
<p>Added in Irssi 1.3</p>
</dd>
</dl>
<dl class="simple myst" id="show-nickmode">
<dt><code class="docutils literal notranslate"><span class="pre">show_nickmode</span></code> <strong><code class="docutils literal notranslate"><span class="pre">ON</span></code></strong></dt><dd><p>Prefix nicknames with their channel status:</p>
<dl class="simple myst">
<dt>voiced</dt><dd><p><code class="docutils literal notranslate"><span class="pre">+</span></code></p>
</dd>
<dt>half-op</dt><dd><p><code class="docutils literal notranslate"><span class="pre">%</span></code></p>
</dd>
<dt>op</dt><dd><p><code class="docutils literal notranslate"><span class="pre">@</span></code></p>
</dd>
</dl>
</dd>
</dl>
<dl class="simple myst" id="show-nickmode-empty">
<dt><code class="docutils literal notranslate"><span class="pre">show_nickmode_empty</span></code> <strong><code class="docutils literal notranslate"><span class="pre">ON</span></code></strong></dt><dd><p>If a person has no channel modes, prefix their nickname with a blank space. This keeps nicknames of normal people aligned with those of voiced, half-opped, and opped people.</p>
</dd>
</dl>
<dl class="simple myst" id="show-account-notify">
<dt><code class="docutils literal notranslate"><span class="pre">show_account_notify</span></code> <strong><code class="docutils literal notranslate"><span class="pre">OFF</span></code></strong></dt><dd><p>Whether to show account changes of other users in the channel. Only affects servers that actively inform about account changes.</p>
<p>Added in Irssi 1.3</p>
</dd>
</dl>
<dl class="simple myst" id="show-own-nickchange-once">
<dt><code class="docutils literal notranslate"><span class="pre">show_own_nickchange_once</span></code> <strong><code class="docutils literal notranslate"><span class="pre">OFF</span></code></strong></dt><dd><p>Squash your own nick-change messages so they appear only once, not once in every window you have on that network.</p>
</dd>
</dl>
<dl class="simple myst" id="show-quit-once">
<dt><code class="docutils literal notranslate"><span class="pre">show_quit_once</span></code> <strong><code class="docutils literal notranslate"><span class="pre">OFF</span></code></strong></dt><dd><p>When turned on, a quit message will only be shown once. Otherwise it will be displayed in every window you share with the quitter.</p>
</dd>
</dl>
<dl class="simple myst" id="show-server-time">
<dt><code class="docutils literal notranslate"><span class="pre">show_server_time</span></code> <strong><code class="docutils literal notranslate"><span class="pre">OFF</span></code></strong></dt><dd><p>Whether to show the server-provided time on messages when available, or only the local time of reception.</p>
<p>Added in Irssi 1.3</p>
</dd>
</dl>
<dl class="simple myst" id="term-appkey-mode">
<dt><code class="docutils literal notranslate"><span class="pre">term_appkey_mode</span></code> <strong><code class="docutils literal notranslate"><span class="pre">ON</span></code></strong></dt><dd><p>If this is ON, the application keys mode is used, which is needed for some terminals.</p>
<p>Turn this off if your terminal doesnt need this mode and you need to bind meta-O (thats an uppercase O)</p>
<p>Added in Irssi 0.8.19</p>
</dd>
</dl>
<dl class="simple myst" id="term-charset">
<dt><code class="docutils literal notranslate"><span class="pre">term_charset</span></code> <strong><code class="docutils literal notranslate"><span class="pre">UTF-8</span></code></strong></dt><dd><p>Sets your native terminal character set. Irssi will take this into consideration when it needs to delete multibyte characters, for example.</p>
<p>A common value is utf-8 for Unicode/UTF-8 enabled terminals.</p>
<p>TODO - Does this still support Chinese terminal emulators? (Used to be term_type big5 in old Irssi.)</p>
</dd>
</dl>
<dl class="simple myst" id="term-force-colors">
<dt><code class="docutils literal notranslate"><span class="pre">term_force_colors</span></code> <strong><code class="docutils literal notranslate"><span class="pre">OFF</span></code></strong></dt><dd><p>Always display colors, even when the terminal type says colors arent supported. Useful for working around really dumb terminals.</p>
</dd>
</dl>
<dl class="simple myst" id="theme">
<dt><code class="docutils literal notranslate"><span class="pre">theme</span></code> <strong><code class="docutils literal notranslate"><span class="pre">default</span></code></strong></dt><dd><p>Irssi supports themes that can change most of the clients look and feel. This setting lets you name the theme you wish to use.</p>
</dd>
</dl>
<dl class="simple myst" id="timestamp-format">
<dt><code class="docutils literal notranslate"><span class="pre">timestamp_format</span></code> <strong><code class="docutils literal notranslate"><span class="pre">%H:%M</span></code></strong></dt><dd><p>How to format the time used in timestamps.</p>
<p>See Appendix C for the meanings of Irssis time format codes.</p>
</dd>
</dl>
<dl class="simple myst" id="timestamp-format-alt">
<dt><code class="docutils literal notranslate"><span class="pre">timestamp_format_alt</span></code> <strong><code class="docutils literal notranslate"><span class="pre">%a</span> <span class="pre">%e</span> <span class="pre">%b</span> <span class="pre">%H:%M</span></code></strong></dt><dd><p>How to format messages with an old timestamp, for example messages from the past emitted by the server.</p>
<p>Added in Irssi 1.3</p>
</dd>
</dl>
<dl class="simple myst" id="timestamp-level">
<dt><code class="docutils literal notranslate"><span class="pre">timestamp_level</span></code> <strong><code class="docutils literal notranslate"><span class="pre">ALL</span></code></strong></dt><dd><p>Types of messages to prefix a timestamp to. Useful for explicit or automatic timestamps.</p>
<p>Once timestamping is temporarily turned on, it may stay on for timestamp_timeout seconds.</p>
</dd>
</dl>
<dl class="simple myst" id="timestamp-timeout">
<dt><code class="docutils literal notranslate"><span class="pre">timestamp_timeout</span></code> <strong><code class="docutils literal notranslate"><span class="pre">0</span></code></strong></dt><dd><p>The amount of time to leave timestamps on after a timestamp_level message triggered timestamping. Useful for people who think timestamps are noisy but would like timestamps for important conversations.</p>
</dd>
</dl>
<dl class="simple myst" id="timestamps">
<dt><code class="docutils literal notranslate"><span class="pre">timestamps</span></code> <strong><code class="docutils literal notranslate"><span class="pre">ON</span></code></strong></dt><dd><p>Turn timestamps on or off. When off, not even timestamp_level will trigger them.</p>
</dd>
</dl>
<dl class="simple myst" id="tls-verbose-connect">
<dt><code class="docutils literal notranslate"><span class="pre">tls_verbose_connect</span></code> <strong><code class="docutils literal notranslate"><span class="pre">ON</span></code></strong></dt><dd><p>When this setting is ON, Irssi displays TLS connection information on connect, which includes the certificate chain, protocol version, cipher suite and fingerprints. Example:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>-!- Irssi: Connecting to irc.example.net [198.51.100.1] port 6697
-!- Irssi: Certificate Chain:
-!- Irssi: Subject: CN: irc.example.net
-!- Irssi: Issuer: C: US, O: Let's Encrypt, CN: Let's Encrypt Authority X3
-!- Irssi: Subject: C: US, O: Let's Encrypt, CN: Let's Encrypt Authority X3
-!- Irssi: Issuer: O: Digital Signature Trust Co., CN: DST Root CA X3
-!- Irssi: Protocol: TLSv1.2 (256 bit, DHE-RSA-AES256-GCM-SHA384)
-!- Irssi: EDH Key: 2048 bit DH
-!- Irssi: Public Key: 4096 bit RSA, valid from Mar 20 05:16:00 2017 GMT to Jun 18 05:16:00 2017 GMT
-!- Irssi: Public Key Fingerprint: DE:AD:BE:EF:DE:AD:BE:EF:DE:AD:BE:EF:DE:AD:BE:EF:DE:AD:BE:EF:DE:AD:BE:EF:DE:AD:BE:EF:DE:AD:BE:EF (SHA256)
-!- Irssi: Certificate Fingerprint: CA:FE:BA:BE:CA:FE:BA:BE:CA:FE:BA:BE:CA:FE:BA:BE:CA:FE:BA:BE:CA:FE:BA:BE:CA:FE:BA:BE:CA:FE:BA:BE (SHA256)
</pre></div>
</div>
<p>Added in Irssi 1.0.0</p>
</dd>
</dl>
<dl class="simple myst" id="use-msgs-window">
<dt><code class="docutils literal notranslate"><span class="pre">use_msgs_window</span></code> <strong><code class="docutils literal notranslate"><span class="pre">OFF</span></code></strong></dt><dd><p>Use a single window for all private messages. This setting only makes sense if automatic query windows is turned off.</p>
</dd>
</dl>
<dl class="simple myst" id="use-status-window">
<dt><code class="docutils literal notranslate"><span class="pre">use_status_window</span></code> <strong><code class="docutils literal notranslate"><span class="pre">ON</span></code></strong></dt><dd><p>Create a separate window for all server status messages, so they dont clutter up your channels.</p>
</dd>
</dl>
<dl class="simple myst" id="whois-hide-safe-channel-id">
<dt><code class="docutils literal notranslate"><span class="pre">whois_hide_safe_channel_id</span></code> <strong><code class="docutils literal notranslate"><span class="pre">ON</span></code></strong></dt><dd><p>Hides the unique id of !channels in /whois output (IRCNet/irc2 networks only).</p>
<p>E.g. shows !channel instead of !12345channel</p>
<p>Added in Irssi 0.8.10</p>
</dd>
</dl>
<dl class="simple myst" id="window-auto-change">
<dt><code class="docutils literal notranslate"><span class="pre">window_auto_change</span></code> <strong><code class="docutils literal notranslate"><span class="pre">OFF</span></code></strong></dt><dd><p>Turn this on to automatically switch to newly-created windows. This may cause you to misdirect messages, so be careful.</p>
</dd>
</dl>
<p id="window-check-level-first"><code class="docutils literal notranslate"><span class="pre">window_check_level_first</span></code> <strong><code class="docutils literal notranslate"><span class="pre">OFF</span></code></strong></p>
<dl class="simple myst" id="window-default-level">
<dt><code class="docutils literal notranslate"><span class="pre">window_default_level</span></code> <strong><code class="docutils literal notranslate"><span class="pre">NONE</span></code></strong></dt><dd><p>From Irssis ChangeLog:</p>
<p>Added /SET window_check_level_first and /SET window_default_level. This allows you to keep all messages with specific level in its own window, even if it was supposed to be printed in channel window. patch by <a class="reference external" href="mailto:mike%40po.cs.msu.su">mike<span>@</span>po<span>.</span>cs<span>.</span>msu<span>.</span>su</a></p>
<p>Try to choose better the window where we print when matching by level and multiple windows have a match. Should fix problems with query windows with a default msgs window + /SET window_check_level_first ON.</p>
<p>Wouter Coekaerts has made a nice explanation about this, see &lt;<a class="reference external" href="http://wouter.coekaerts.be/site/irssi/wclf">http://wouter.coekaerts.be/site/irssi/wclf</a>&gt;</p>
</dd>
</dl>
<dl class="simple myst" id="window-default-hidelevel">
<dt><code class="docutils literal notranslate"><span class="pre">window_default_hidelevel</span></code> <strong><code class="docutils literal notranslate"><span class="pre">HIDDEN</span></code></strong></dt><dd><p>The default /window hidelevel for newly created windows. You can add other levels here to hide joins/parts/quits by default.</p>
<p>Added in Irssi 1.2.0</p>
</dd>
</dl>
<dl class="simple myst" id="windows-auto-renumber">
<dt><code class="docutils literal notranslate"><span class="pre">windows_auto_renumber</span></code> <strong><code class="docutils literal notranslate"><span class="pre">ON</span></code></strong></dt><dd><p>Closing windows can create gaps in the window list. When windows_auto_renumber is turned on, however, windows are shifted to lower numbers in the list to fill those gaps.</p>
</dd>
</dl>
<dl class="simple myst" id="scrollback-format">
<dt><code class="docutils literal notranslate"><span class="pre">scrollback_format</span></code> <strong><code class="docutils literal notranslate"><span class="pre">ON</span></code></strong></dt><dd><p>Whether to store the format and arguments for printed text in the scrollback, or the final rendered text instead. Turning it off restores pre-1.3 behaviour. Some features may not work depending on this setting.</p>
<p>Added in Irssi 1.3</p>
</dd>
</dl>
<dl class="simple myst" id="empty-kill-clears-cutbuffer">
<dt><code class="docutils literal notranslate"><span class="pre">empty_kill_clears_cutbuffer</span></code> <strong><code class="docutils literal notranslate"><span class="pre">OFF</span></code></strong></dt><dd><p>Whether using erase_line on an empty line should be ignored (default) or instead clear the cutbuffer.</p>
<p>Added in Irssi 1.4</p>
</dd>
</dl>
<dl class="simple myst" id="glib-log-domains">
<dt><code class="docutils literal notranslate"><span class="pre">glib_log_domains</span></code> <strong><code class="docutils literal notranslate"><span class="pre">all</span></code></strong></dt><dd><p>Irssi will only show GLib log messages of this domain, or <code class="docutils literal notranslate"><span class="pre">all</span></code> for all log messages. This setting can be used to ignore GLib log messages based on the “log domain”. Such log messages may be emitted by third party GLib-based libraries.</p>
<p>Added in Irssi 1.4</p>
</dd>
</dl>
</section>
<section id="misc">
<h2>[misc]<a class="headerlink" href="#misc" title="Permalink to this headline"> </a></h2>
<dl class="simple myst" id="auto-whowas">
<dt><code class="docutils literal notranslate"><span class="pre">auto_whowas</span></code> <strong><code class="docutils literal notranslate"><span class="pre">ON</span></code></strong></dt><dd><p>Automatically try /whowas if you /whois someone who isnt online.</p>
</dd>
</dl>
<dl class="simple myst" id="ban-type">
<dt><code class="docutils literal notranslate"><span class="pre">ban_type</span></code> <strong><code class="docutils literal notranslate"><span class="pre">normal</span></code></strong></dt><dd><p>The default ban type to use: normal, user, host, domain, custom? See /help ban for a description of ban types.</p>
</dd>
</dl>
<dl class="simple myst" id="capsicum">
<dt><code class="docutils literal notranslate"><span class="pre">capsicum</span></code> <strong><code class="docutils literal notranslate"><span class="pre">OFF</span></code></strong></dt><dd><p>FreeBSD/Capsicum builds only: Capsicum is a lightweight OS capability and sandbox framework provided by FreeBSD.</p>
<p>This setting is only read when starting Irssi. See <code class="docutils literal notranslate"><span class="pre">docs/capsicum.txt</span></code> for usage details and limitations.</p>
<p>Added in Irssi 1.1.0</p>
</dd>
</dl>
<dl class="simple myst" id="capsicum-irclogs-path">
<dt><code class="docutils literal notranslate"><span class="pre">capsicum_irclogs_path</span></code> <strong><code class="docutils literal notranslate"><span class="pre">~/irclogs</span></code></strong></dt><dd><p>FreeBSD/Capsicum builds only: Path that Irssi is allowed to write irc logs to.</p>
<p>Added in Irssi 1.1.0</p>
</dd>
</dl>
<p id="capsicum-port-min"><code class="docutils literal notranslate"><span class="pre">capsicum_port_min</span></code> <strong><code class="docutils literal notranslate"><span class="pre">6667</span></code></strong></p>
<dl class="simple myst" id="capsicum-port-max">
<dt><code class="docutils literal notranslate"><span class="pre">capsicum_port_max</span></code> <strong><code class="docutils literal notranslate"><span class="pre">9999</span></code></strong></dt><dd><p>FreeBSD/Capsicum builds only: Range of ports that Irssi is allowed to connect to.</p>
<p>Added in Irssi 1.1.0</p>
</dd>
</dl>
<dl class="simple myst" id="channel-max-who-sync">
<dt><code class="docutils literal notranslate"><span class="pre">channel_max_who_sync</span></code> <strong><code class="docutils literal notranslate"><span class="pre">1000</span></code></strong></dt><dd><p>The maximum number of users that may be in a channel for Irssi to issue a</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>/who #channel
</pre></div>
</div>
<p>in order to obtain the hostmasks of every participant.</p>
<p>If this is set too high, IRC servers might kick you for Sendq exceeded.</p>
<p>Added in Irssi 0.8.10</p>
</dd>
</dl>
<dl class="simple myst" id="channel-sync">
<dt><code class="docutils literal notranslate"><span class="pre">channel_sync</span></code> <strong><code class="docutils literal notranslate"><span class="pre">ON</span></code></strong></dt><dd><p>Set whether Irssi should synchronize a channel on join. When enabled, Irssi will gather extra information about a channel: modes, who list, ban list, ban exceptions, and invite list.</p>
</dd>
</dl>
<dl class="simple myst" id="account-max-chase">
<dt><code class="docutils literal notranslate"><span class="pre">account_max_chase</span></code> <strong><code class="docutils literal notranslate"><span class="pre">10</span></code></strong></dt><dd><p>Maximum number of JOINs where Irssi will try to query the ACCOUNT using WHOX.</p>
<p>Added in Irssi 1.3</p>
</dd>
</dl>
<dl class="simple myst" id="cmdchars">
<dt><code class="docutils literal notranslate"><span class="pre">cmdchars</span></code> <strong><code class="docutils literal notranslate"><span class="pre">/</span></code></strong></dt><dd><p>Prefix characters that tell Irssi that your input is a command rather than chat text.</p>
</dd>
</dl>
<dl class="simple myst" id="ctcp-userinfo-reply">
<dt><code class="docutils literal notranslate"><span class="pre">ctcp_userinfo_reply</span></code> <strong><code class="docutils literal notranslate"><span class="pre">$Y</span></code></strong></dt><dd><p>The reply to send when someone queries your user information. By default, its $Y, which is defined by the real_name setting.</p>
<p>See <a class="reference internal" href="#a-b"><span class="std std-ref">Appendix B: Special Variables and Expandos</span></a> for more special variables you can use.</p>
</dd>
</dl>
<dl class="simple myst" id="ctcp-version-reply">
<dt><code class="docutils literal notranslate"><span class="pre">ctcp_version_reply</span></code> <strong><code class="docutils literal notranslate"><span class="pre">irssi</span> <span class="pre">v$J</span> <span class="pre">-</span> <span class="pre">running</span> <span class="pre">on</span> <span class="pre">$sysname</span> <span class="pre">$sysarch</span></code></strong></dt><dd><p>What to tell someone when they query your clients version.</p>
<p>Some people consider announcing your client and operating system type and version to be a security hole. Those people change this setting.</p>
</dd>
</dl>
<dl class="simple myst" id="group-multi-mode">
<dt><code class="docutils literal notranslate"><span class="pre">group_multi_mode</span></code> <strong><code class="docutils literal notranslate"><span class="pre">ON</span></code></strong></dt><dd><p>Consolidate multiple consecutive channel modes into a single message. This will delay the display of channel modes for a short period of time while it waits to see if multiple modes are occurring.</p>
</dd>
</dl>
<dl class="simple myst" id="help-path">
<dt><code class="docutils literal notranslate"><span class="pre">help_path</span></code> <strong><code class="docutils literal notranslate"><span class="pre">/usr/local/share/irssi/help</span></code></strong></dt><dd><p>One or more paths where Irssi will look for its help database. Multiple paths are separated by :. Its very important that this is correct.</p>
</dd>
</dl>
<dl class="simple myst" id="hide-netsplit-quits">
<dt><code class="docutils literal notranslate"><span class="pre">hide_netsplit_quits</span></code> <strong><code class="docutils literal notranslate"><span class="pre">ON</span></code></strong></dt><dd><p>Dont display quit messages if theyre the product of a netsplit. Some people find this helpful, while others find it creepy.</p>
</dd>
</dl>
<dl class="simple myst" id="ignore-signals">
<dt><code class="docutils literal notranslate"><span class="pre">ignore_signals</span></code> <strong><code class="docutils literal notranslate"> </code></strong></dt><dd><p>Operating system signals to ignore. May be zero or more of: int, quit, term, alrm, usr1, and usr2.</p>
</dd>
</dl>
<dl class="simple myst" id="join-auto-chans-on-invite">
<dt><code class="docutils literal notranslate"><span class="pre">join_auto_chans_on_invite</span></code> <strong><code class="docutils literal notranslate"><span class="pre">ON</span></code></strong></dt><dd><p>Automatically join a channel when invited to it, if that channel was previously added to the autojoin list (<code class="docutils literal notranslate"><span class="pre">/channel</span> <span class="pre">add</span> <span class="pre">-auto</span></code>).</p>
</dd>
</dl>
<dl class="simple myst" id="key-timeout">
<dt><code class="docutils literal notranslate"><span class="pre">key_timeout</span></code> <strong><code class="docutils literal notranslate"><span class="pre">0</span></code></strong></dt><dd><p>Time in msecs to wait until a key combo is flushed. If its set to 0 (the default), theres no timeout, and key combos will wait until the next keystroke before processing.</p>
<p>This is useful if you have key combos that extend others. For example, if you have <code class="docutils literal notranslate"><span class="pre">meta-a</span></code> and <code class="docutils literal notranslate"><span class="pre">meta-a-meta-b</span></code> this setting allows you to use <code class="docutils literal notranslate"><span class="pre">meta-a</span></code> after waiting some time.</p>
<p>Setting it to very low values may result in issues such as partial key combos getting processed accidentally. 1000 or 500 might be good starting points</p>
<p>Restart Irssi to enable the new timeout.</p>
<p>Added in Irssi 1.1.0</p>
</dd>
</dl>
<dl class="simple myst" id="kick-first-on-kickban">
<dt><code class="docutils literal notranslate"><span class="pre">kick_first_on_kickban</span></code> <strong><code class="docutils literal notranslate"><span class="pre">OFF</span></code></strong></dt><dd><p>Kickban will normally ban first, then kick. Turn this option on to reverse the situation, which can create a race condition if the user rejoins between your kick and the subsequent ban.</p>
</dd>
</dl>
<dl class="simple myst" id="knockout-time">
<dt><code class="docutils literal notranslate"><span class="pre">knockout_time</span></code> <strong><code class="docutils literal notranslate"><span class="pre">5min</span></code></strong></dt><dd><p>Knockouts are temporary kickbans. Knockout_time is the default amount of time before each temporary ban is lifted.</p>
<p>See /help knockout</p>
</dd>
</dl>
<dl class="simple myst" id="lag-check-time">
<dt><code class="docutils literal notranslate"><span class="pre">lag_check_time</span></code> <strong><code class="docutils literal notranslate"><span class="pre">1min</span></code></strong></dt><dd><p>How long to wait between active lag checks. Irssi will passively check for lag when youre active, but sometimes its necessary to actively check. This is the minimum amount of time between active checks.</p>
</dd>
</dl>
<dl class="simple myst" id="lag-max-before-disconnect">
<dt><code class="docutils literal notranslate"><span class="pre">lag_max_before_disconnect</span></code> <strong><code class="docutils literal notranslate"><span class="pre">5min</span></code></strong></dt><dd><p>Irssi detects your lag and will reconnect you automatically if your lag exceeds this value.</p>
</dd>
</dl>
<dl class="simple myst" id="lag-min-show">
<dt><code class="docutils literal notranslate"><span class="pre">lag_min_show</span></code> <strong><code class="docutils literal notranslate"><span class="pre">1sec</span></code></strong></dt><dd><p>Lag is a part of life on IRC. Dont bother displaying lag thats below this threshold, presumably because you consider it to be insignificant.</p>
</dd>
</dl>
<dl class="simple myst" id="massjoin-max-joins">
<dt><code class="docutils literal notranslate"><span class="pre">massjoin_max_joins</span></code> <strong><code class="docutils literal notranslate"><span class="pre">3</span></code></strong></dt><dd><p>If nonzero, detect mass joins. A mass join is when someone joins more than massjoin_max_joins per massjoin_max_wait seconds.</p>
<p>TODO - Or is this when more than massjoin_max_joins people join per massjoin_max_wait seconds, regardless of the user mask?</p>
</dd>
</dl>
<dl class="simple myst" id="massjoin-max-wait">
<dt><code class="docutils literal notranslate"><span class="pre">massjoin_max_wait</span></code> <strong><code class="docutils literal notranslate"><span class="pre">5000</span></code></strong></dt><dd><p>The amount of time to watch for mass-joins, in seconds.</p>
<p>5000 is probably a bit too much.</p>
</dd>
</dl>
<dl class="simple myst" id="max-wildcard-modes">
<dt><code class="docutils literal notranslate"><span class="pre">max_wildcard_modes</span></code> <strong><code class="docutils literal notranslate"><span class="pre">6</span></code></strong></dt><dd><p>When set nonzero, dont mass op/deop/kick more than this many people. Commands that let you do things to other nicks can take wildcards. For example</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>/kick floodbot* flooding
</pre></div>
</div>
<p>would kick everybody whose nickname began with floodbot. Unless there were more than max_wildcard_modes of them.</p>
<p>This setting prevents you from embarassment like:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>/kick *
</pre></div>
</div>
<p>You can specify -yes if you really want to do it:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>/kick -yes *
</pre></div>
</div>
</dd>
</dl>
<dl class="simple myst" id="netjoin-max-nicks">
<dt><code class="docutils literal notranslate"><span class="pre">netjoin_max_nicks</span></code> <strong><code class="docutils literal notranslate"><span class="pre">10</span></code></strong></dt><dd><p>When non-zero, limits the number of nicknames to display during netjoins.</p>
</dd>
</dl>
<dl class="simple myst" id="netsplit-max-nicks">
<dt><code class="docutils literal notranslate"><span class="pre">netsplit_max_nicks</span></code> <strong><code class="docutils literal notranslate"><span class="pre">10</span></code></strong></dt><dd><p>When non-zero, limits the number of nicknames to display during netsplits.</p>
</dd>
</dl>
<dl class="simple myst" id="netsplit-nicks-hide-threshold">
<dt><code class="docutils literal notranslate"><span class="pre">netsplit_nicks_hide_threshold</span></code> <strong><code class="docutils literal notranslate"><span class="pre">15</span></code></strong></dt><dd><p>Limit the number of nicks to display during netsplits to this many. Or dont limit them at all, if this is set to 0.</p>
</dd>
</dl>
<dl class="simple myst" id="notify-check-time">
<dt><code class="docutils literal notranslate"><span class="pre">notify_check_time</span></code> <strong><code class="docutils literal notranslate"><span class="pre">1min</span></code></strong></dt><dd><p>How often to check for someone online when /notify is on.</p>
</dd>
</dl>
<dl class="simple myst" id="notify-whois-time">
<dt><code class="docutils literal notranslate"><span class="pre">notify_whois_time</span></code> <strong><code class="docutils literal notranslate"><span class="pre">5min</span></code></strong></dt><dd><p>How often to check /whois on a user whos online, to see if their /away or idle status changes.</p>
</dd>
</dl>
<dl class="simple myst" id="opermode">
<dt><code class="docutils literal notranslate"><span class="pre">opermode</span></code> <strong><code class="docutils literal notranslate"> </code></strong></dt><dd><p>When set, Irssi will set your modes to match opermode when you /oper up. For example, you might</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>/set opermode +s 1048575
</pre></div>
</div>
</dd>
</dl>
<dl class="simple myst" id="override-coredump-limit">
<dt><code class="docutils literal notranslate"><span class="pre">override_coredump_limit</span></code> <strong><code class="docutils literal notranslate"><span class="pre">OFF</span></code></strong></dt><dd><p>Allow really really big coredumps if this is set on.</p>
</dd>
</dl>
<dl class="simple myst" id="part-message">
<dt><code class="docutils literal notranslate"><span class="pre">part_message</span></code> <strong><code class="docutils literal notranslate"> </code></strong></dt><dd><p>Default message to send when parting a channel.</p>
</dd>
</dl>
<dl class="simple myst" id="paste-detect-time">
<dt><code class="docutils literal notranslate"><span class="pre">paste_detect_time</span></code> <strong><code class="docutils literal notranslate"><span class="pre">5msecs</span></code></strong></dt><dd><p>Irssi will detect pastes when your input has less than this much time between lines.</p>
</dd>
</dl>
<dl class="simple myst" id="paste-join-multiline">
<dt><code class="docutils literal notranslate"><span class="pre">paste_join_multiline</span></code> <strong><code class="docutils literal notranslate"><span class="pre">ON</span></code></strong></dt><dd><p>Irssi will try to concatenate multiple lines into a single lined message when these lines have the same indentation level and look like they were copied out of Irssi.</p>
<p>Its useful for quoting e-mail or other large-text messages, but it will probably bite you if you try to pasted indented text, such as code listings. Irssi will join multiple lines of code, destroying any structure you wanted to preserve.</p>
<p>Added in Irssi 0.8.10</p>
</dd>
</dl>
<dl class="simple myst" id="paste-use-bracketed-mode">
<dt><code class="docutils literal notranslate"><span class="pre">paste_use_bracketed_mode</span></code> <strong><code class="docutils literal notranslate"><span class="pre">OFF</span></code></strong></dt><dd><p>Enables bracketed paste mode, which is an alternative to the time-based paste detection.</p>
<p>If supported by the terminal, its much more reliable since Irssi knows exactly where and when a paste starts and ends, because the terminal sends special control sequences (the “brackets”) indicating those positions.</p>
<p>To take full advantage of this feature, time-based paste detection should be disabled by setting <code class="docutils literal notranslate"><span class="pre">paste_detect_time</span></code> to 0.</p>
<p>See <a class="reference external" href="https://cirw.in/blog/bracketed-paste">https://cirw.in/blog/bracketed-paste</a> for more details on how this works.</p>
<p>Added in Irssi 0.8.18</p>
</dd>
</dl>
<dl class="simple myst" id="paste-verify-line-count">
<dt><code class="docutils literal notranslate"><span class="pre">paste_verify_line_count</span></code> <strong><code class="docutils literal notranslate"><span class="pre">5</span></code></strong></dt><dd><p>Ask you whether you meant to paste something if its longer than this many lines.</p>
</dd>
</dl>
<dl class="simple myst" id="paste-ignore-first-nl">
<dt><code class="docutils literal notranslate"><span class="pre">paste_ignore_first_nl</span></code> <strong><code class="docutils literal notranslate"><span class="pre">OFF</span></code></strong></dt><dd><p>Pasting a single line ending with a line break will remove the line break and insert the line into your input prompt instead of sending it.</p>
<p>Added in Irssi 1.4</p>
</dd>
</dl>
<dl class="simple myst" id="quit-message">
<dt><code class="docutils literal notranslate"><span class="pre">quit_message</span></code> <strong><code class="docutils literal notranslate"><span class="pre">leaving</span></code></strong></dt><dd><p>Default message to send when /quitting.</p>
</dd>
</dl>
<dl class="simple myst" id="recode">
<dt><code class="docutils literal notranslate"><span class="pre">recode</span></code> <strong><code class="docutils literal notranslate"><span class="pre">ON</span></code></strong></dt><dd><p>This setting allows you to disable Irssis recode functionality, if you prefer your messages not being messed with.</p>
<p>Added in Irssi 0.8.10</p>
</dd>
</dl>
<dl class="simple myst" id="recode-autodetect-utf8">
<dt><code class="docutils literal notranslate"><span class="pre">recode_autodetect_utf8</span></code> <strong><code class="docutils literal notranslate"><span class="pre">ON</span></code></strong></dt><dd><p>Irssis recode system is broken. This tries to cover up for it by leaving messages intact that seem to decode fine as Unicode UTF-8.</p>
<p>Added in Irssi 0.8.10</p>
</dd>
</dl>
<dl class="simple myst" id="recode-fallback">
<dt><code class="docutils literal notranslate"><span class="pre">recode_fallback</span></code> <strong><code class="docutils literal notranslate"><span class="pre">CP1252</span></code></strong></dt><dd><p>If you have Irssi compiled with recode support and Irssi believes that a message you received did not recode properly in your terminal default character set (or the specified one), it will recode the message using this character set.</p>
<p>(CP1252, the Irssi default, is the Microsoft(R) Windows default character set for Western Europe.)</p>
<p>Also see /help recode for more details about recoding.</p>
<p>Added in Irssi 0.8.10</p>
</dd>
</dl>
<dl class="simple myst" id="recode-out-default-charset">
<dt><code class="docutils literal notranslate"><span class="pre">recode_out_default_charset</span></code> <strong><code class="docutils literal notranslate"> </code></strong></dt><dd><p>The outgoing character set you want your messags to be recoded into, if different from your term_charset.</p>
<p>Added in Irssi 0.8.10</p>
</dd>
</dl>
<dl class="simple myst" id="recode-transliterate">
<dt><code class="docutils literal notranslate"><span class="pre">recode_transliterate</span></code> <strong><code class="docutils literal notranslate"><span class="pre">ON</span></code></strong></dt><dd><p>If enabled, Irssi tells iconv to try and replace characters that dont recode well with similar looking ones that exist in the target character set.</p>
<p>If disabled, Irssi replaces the character it could not recode with a ? instead.</p>
<p>Added in Irssi 0.8.10</p>
</dd>
</dl>
<dl class="simple myst" id="settings-autosave">
<dt><code class="docutils literal notranslate"><span class="pre">settings_autosave</span></code> <strong><code class="docutils literal notranslate"><span class="pre">ON</span></code></strong></dt><dd><p>Automatically save your settings when you quit Irssi, or once per hour, rather than waiting for you to /save them yourself.</p>
</dd>
</dl>
<dl class="simple myst" id="split-line-end">
<dt><code class="docutils literal notranslate"><span class="pre">split_line_end</span></code> <strong><code class="docutils literal notranslate"> </code></strong></dt><dd><p>When automatically splitting long lines, this is added to the end of line fragments.</p>
<p>Added in Irssi 0.8.17</p>
</dd>
</dl>
<dl class="simple myst" id="split-line-on-space">
<dt><code class="docutils literal notranslate"><span class="pre">split_line_on_space</span></code> <strong><code class="docutils literal notranslate"><span class="pre">ON</span></code></strong></dt><dd><p>When this is ON, Irssi tries to split long lines on spaces, instead of splitting in the middle of words.</p>
<p>Added in Irssi 0.8.18</p>
</dd>
</dl>
<dl class="simple myst" id="split-line-start">
<dt><code class="docutils literal notranslate"><span class="pre">split_line_start</span></code> <strong><code class="docutils literal notranslate"> </code></strong></dt><dd><p>When automatically splitting long lines, this is added to the beginning of line fragments.
:</p>
</dd>
<dd><p>Added in Irssi 0.8.17</p>
</dd>
</dl>
<dl class="simple myst" id="status-oper">
<dt><code class="docutils literal notranslate"><span class="pre">STATUS_OPER</span></code> <strong><code class="docutils literal notranslate"><span class="pre">*</span></code></strong></dt><dd><p>Determines whats shown in the <code class="docutils literal notranslate"><span class="pre">$O</span></code> expando when the user is an oper.
:</p>
</dd>
<dd><p>TODO - why</p>
</dd>
</dl>
<dl class="simple myst" id="usermode">
<dt><code class="docutils literal notranslate"><span class="pre">usermode</span></code> <strong><code class="docutils literal notranslate"><span class="pre">+i</span></code></strong></dt><dd><p>Default modes to set yourself once youve connected to a server.</p>
</dd>
</dl>
<dl class="simple myst" id="notice-channel-context">
<dt><code class="docutils literal notranslate"><span class="pre">notice_channel_context</span></code> <strong><code class="docutils literal notranslate"><span class="pre">ON</span></code></strong></dt><dd><p>Whether Irssi should recognise the channel context in /notices and show the notice in the appropriate channel window.</p>
<p>Added in Irssi 1.2.0</p>
</dd>
</dl>
<dl class="simple myst" id="wall-format">
<dt><code class="docutils literal notranslate"><span class="pre">wall_format</span></code> <strong><code class="docutils literal notranslate"><span class="pre">[Wall/$0]</span> <span class="pre">$1-</span></code></strong></dt><dd><p>Format for wall messages.</p>
</dd>
</dl>
<dl class="simple myst" id="write-buffer-size">
<dt><code class="docutils literal notranslate"><span class="pre">write_buffer_size</span></code> <strong><code class="docutils literal notranslate"><span class="pre">0</span></code></strong></dt><dd><p>Amount of text (logs, etc) to buffer in memory before writing to disk. Useful for minimizing disk access.</p>
</dd>
</dl>
<dl class="simple myst" id="write-buffer-timeout">
<dt><code class="docutils literal notranslate"><span class="pre">write_buffer_timeout</span></code> <strong><code class="docutils literal notranslate"><span class="pre">0</span></code></strong></dt><dd><p>Amount of time to keep text in memory. A buffer is flushed to disk if the text in it is this old, even if the buffer isnt full.</p>
<p>Useful in conjunction with really large write_buffer_size values, to prevent a lot of text from being lost if Irssi crashes or is killed.</p>
</dd>
</dl>
<dl class="simple myst" id="window-number-commands">
<dt><code class="docutils literal notranslate"><span class="pre">window_number_commands</span></code> <strong><code class="docutils literal notranslate"><span class="pre">ON</span></code></strong></dt><dd><p>Whether <code class="docutils literal notranslate"><span class="pre">/&lt;number&gt;</span></code> can be used to change windows.</p>
<p>Added in Irssi 1.2.0</p>
</dd>
</dl>
<dl class="simple myst" id="wcwidth-implementation">
<dt><code class="docutils literal notranslate"><span class="pre">wcwidth_implementation</span></code> <strong><code class="docutils literal notranslate"><span class="pre">system</span></code></strong></dt><dd><p>The implementation Irssi should use to calculate and match the width of characters (like emoji) to the width that the terminal emulator assumes. If these widths dont add up, lines may not line up. Accepted values:</p>
<dl class="simple myst">
<dt><code class="docutils literal notranslate"><span class="pre">old</span></code></dt><dd><p>the old built-in calculation (may be preferable on old systems)</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">system</span></code> (default)</dt><dd><p>use the calculation of your operating system</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">julia</span></code></dt><dd><p>use the calculation of the utf8proc library (only when compiled with utf8proc)</p>
</dd>
</dl>
<p>Added in Irssi 1.2.0</p>
</dd>
</dl>
<dl class="simple myst" id="quit-on-hup">
<dt><code class="docutils literal notranslate"><span class="pre">quit_on_hup</span></code> <strong><code class="docutils literal notranslate"><span class="pre">OFF</span></code></strong></dt><dd><p>Whether Irssi should /quit itself on receiving the HUP signal or reload its config instead. This setting may be desirable if you want to /quit Irssi with the [x] button on your terminal emulator window.</p>
<p>Added in Irssi 1.3</p>
</dd>
</dl>
<dl class="simple myst" id="autoload-modules">
<dt><code class="docutils literal notranslate"><span class="pre">autoload_modules</span></code> <strong><code class="docutils literal notranslate"><span class="pre">irc</span> <span class="pre">dcc</span> <span class="pre">flood</span> <span class="pre">notifylist</span> <span class="pre">perl</span> <span class="pre">otr</span></code></strong></dt><dd><p>Which modules should be loaded on Irssi start. Irssi will silently try to /load all these modules in the order given.</p>
<p>Added in Irssi 1.3</p>
</dd>
</dl>
</section>
<section id="perl">
<h2>[perl]<a class="headerlink" href="#perl" title="Permalink to this headline"> </a></h2>
<dl class="simple myst" id="perl-use-lib">
<dt><code class="docutils literal notranslate"><span class="pre">perl_use_lib</span></code> <strong><code class="docutils literal notranslate"><span class="pre">/usr/local/perl-582/i386-freebsd</span></code></strong></dt><dd><p>Which perl library to use, in case you have many to choose from.</p>
</dd>
</dl>
</section>
<section id="proxy">
<h2>[proxy]<a class="headerlink" href="#proxy" title="Permalink to this headline"> </a></h2>
<dl class="simple myst" id="proxy-address">
<dt><code class="docutils literal notranslate"><span class="pre">proxy_address</span></code> <strong><code class="docutils literal notranslate"> </code></strong></dt><dd><p>The address of your IRC proxy.</p>
</dd>
</dl>
<dl class="simple myst" id="proxy-password">
<dt><code class="docutils literal notranslate"><span class="pre">proxy_password</span></code> <strong><code class="docutils literal notranslate"> </code></strong></dt><dd><p>The password to use if the proxy requires authentication.</p>
</dd>
</dl>
<dl class="simple myst" id="proxy-port">
<dt><code class="docutils literal notranslate"><span class="pre">proxy_port</span></code> <strong><code class="docutils literal notranslate"><span class="pre">6667</span></code></strong></dt><dd><p>The port of your IRC proxy.</p>
</dd>
</dl>
<dl class="simple myst" id="proxy-string">
<dt><code class="docutils literal notranslate"><span class="pre">proxy_string</span></code> <strong><code class="docutils literal notranslate"><span class="pre">CONNECT</span> <span class="pre">%s</span> <span class="pre">%d</span></code></strong></dt><dd><p>How to tell your proxy to initiate a connection.</p>
<p>I havent found documentation for the codes used in proxy_string.</p>
<p>TODO - How do you tell Irssi to connect through a proxy that requires authentication?</p>
</dd>
</dl>
<dl class="simple myst" id="proxy-string-after">
<dt><code class="docutils literal notranslate"><span class="pre">proxy_string_after</span></code> <strong><code class="docutils literal notranslate"> </code></strong></dt><dd><p>Text to send after setting NICK and USER through a proxy.</p>
</dd>
</dl>
<dl class="simple myst" id="use-proxy">
<dt><code class="docutils literal notranslate"><span class="pre">use_proxy</span></code> <strong><code class="docutils literal notranslate"><span class="pre">OFF</span></code></strong></dt><dd><p>Tell Irssi whether it should connect through a proxy server.</p>
</dd>
</dl>
</section>
<section id="server">
<h2>[server]<a class="headerlink" href="#server" title="Permalink to this headline"> </a></h2>
<dl class="simple myst" id="alternate-nick">
<dt><code class="docutils literal notranslate"><span class="pre">alternate_nick</span></code> <strong><code class="docutils literal notranslate"> </code></strong></dt><dd><p>An alternate nickname to use if your preferred one is already taken.</p>
</dd>
</dl>
<dl class="simple myst" id="hostname">
<dt><code class="docutils literal notranslate"><span class="pre">hostname</span></code> <strong><code class="docutils literal notranslate"> </code></strong></dt><dd><p>Your source hostname. Useful when youre on a multi-host system, and you want to look like youre connecting from a particular host.</p>
<p>This setting tells Irssi which IP to bind to.</p>
</dd>
</dl>
<dl class="simple myst" id="nick">
<dt><code class="docutils literal notranslate"><span class="pre">nick</span></code> <strong><code class="docutils literal notranslate"><span class="pre">$IRCNICK</span></code></strong></dt><dd><p>Your main, preferred nick.</p>
</dd>
</dl>
<dl class="simple myst" id="real-name">
<dt><code class="docutils literal notranslate"><span class="pre">real_name</span></code> <strong><code class="docutils literal notranslate"><span class="pre">$IRCNAME</span></code></strong></dt><dd><p>Your real name.</p>
</dd>
</dl>
<dl class="simple myst" id="resolve-prefer-ipv6">
<dt><code class="docutils literal notranslate"><span class="pre">resolve_prefer_ipv6</span></code> <strong><code class="docutils literal notranslate"><span class="pre">OFF</span></code></strong></dt><dd><p>Turn this option on to prefer using an ipv6 address when a host has both ipv4 and ipv6 addresses.</p>
</dd>
</dl>
<dl class="simple myst" id="resolve-reverse-lookup">
<dt><code class="docutils literal notranslate"><span class="pre">resolve_reverse_lookup</span></code> <strong><code class="docutils literal notranslate"><span class="pre">OFF</span></code></strong></dt><dd><p>Removed in Irssi 1.3. See <a class="reference external" href="https://github.com/irssi/irssi/issues?q=resolve_reverse_lookup">resolve_reverse_lookup issues</a> for more information.</p>
</dd>
</dl>
<dl class="simple myst" id="sasl-disconnect-on-failure">
<dt><code class="docutils literal notranslate"><span class="pre">sasl_disconnect_on_failure</span></code> <strong><code class="docutils literal notranslate"><span class="pre">ON</span></code></strong></dt><dd><p>Turn this option off to continue connecting to servers even when sasl authentication errors happen.</p>
<p>Added in Irssi 1.0.0</p>
</dd>
</dl>
<dl class="simple myst" id="server-connect-timeout">
<dt><code class="docutils literal notranslate"><span class="pre">server_connect_timeout</span></code> <strong><code class="docutils literal notranslate"><span class="pre">5min</span></code></strong></dt><dd><p>How long to wait for a connection to be established.</p>
<p>Be careful using very short timeouts. Servers may recognize the activity as abuse.</p>
</dd>
</dl>
<dl class="simple myst" id="server-reconnect-time">
<dt><code class="docutils literal notranslate"><span class="pre">server_reconnect_time</span></code> <strong><code class="docutils literal notranslate"><span class="pre">5min</span></code></strong></dt><dd><p>How long to wait between reconnects to the same server. Some servers will k-line you if you reconnect too quickly, so be careful setting this value lower.</p>
<p>Setting the value to -1 will disable reconnects</p>
</dd>
</dl>
<dl class="simple myst" id="skip-motd">
<dt><code class="docutils literal notranslate"><span class="pre">skip_motd</span></code> <strong><code class="docutils literal notranslate"><span class="pre">OFF</span></code></strong></dt><dd><p>Turn this on to avoid displaying the servers message of the day. Messages of the day are often noisy, and few people actually read them, but they contain important information amongst the ASCII art and song lyrics. :)</p>
</dd>
</dl>
<dl class="simple myst" id="user-name">
<dt><code class="docutils literal notranslate"><span class="pre">user_name</span></code> <strong><code class="docutils literal notranslate"><span class="pre">$IRCUSER</span></code></strong></dt><dd><p>Set your system user name. This is used in times when you dont have working ident.</p>
</dd>
</dl>
</section>
<section id="servers">
<h2>[servers]<a class="headerlink" href="#servers" title="Permalink to this headline"> </a></h2>
<dl class="simple myst" id="channels-rejoin-unavailable">
<dt><code class="docutils literal notranslate"><span class="pre">channels_rejoin_unavailable</span></code> <strong><code class="docutils literal notranslate"><span class="pre">ON</span></code></strong></dt><dd><p>Attempt to rejoin a channel if its temporarily unavailable. Channels may be unavailable during netsplits.</p>
</dd>
</dl>
<dl class="simple myst" id="rejoin-channels-on-reconnect">
<dt><code class="docutils literal notranslate"><span class="pre">rejoin_channels_on_reconnect</span></code> <strong><code class="docutils literal notranslate"><span class="pre">ON</span></code></strong></dt><dd><p>Determines whether channels are rejoined on reconnect. Possible values are OFF, ON and AUTO:</p>
<dl class="simple myst">
<dt><code class="docutils literal notranslate"><span class="pre">off</span></code></dt><dd><p>no channels are rejoined.</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">on</span></code> (default)</dt><dd><p>all channels are rejoined.</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">auto</span></code></dt><dd><p>only channels configured with autojoins are rejoined.</p>
</dd>
</dl>
<p>Added in Irssi 0.8.18. <code class="docutils literal notranslate"><span class="pre">auto</span></code> was added in Irssi 1.0.0</p>
</dd>
</dl>
<dl class="simple myst" id="starttls-sts">
<dt><code class="docutils literal notranslate"><span class="pre">starttls_sts</span></code> <strong><code class="docutils literal notranslate"><span class="pre">ON</span></code></strong></dt><dd><p>Whether to automatically add a starttls flag to a server once STARTTLS has succeeded.</p>
<p>Added in Irssi 1.3</p>
</dd>
</dl>
</section>
<section id="irssiproxy">
<h2>[irssiproxy]<a class="headerlink" href="#irssiproxy" title="Permalink to this headline"> </a></h2>
<p>Also see <span class="xref myst">proxy.txt</span> for more information about the irssiproxy module.</p>
<dl class="simple myst" id="irssiproxy-ports">
<dt><code class="docutils literal notranslate"><span class="pre">irssiproxy_ports</span></code> <strong><code class="docutils literal notranslate"> </code></strong></dt><dd><p>A space-separated list of <code class="docutils literal notranslate"><span class="pre">networktag=port</span></code> that the irssiproxy should listen on. If you connect to the port, you will share the connection of the specified network in your Irssi.</p>
<p>The special network name <code class="docutils literal notranslate"><span class="pre">?=port</span></code> can be used to select the network through your connect password.</p>
<p><code class="docutils literal notranslate"><span class="pre">?</span></code> was added in Irssi 1.0.0</p>
</dd>
</dl>
<dl class="simple myst" id="irssiproxy-password">
<dt><code class="docutils literal notranslate"><span class="pre">irssiproxy_password</span></code> <strong><code class="docutils literal notranslate"> </code></strong></dt><dd><p>The password required to connect to the irssiproxy.</p>
</dd>
</dl>
<dl class="simple myst" id="irssiproxy-bind">
<dt><code class="docutils literal notranslate"><span class="pre">irssiproxy_bind</span></code> <strong><code class="docutils literal notranslate"> </code></strong></dt><dd><p>The interface that the irssiproxy should listen on.</p>
</dd>
</dl>
<dl class="simple myst" id="id1">
<dt><code class="docutils literal notranslate"><span class="pre">irssiproxy</span></code> <strong><code class="docutils literal notranslate"><span class="pre">ON</span></code></strong></dt><dd><p>Here you can enable and disable the proxy.</p>
<p>Added in Irssi 0.8.18</p>
</dd>
</dl>
<hr class="docutils"/>
</section>
<section id="appendix-a-levels">
<span id="a-a"></span><h2>Appendix A: Levels<a class="headerlink" href="#appendix-a-levels" title="Permalink to this headline"> </a></h2>
<p>Levels are categories of messages that can be ignored or otherwise matched. Categories may be combined. For example, you may want to ignore only private messages (MSG) from someone, or you might really hate them and ignore MSGS and PUBLIC. Or even ALL.</p>
<p>See /help levels for a better, probably more current explanation of the different kinds of levels Irssi supports. Meanwhile:</p>
<div class="table-wrapper"><table class="colwidths-auto docutils align-default">
<thead>
<tr class="row-odd"><th class="head"><p>Level</p></th>
<th class="head"><p>Description</p></th>
</tr>
</thead>
<tbody>
<tr class="row-even"><td><p>CRAP</p></td>
<td><p>?</p></td>
</tr>
<tr class="row-odd"><td><p>MSGS</p></td>
<td><p>Match messages privately sent to you.</p></td>
</tr>
<tr class="row-even"><td><p>PUBLIC</p></td>
<td><p>Match messages sent to public channels.</p></td>
</tr>
<tr class="row-odd"><td><p>NOTICES</p></td>
<td><p>Match NOTICE messages.</p></td>
</tr>
<tr class="row-even"><td><p>SNOTES</p></td>
<td><p>Match server notices.</p></td>
</tr>
<tr class="row-odd"><td><p>CTCPS</p></td>
<td><p>Match CTCP messages.</p></td>
</tr>
<tr class="row-even"><td><p>ACTIONS</p></td>
<td><p>Match CTCP actions.</p></td>
</tr>
<tr class="row-odd"><td><p>JOINS</p></td>
<td><p>Match join messages.</p></td>
</tr>
<tr class="row-even"><td><p>PARTS</p></td>
<td><p>Match part messages.</p></td>
</tr>
<tr class="row-odd"><td><p>QUITS</p></td>
<td><p>Match quit messages.</p></td>
</tr>
<tr class="row-even"><td><p>KICKS</p></td>
<td><p>Match kick messages.</p></td>
</tr>
<tr class="row-odd"><td><p>MODES</p></td>
<td><p>Match mode changes.</p></td>
</tr>
<tr class="row-even"><td><p>TOPICS</p></td>
<td><p>Match topic changes.</p></td>
</tr>
<tr class="row-odd"><td><p>WALLOPS</p></td>
<td><p>Match wallops.</p></td>
</tr>
<tr class="row-even"><td><p>INVITES</p></td>
<td><p>Match invite requests.</p></td>
</tr>
<tr class="row-odd"><td><p>NICKS</p></td>
<td><p>Match nickname changes.</p></td>
</tr>
<tr class="row-even"><td><p>DCC</p></td>
<td><p>DCC related messages.</p></td>
</tr>
<tr class="row-odd"><td><p>DCCMSGS</p></td>
<td><p>Match DCC chat messages.</p></td>
</tr>
<tr class="row-even"><td><p>CLIENTNOTICE</p></td>
<td><p>Irssis notices.</p></td>
</tr>
<tr class="row-odd"><td><p>CLIENTCRAP</p></td>
<td><p>Miscellaneous Irssi messages.</p></td>
</tr>
<tr class="row-even"><td><p>CLIENTERROR</p></td>
<td><p>Irssis error messages.</p></td>
</tr>
<tr class="row-odd"><td><p></p></td>
<td><p></p></td>
</tr>
<tr class="row-even"><td><p>ALL</p></td>
<td><p>All previous message levels combined.</p></td>
</tr>
<tr class="row-odd"><td><p></p></td>
<td><p></p></td>
</tr>
<tr class="row-even"><td><p>HILIGHT</p></td>
<td><p>Match highlighted messages.</p></td>
</tr>
<tr class="row-odd"><td><p>NOHILIGHT</p></td>
<td><p>Dont check a messages highlighting.</p></td>
</tr>
<tr class="row-even"><td><p>NO_ACT</p></td>
<td><p>Dont trigger channel activity.</p></td>
</tr>
<tr class="row-odd"><td><p>NEVER</p></td>
<td><p>Never ignore, never log.</p></td>
</tr>
<tr class="row-even"><td><p>LASTLOG</p></td>
<td><p>Never ignore, never log.</p></td>
</tr>
</tbody>
</table></div>
<hr class="docutils"/>
</section>
<section id="appendix-b-special-variables-and-expandos">
<span id="a-b"></span><h2>Appendix B: Special Variables and Expandos<a class="headerlink" href="#appendix-b-special-variables-and-expandos" title="Permalink to this headline"> </a></h2>
<p>Several settings allow special variables. These variables will be replaced by the text they represent at the time theyre used. Not at the time you set the setting!</p>
<p>They are mostly used for formatting text in themes.</p>
<p>From <a class="reference external" href="https://github.com/ailin-nemui/irssi/blob/master/docs/special_vars.txt">https://github.com/ailin-nemui/irssi/blob/master/docs/special_vars.txt</a>:</p>
<p>NOTE: This is just a slightly modified file taken from EPICs help.</p>
<section id="special-variables-and-expandos">
<h3>Special Variables and Expandos<a class="headerlink" href="#special-variables-and-expandos" title="Permalink to this headline"> </a></h3>
<p>Irssi supports a number of reserved, dynamic variables, sometimes
referred to as expandos. They are special in that the client is
constantly updating their values automatically. There are also
numerous variable modifiers available.</p>
<div class="table-wrapper"><table class="colwidths-auto docutils align-default">
<thead>
<tr class="row-odd"><th class="head"><p>Modifier</p></th>
<th class="head"><p>Description</p></th>
</tr>
</thead>
<tbody>
<tr class="row-even"><td><p>$variable</p></td>
<td><p>A normal variable, expanding to the first match of: <br/> 1) an internal SET variable <br/> 2) an environment variable</p></td>
</tr>
<tr class="row-odd"><td><p>$[num]variable</p></td>
<td><p>Expands to the variables value, with num width. <br/> If the number is negative, the value is right-aligned. <br/> The value is padded to meet the width with the character given after number (default is space). <br/> The value is truncated to specified width unless ! character precedes the number. <br/> If . character precedes the number the value isnt padded, just truncated.</p></td>
</tr>
<tr class="row-even"><td><p>$#variable</p></td>
<td><p>Expands to the number of words in $variable. If $variable is omitted, it assumes $*</p></td>
</tr>
<tr class="row-odd"><td><p>$@variable</p></td>
<td><p>Expands to the number of characters in $variable. if $variable is omitted, it assumes $*</p></td>
</tr>
<tr class="row-even"><td><p>$($subvariable)</p></td>
<td><p>This is somewhat similar to a pointer, in that the value of $subvar is taken as the name of the variable to expand to. Nesting is allowed.</p></td>
</tr>
<tr class="row-odd"><td><p>${expression}</p></td>
<td><p>Permits the value to be embedded in another string unambiguously.</p></td>
</tr>
<tr class="row-even"><td><p>$!history!</p></td>
<td><p>Expands to a matching entry in the clients command history, wildcards allowed.</p></td>
</tr>
</tbody>
</table></div>
<p>Whenever an alias is called, these expandos are set to the arguments
passed to it. If none of these expandos are used in the alias, or
the $() form shown above, any arguments passed will automatically be
appended to the last command in the alias.</p>
<div class="table-wrapper"><table class="colwidths-auto docutils align-default">
<thead>
<tr class="row-odd"><th class="head"><p>Expando</p></th>
<th class="head"><p>Description</p></th>
</tr>
</thead>
<tbody>
<tr class="row-even"><td><p>$*</p></td>
<td><p>expands to all arguments passed to an alias</p></td>
</tr>
<tr class="row-odd"><td><p>$n</p></td>
<td><p>expands to argument n passed to an alias (counting from zero)</p></td>
</tr>
<tr class="row-even"><td><p>$n-m</p></td>
<td><p>expands to arguments n through m passed to an alias</p></td>
</tr>
<tr class="row-odd"><td><p>$n-</p></td>
<td><p>expands to all arguments from n on passed to an alias</p></td>
</tr>
<tr class="row-even"><td><p>$-m</p></td>
<td><p>expands to all arguments up to m passed to an alias</p></td>
</tr>
<tr class="row-odd"><td><p>$~</p></td>
<td><p>expands to the last argument passed to an alias</p></td>
</tr>
</tbody>
</table></div>
<p>These variables are set and updated dynamically by the client. The
case of $A .. $Z is important.</p>
<div class="table-wrapper"><table class="colwidths-auto docutils align-default">
<thead>
<tr class="row-odd"><th class="head"><p>Variable</p></th>
<th class="head"><p>Description</p></th>
</tr>
</thead>
<tbody>
<tr class="row-even"><td><p>$,</p></td>
<td><p>last person who sent you a MSG</p></td>
</tr>
<tr class="row-odd"><td><p>$.</p></td>
<td><p>last person to whom you sent a MSG</p></td>
</tr>
<tr class="row-even"><td><p>$:</p></td>
<td><p>last person to join a channel you are on</p></td>
</tr>
<tr class="row-odd"><td><p>$;</p></td>
<td><p>last person to send a public message to a channel you are on</p></td>
</tr>
<tr class="row-even"><td><p>$A</p></td>
<td><p>text of your AWAY message, if any</p></td>
</tr>
<tr class="row-odd"><td><p>$B</p></td>
<td><p>body of last MSG you sent</p></td>
</tr>
<tr class="row-even"><td><p>$C</p></td>
<td><p>current channel</p></td>
</tr>
<tr class="row-odd"><td><p>$D</p></td>
<td><p>last person that NOTIFY detected a signon for</p></td>
</tr>
<tr class="row-even"><td><p>$E</p></td>
<td><p>idle time</p></td>
</tr>
<tr class="row-odd"><td><p>$F</p></td>
<td><p>time client was started, $time() format</p></td>
</tr>
<tr class="row-even"><td><p>$H</p></td>
<td><p>current server numeric being processed</p></td>
</tr>
<tr class="row-odd"><td><p>$I</p></td>
<td><p>channel you were last INVITEd to</p></td>
</tr>
<tr class="row-even"><td><p>$J</p></td>
<td><p>client version text string</p></td>
</tr>
<tr class="row-odd"><td><p>$K</p></td>
<td><p>current value of CMDCHARS</p></td>
</tr>
<tr class="row-even"><td><p>$k</p></td>
<td><p>first character in CMDCHARS</p></td>
</tr>
<tr class="row-odd"><td><p>$L</p></td>
<td><p>current contents of the input line</p></td>
</tr>
<tr class="row-even"><td><p>$M</p></td>
<td><p>modes of current channel, if any</p></td>
</tr>
<tr class="row-odd"><td><p>$N</p></td>
<td><p>current nickname</p></td>
</tr>
<tr class="row-even"><td><p>$O</p></td>
<td><p>value of STATUS_OPER if you are an irc operator</p></td>
</tr>
<tr class="row-odd"><td><p>$P</p></td>
<td><p>if you are a channel operator in $C, expands to a @</p></td>
</tr>
<tr class="row-even"><td><p></p></td>
<td><p></p></td>
</tr>
<tr class="row-odd"><td><p>$Q</p></td>
<td><p>nickname of whomever you are QUERYing</p></td>
</tr>
<tr class="row-even"><td><p>$R</p></td>
<td><p>version of current server</p></td>
</tr>
<tr class="row-odd"><td><p>$S</p></td>
<td><p>current server name</p></td>
</tr>
<tr class="row-even"><td><p>$T</p></td>
<td><p>target of current input (channel or nick of query)</p></td>
</tr>
<tr class="row-odd"><td><p>$U</p></td>
<td><p>value of cutbuffer</p></td>
</tr>
<tr class="row-even"><td><p>$V</p></td>
<td><p>client release date (format YYYYMMDD)</p></td>
</tr>
<tr class="row-odd"><td><p>$W</p></td>
<td><p>current working directory</p></td>
</tr>
<tr class="row-even"><td><p>$X</p></td>
<td><p>your /userhost $N address (user@host)</p></td>
</tr>
<tr class="row-odd"><td><p>$Y</p></td>
<td><p>value of REALNAME</p></td>
</tr>
<tr class="row-even"><td><p>$Z</p></td>
<td><p>time of day (hh:mm, can be changed with /SET timestamp_format)</p></td>
</tr>
<tr class="row-odd"><td><p>$$</p></td>
<td><p>a literal $</p></td>
</tr>
<tr class="row-even"><td><p></p></td>
<td><p></p></td>
</tr>
<tr class="row-odd"><td><p>$versiontime</p></td>
<td><p>prints time of the Irssi version in HHMM format</p></td>
</tr>
<tr class="row-even"><td><p>$sysname</p></td>
<td><p>system name (eg. Linux)</p></td>
</tr>
<tr class="row-odd"><td><p>$sysrelease</p></td>
<td><p>system release (eg. 2.2.18)</p></td>
</tr>
<tr class="row-even"><td><p>$sysarch</p></td>
<td><p>system architecture (eg. i686)</p></td>
</tr>
<tr class="row-odd"><td><p>$topic</p></td>
<td><p>channel topic</p></td>
</tr>
<tr class="row-even"><td><p>$usermode</p></td>
<td><p>user mode</p></td>
</tr>
<tr class="row-odd"><td><p>$cumode</p></td>
<td><p>own channel user mode</p></td>
</tr>
<tr class="row-even"><td><p>$cumode_space</p></td>
<td><p>like $cumode, but gives space if theres no mode.</p></td>
</tr>
<tr class="row-odd"><td><p>$tag</p></td>
<td><p>server tag</p></td>
</tr>
<tr class="row-even"><td><p>$chatnet</p></td>
<td><p>chat network of server</p></td>
</tr>
<tr class="row-odd"><td><p>$winref</p></td>
<td><p>window reference number</p></td>
</tr>
<tr class="row-even"><td><p>$winname</p></td>
<td><p>window name</p></td>
</tr>
<tr class="row-odd"><td><p>$itemname</p></td>
<td><p>like $T, but use items visible_name which may be different <br/> (eg. $T = !12345chan, $itemname = !chan)</p></td>
</tr>
</tbody>
</table></div>
<p>For example, assume you have the following alias:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>/alias blah msg $D Hi there!
</pre></div>
</div>
<p>If /blah is passed any arguments, they will automatically be appended
to the MSG text. For example:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>/blah oops /* command as entered */
Hi there! oops /* text sent to $D */
</pre></div>
</div>
<p>Another useful form is ${}. In general, variables can be embedded
inside strings without problems, assuming the surrounding text could
not be misinterpreted as part of the variable name. This form
guarantees that surrounding text will not affect the expressions
return value.</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>/eval echo foo$Nfoo /* breaks, looks for $nfoo */
/eval echo foo${N}foo /* ${N} returns current nickname */
fooYourNickfoo /* returned by above command */
</pre></div>
</div>
<hr class="docutils"/>
</section>
</section>
<section id="appendix-c-time-formats">
<span id="a-c"></span><h2>Appendix C: Time Formats<a class="headerlink" href="#appendix-c-time-formats" title="Permalink to this headline"> </a></h2>
<p>Messages that describe times are formatted according to the strftime() function in C. According to FreeBSDs strftime() man page, parts of the format represented with % and a letter code are expanded in the following ways.</p>
<div class="table-wrapper"><table class="colwidths-auto docutils align-default">
<thead>
<tr class="row-odd"><th class="head"><p>Format</p></th>
<th class="head"><p>Description</p></th>
</tr>
</thead>
<tbody>
<tr class="row-even"><td><p>%A</p></td>
<td><p>is replaced by national representation of the full weekday name.</p></td>
</tr>
<tr class="row-odd"><td><p>%a</p></td>
<td><p>is replaced by national representation of the abbreviated weekday name.</p></td>
</tr>
<tr class="row-even"><td><p>%B</p></td>
<td><p>is replaced by national representation of the full month name.</p></td>
</tr>
<tr class="row-odd"><td><p>%b</p></td>
<td><p>is replaced by national representation of the abbreviated month name.</p></td>
</tr>
<tr class="row-even"><td><p>%C</p></td>
<td><p>is replaced by (year / 100) as decimal number; single digits are preceded by a zero.</p></td>
</tr>
<tr class="row-odd"><td><p>%c</p></td>
<td><p>is replaced by national representation of time and date.</p></td>
</tr>
<tr class="row-even"><td><p>%D</p></td>
<td><p>is equivalent to ``%m/%d/%y.</p></td>
</tr>
<tr class="row-odd"><td><p>%d</p></td>
<td><p>is replaced by the day of the month as a decimal number (01-31).</p></td>
</tr>
<tr class="row-even"><td><p>%E* %O*</p></td>
<td><p>POSIX locale extensions. The sequences %Ec %EC %Ex %EX %Ey %EY %Od %Oe %OH %OI %Om %OM %OS %Ou %OU %OV %Ow %OW %Oy are supposed to provide alternate representations. <br/> Additionly %OB implemented to represent alternative months names (used standalone, without day mentioned).</p></td>
</tr>
<tr class="row-odd"><td><p>%e</p></td>
<td><p>is replaced by the day of month as a decimal number (1-31); single digits are preceded by a blank.</p></td>
</tr>
<tr class="row-even"><td><p>%F</p></td>
<td><p>is equivalent to ``%Y-%m-%d.</p></td>
</tr>
<tr class="row-odd"><td><p>%G</p></td>
<td><p>is replaced by a year as a decimal number with century. This year is the one that contains the greater part of the week (Monday as the first day of the week).</p></td>
</tr>
<tr class="row-even"><td><p>%g</p></td>
<td><p>is replaced by the same year as in ``%G, but as a decimal number without century (00-99).</p></td>
</tr>
<tr class="row-odd"><td><p>%H</p></td>
<td><p>is replaced by the hour (24-hour clock) as a decimal number (00-23).</p></td>
</tr>
<tr class="row-even"><td><p>%h</p></td>
<td><p>the same as %b.</p></td>
</tr>
<tr class="row-odd"><td><p>%I</p></td>
<td><p>is replaced by the hour (12-hour clock) as a decimal number (01-12).</p></td>
</tr>
<tr class="row-even"><td><p>%j</p></td>
<td><p>is replaced by the day of the year as a decimal number (001-366).</p></td>
</tr>
<tr class="row-odd"><td><p>%k</p></td>
<td><p>is replaced by the hour (24-hour clock) as a decimal number (0-23); single digits are preceded by a blank.</p></td>
</tr>
<tr class="row-even"><td><p>%l</p></td>
<td><p>is replaced by the hour (12-hour clock) as a decimal number (1-12); single digits are preceded by a blank.</p></td>
</tr>
<tr class="row-odd"><td><p>%M</p></td>
<td><p>is replaced by the minute as a decimal number (00-59).</p></td>
</tr>
<tr class="row-even"><td><p>%m</p></td>
<td><p>is replaced by the month as a decimal number (01-12).</p></td>
</tr>
<tr class="row-odd"><td><p>%n</p></td>
<td><p>is replaced by a newline.</p></td>
</tr>
<tr class="row-even"><td><p>%O*</p></td>
<td><p>the same as %E*.</p></td>
</tr>
<tr class="row-odd"><td><p>%p</p></td>
<td><p>is replaced by national representation of either ante meridiem or post meridiem as appropriate.</p></td>
</tr>
<tr class="row-even"><td><p>%R</p></td>
<td><p>is equivalent to ``%H:%M.</p></td>
</tr>
<tr class="row-odd"><td><p>%r</p></td>
<td><p>is equivalent to ``%I:%M:%S %p.</p></td>
</tr>
<tr class="row-even"><td><p>%S</p></td>
<td><p>is replaced by the second as a decimal number (00-60).</p></td>
</tr>
<tr class="row-odd"><td><p>%s</p></td>
<td><p>is replaced by the number of seconds since the Epoch, UTC (see mktime(3)).</p></td>
</tr>
<tr class="row-even"><td><p>%T</p></td>
<td><p>is equivalent to ``%H:%M:%S.</p></td>
</tr>
<tr class="row-odd"><td><p>%t</p></td>
<td><p>is replaced by a tab.</p></td>
</tr>
<tr class="row-even"><td><p>%U</p></td>
<td><p>is replaced by the week number of the year (Sunday as the first day of the week) as a decimal number (00-53).</p></td>
</tr>
<tr class="row-odd"><td><p>%u</p></td>
<td><p>is replaced by the weekday (Monday as the first day of the week) as a decimal number (1-7).</p></td>
</tr>
<tr class="row-even"><td><p>%V</p></td>
<td><p>is replaced by the week number of the year (Monday as the first day of the week) as a decimal number (01-53). If the week containing January 1 has four or more days in the new year, then it is week 1; otherwise it is the last week of the previous year, and the next week is week 1.</p></td>
</tr>
<tr class="row-odd"><td><p>%v</p></td>
<td><p>is equivalent to ``%e-%b-%Y.</p></td>
</tr>
<tr class="row-even"><td><p>%W</p></td>
<td><p>is replaced by the week number of the year (Monday as the first day of the week) as a decimal number (00-53).</p></td>
</tr>
<tr class="row-odd"><td><p>%w</p></td>
<td><p>is replaced by the weekday (Sunday as the first day of the week) as a decimal number (0-6).</p></td>
</tr>
<tr class="row-even"><td><p>%X</p></td>
<td><p>is replaced by national representation of the time.</p></td>
</tr>
<tr class="row-odd"><td><p>%x</p></td>
<td><p>is replaced by national representation of the date.</p></td>
</tr>
<tr class="row-even"><td><p>%Y</p></td>
<td><p>is replaced by the year with century as a decimal number.</p></td>
</tr>
<tr class="row-odd"><td><p>%y</p></td>
<td><p>is replaced by the year without century as a decimal number (00-99).</p></td>
</tr>
<tr class="row-even"><td><p>%Z</p></td>
<td><p>is replaced by the time zone name.</p></td>
</tr>
<tr class="row-odd"><td><p>%z</p></td>
<td><p>is replaced by the time zone offset from UTC; a leading plus sign stands for east of UTC, a minus sign for west of UTC, hours and minutes follow with two digits each and no delimiter between them (common form for RFC 822 date headers).</p></td>
</tr>
<tr class="row-even"><td><p>%+</p></td>
<td><p>is replaced by national representation of the date and time (the format is similar to that produced by date(1)).</p></td>
</tr>
<tr class="row-odd"><td><p>%%</p></td>
<td><p>is replaced by `%.</p></td>
</tr>
</tbody>
</table></div>
<hr class="docutils"/>
</section>
<section id="appendix-d-color-codes">
<span id="a-d"></span><h2>Appendix D: Color Codes<a class="headerlink" href="#appendix-d-color-codes" title="Permalink to this headline"> </a></h2>
<p>Irssi defines codes to represent colors. They work like the <code class="docutils literal notranslate"><span class="pre">strftime()</span></code> codes in Appendix C.</p>
<p>From <a class="reference external" href="https://irssi.org/documentation/formats">https://irssi.org/documentation/formats</a>:</p>
<p>Irssis colors that you can use in text formats, hilights, etc. :</p>
<div class="table-wrapper"><table class="colwidths-auto docutils align-default">
<thead>
<tr class="row-odd"><th class="head"><p></p></th>
<th class="head"><p></p></th>
<th class="head"><p></p></th>
<th class="head"><p>text</p></th>
<th class="head"><p>text</p></th>
<th class="head"><p>background</p></th>
</tr>
</thead>
<tbody>
<tr class="row-even"><td><p>%k</p></td>
<td><p>%K</p></td>
<td><p>%0</p></td>
<td><p>black</p></td>
<td><p>dark grey</p></td>
<td><p>black</p></td>
</tr>
<tr class="row-odd"><td><p>%r</p></td>
<td><p>%R</p></td>
<td><p>%1</p></td>
<td><p>red</p></td>
<td><p>bold red</p></td>
<td><p>red</p></td>
</tr>
<tr class="row-even"><td><p>%g</p></td>
<td><p>%G</p></td>
<td><p>%2</p></td>
<td><p>green</p></td>
<td><p>bold green</p></td>
<td><p>green</p></td>
</tr>
<tr class="row-odd"><td><p>%y</p></td>
<td><p>%Y</p></td>
<td><p>%3</p></td>
<td><p>yellow</p></td>
<td><p>bold yellow</p></td>
<td><p>yellow</p></td>
</tr>
<tr class="row-even"><td><p>%b</p></td>
<td><p>%B</p></td>
<td><p>%4</p></td>
<td><p>blue</p></td>
<td><p>bold blue</p></td>
<td><p>blue</p></td>
</tr>
<tr class="row-odd"><td><p>%m</p></td>
<td><p>%M</p></td>
<td><p>%5</p></td>
<td><p>magenta</p></td>
<td><p>bold magenta</p></td>
<td><p>magenta</p></td>
</tr>
<tr class="row-even"><td><p>%p</p></td>
<td><p>%P</p></td>
<td><p></p></td>
<td><p>magenta</p></td>
<td><p>(think: purple)</p></td>
<td><p></p></td>
</tr>
<tr class="row-odd"><td><p>%c</p></td>
<td><p>%C</p></td>
<td><p>%6</p></td>
<td><p>cyan</p></td>
<td><p>bold cyan</p></td>
<td><p>cyan</p></td>
</tr>
<tr class="row-even"><td><p>%w</p></td>
<td><p>%W</p></td>
<td><p>%7</p></td>
<td><p>white</p></td>
<td><p>bold white</p></td>
<td><p>white</p></td>
</tr>
</tbody>
</table></div>
<div class="table-wrapper"><table class="colwidths-auto docutils align-default">
<thead>
<tr class="row-odd"><th class="head"><p></p></th>
<th class="head"><p></p></th>
<th class="head"><p></p></th>
<th class="head"><p></p></th>
</tr>
</thead>
<tbody>
<tr class="row-even"><td><p>%n</p></td>
<td><p>%N</p></td>
<td><p></p></td>
<td><p>Changes the color to default color, removing all other coloring and formatting. %N is always the terminals default color. %n is usually too, except in themes it changes to previous color, ie. hello = %Rhello%n and %G{hello} world would print hello in red, and %n would turn back into %G making world green.</p></td>
</tr>
<tr class="row-odd"><td><p>%F</p></td>
<td><p></p></td>
<td><p></p></td>
<td><p>Blinking on/off (think: flash)</p></td>
</tr>
<tr class="row-even"><td><p>%U</p></td>
<td><p></p></td>
<td><p></p></td>
<td><p>Underline on/off</p></td>
</tr>
<tr class="row-odd"><td><p>%8</p></td>
<td><p></p></td>
<td><p></p></td>
<td><p>Reverse on/off</p></td>
</tr>
<tr class="row-even"><td><p>%9</p></td>
<td><p>%_</p></td>
<td><p></p></td>
<td><p>Bold on/off</p></td>
</tr>
<tr class="row-odd"><td><p>%I</p></td>
<td><p></p></td>
<td><p></p></td>
<td><p>Italic on/off</p></td>
</tr>
<tr class="row-even"><td><p>%:</p></td>
<td><p></p></td>
<td><p></p></td>
<td><p>Insert newline</p></td>
</tr>
<tr class="row-odd"><td><p>%|</p></td>
<td><p></p></td>
<td><p></p></td>
<td><p>Marks the indentation position</p></td>
</tr>
<tr class="row-even"><td><p>%#</p></td>
<td><p></p></td>
<td><p></p></td>
<td><p>Monospace font on/off (useful with lists and GUI)</p></td>
</tr>
<tr class="row-odd"><td><p>%%</p></td>
<td><p></p></td>
<td><p></p></td>
<td><p>A single %</p></td>
</tr>
<tr class="row-even"><td><p>%XAB</p></td>
<td><p></p></td>
<td><p>%xAB</p></td>
<td><p>Color from extended plane (A=1-7, B=0-Z)</p></td>
</tr>
<tr class="row-odd"><td><p>%ZAABBCC</p></td>
<td><p></p></td>
<td><p>%zAABBCC</p></td>
<td><p>HTML color (in hex notation)</p></td>
</tr>
</tbody>
</table></div>
<p>In .theme files %n works a bit differently. See default.theme for more
information.</p>
<hr class="docutils"/>
</section>
<section id="appendix-e-credits-and-copyright">
<span id="a-credits"></span><h2>Appendix E: Credits and copyright<a class="headerlink" href="#appendix-e-credits-and-copyright" title="Permalink to this headline"> </a></h2>
<p>We respect the work of others. Parts of this document have been collected from other locations. Wherever possible, we have made every effort to locate and attribute the original authors. Please let us know if weve overlooked you.</p>
<p>We ask the same respect in return.</p>
<p>The original portions of this document are Copyright 2005 by Rocco Caputo <a class="reference external" href="mailto:rcaputo%40cpan.org">rcaputo<span>@</span>cpan<span>.</span>org</a> and Nei (on irc.libera.chat #irssi). Other portions are Copyright by their respective authors or licensors.</p>
<p>This work is licensed under a Creative Commons Attribution-ShareAlike 2.5 License. Please see <a class="reference external" href="https://creativecommons.org/licenses/by-sa/2.5/">https://creativecommons.org/licenses/by-sa/2.5/</a> for details. Summary:</p>
<blockquote>
<div><p>You are free:</p>
<ul class="simple">
<li><p>to copy, distribute, display, and perform this work</p></li>
<li><p>to make derivative works</p></li>
<li><p>to make commercial use of this work</p></li>
</ul>
<p>Under the following conditions:</p>
<dl class="simple myst">
<dt>Attribution.</dt><dd><p>You must attribute the work in the manner specified
by the author or licensor.</p>
</dd>
<dt>Share Alike.</dt><dd><p>If you alter, transform, or build upon this work,
you may distribute the resulting work only under a license
identical to this one.</p>
</dd>
</dl>
<ul class="simple">
<li><p>For any reuse or distribution, you must make clear to others the
license terms of this work.</p></li>
<li><p>Any of these conditions can be waived if you get permision from
the copyright holder.</p></li>
</ul>
<p>Your fair use and other rights are in no way affected by the above.</p>
</div></blockquote>
<p>Sorry for the heavy license crap. Coekie wanted clarification.</p>
<script src="../_static/prerenderimg.js"></script>
<script src="../_static/anchor.js"></script>
<script>
anchors.options = {
placement: 'left',
icon: '#',
class: 'small'
}
anchors.add('dl[id]')
</script>
</section>
</section>
</article>
</div>
<footer>
<div class="related-pages">
<a class="prev-page" href="help/script.html">
<svg><use href="#svg-arrow-right"></use></svg>
<div class="page-info">
<div class="context">
<span>Previous</span>
</div>
<div class="title">script</div>
</div>
</a>
</div>
<div class="bottom-of-page">
<div class="left-details">
<div class="copyright">
Copyright &#169;
</div>
Made with <a href="https://www.sphinx-doc.org/">Sphinx</a> and <a class="muted-link" href="https://pradyunsg.me">@pradyunsg</a>'s
<a href="https://github.com/pradyunsg/furo">Furo</a>
</div>
<div class="right-details">
<div class="icons">
</div>
</div>
</div>
</footer>
</div>
<aside class="toc-drawer">
<div class="toc-sticky toc-scroll">
<div class="toc-title-container">
<span class="toc-title">
Contents
</span>
</div>
<div class="toc-tree-container">
<div class="toc-tree">
<ul>
<li><a class="reference internal" href="#">Settings Documentation</a><ul>
<li><a class="reference internal" href="#completion">[completion]</a></li>
<li><a class="reference internal" href="#dcc">[dcc]</a></li>
<li><a class="reference internal" href="#flood">[flood]</a></li>
<li><a class="reference internal" href="#history">[history]</a></li>
<li><a class="reference internal" href="#log">[log]</a></li>
<li><a class="reference internal" href="#lookandfeel">[lookandfeel]</a></li>
<li><a class="reference internal" href="#misc">[misc]</a></li>
<li><a class="reference internal" href="#perl">[perl]</a></li>
<li><a class="reference internal" href="#proxy">[proxy]</a></li>
<li><a class="reference internal" href="#server">[server]</a></li>
<li><a class="reference internal" href="#servers">[servers]</a></li>
<li><a class="reference internal" href="#irssiproxy">[irssiproxy]</a></li>
<li><a class="reference internal" href="#appendix-a-levels">Appendix A: Levels</a></li>
<li><a class="reference internal" href="#appendix-b-special-variables-and-expandos">Appendix B: Special Variables and Expandos</a><ul>
<li><a class="reference internal" href="#special-variables-and-expandos">Special Variables and Expandos</a></li>
</ul>
</li>
<li><a class="reference internal" href="#appendix-c-time-formats">Appendix C: Time Formats</a></li>
<li><a class="reference internal" href="#appendix-d-color-codes">Appendix D: Color Codes</a></li>
<li><a class="reference internal" href="#appendix-e-credits-and-copyright">Appendix E: Credits and copyright</a></li>
</ul>
</li>
</ul>
</div>
</div>
</div>
</aside>
</div>
</div><script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js"></script>
<script src="../_static/jquery.js"></script>
<script src="../_static/underscore.js"></script>
<script src="../_static/doctools.js"></script>
<script src="../_static/scripts/furo.js"></script>
</body>
</html>