/usr/share/doc/weechat-doc/html/weechat

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="generator" content="Asciidoctor 1.5.4">
<meta name="author" content="Sébastien Helleu">
<title>WeeChat FAQ (Frequently Asked Questions)</title>
<style>
/* Asciidoctor default stylesheet | MIT License | http://asciidoctor.org */
/* Remove comment around @import statement below when using as a custom stylesheet */
/*@import "https://fonts.googleapis.com/css?family=Open+Sans:300,300italic,400,400italic,600,600italic%7CNoto+Serif:400,400italic,700,700italic%7CDroid+Sans+Mono:400,700";*/
article,aside,details,figcaption,figure,footer,header,hgroup,main,nav,section,summary{display:block}
audio,canvas,video{display:inline-block}
audio:not([controls]){display:none;height:0}
[hidden],template{display:none}
script{display:none!important}
html{font-family:sans-serif;-ms-text-size-adjust:100%;-webkit-text-size-adjust:100%}
body{margin:0}
a{background:transparent}
a:focus{outline:thin dotted}
a:active,a:hover{outline:0}
h1{font-size:2em;margin:.67em 0}
abbr[title]{border-bottom:1px dotted}
b,strong{font-weight:bold}
dfn{font-style:italic}
hr{-moz-box-sizing:content-box;box-sizing:content-box;height:0}
mark{background:#ff0;color:#000}
code,kbd,pre,samp{font-family:monospace;font-size:1em}
pre{white-space:pre-wrap}
q{quotes:"\201C" "\201D" "\2018" "\2019"}
small{font-size:80%}
sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}
sup{top:-.5em}
sub{bottom:-.25em}
img{border:0}
svg:not(:root){overflow:hidden}
figure{margin:0}
fieldset{border:1px solid silver;margin:0 2px;padding:.35em .625em .75em}
legend{border:0;padding:0}
button,input,select,textarea{font-family:inherit;font-size:100%;margin:0}
button,input{line-height:normal}
button,select{text-transform:none}
button,html input[type="button"],input[type="reset"],input[type="submit"]{-webkit-appearance:button;cursor:pointer}
button[disabled],html input[disabled]{cursor:default}
input[type="checkbox"],input[type="radio"]{box-sizing:border-box;padding:0}
input[type="search"]{-webkit-appearance:textfield;-moz-box-sizing:content-box;-webkit-box-sizing:content-box;box-sizing:content-box}
input[type="search"]::-webkit-search-cancel-button,input[type="search"]::-webkit-search-decoration{-webkit-appearance:none}
button::-moz-focus-inner,input::-moz-focus-inner{border:0;padding:0}
textarea{overflow:auto;vertical-align:top}
table{border-collapse:collapse;border-spacing:0}
*,*:before,*:after{-moz-box-sizing:border-box;-webkit-box-sizing:border-box;box-sizing:border-box}
html,body{font-size:100%}
body{background:#fff;color:rgba(0,0,0,.8);padding:0;margin:0;font-family:"Noto Serif","DejaVu Serif",serif;font-weight:400;font-style:normal;line-height:1;position:relative;cursor:auto}
a:hover{cursor:pointer}
img,object,embed{max-width:100%;height:auto}
object,embed{height:100%}
img{-ms-interpolation-mode:bicubic}
.left{float:left!important}
.right{float:right!important}
.text-left{text-align:left!important}
.text-right{text-align:right!important}
.text-center{text-align:center!important}
.text-justify{text-align:justify!important}
.hide{display:none}
body{-webkit-font-smoothing:antialiased}
img,object,svg{display:inline-block;vertical-align:middle}
textarea{height:auto;min-height:50px}
select{width:100%}
.center{margin-left:auto;margin-right:auto}
.spread{width:100%}
p.lead,.paragraph.lead>p,#preamble>.sectionbody>.paragraph:first-of-type p{font-size:1.21875em;line-height:1.6}
.subheader,.admonitionblock td.content>.title,.audioblock>.title,.exampleblock>.title,.imageblock>.title,.listingblock>.title,.literalblock>.title,.stemblock>.title,.openblock>.title,.paragraph>.title,.quoteblock>.title,table.tableblock>.title,.verseblock>.title,.videoblock>.title,.dlist>.title,.olist>.title,.ulist>.title,.qlist>.title,.hdlist>.title{line-height:1.45;color:#7a2518;font-weight:400;margin-top:0;margin-bottom:.25em}
div,dl,dt,dd,ul,ol,li,h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6,pre,form,p,blockquote,th,td{margin:0;padding:0;direction:ltr}
a{color:#2156a5;text-decoration:underline;line-height:inherit}
a:hover,a:focus{color:#1d4b8f}
a img{border:none}
p{font-family:inherit;font-weight:400;font-size:1em;line-height:1.6;margin-bottom:1.25em;text-rendering:optimizeLegibility}
p aside{font-size:.875em;line-height:1.35;font-style:italic}
h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6{font-family:"Open Sans","DejaVu Sans",sans-serif;font-weight:300;font-style:normal;color:#ba3925;text-rendering:optimizeLegibility;margin-top:1em;margin-bottom:.5em;line-height:1.0125em}
h1 small,h2 small,h3 small,#toctitle small,.sidebarblock>.content>.title small,h4 small,h5 small,h6 small{font-size:60%;color:#e99b8f;line-height:0}
h1{font-size:2.125em}
h2{font-size:1.6875em}
h3,#toctitle,.sidebarblock>.content>.title{font-size:1.375em}
h4,h5{font-size:1.125em}
h6{font-size:1em}
hr{border:solid #ddddd8;border-width:1px 0 0;clear:both;margin:1.25em 0 1.1875em;height:0}
em,i{font-style:italic;line-height:inherit}
strong,b{font-weight:bold;line-height:inherit}
small{font-size:60%;line-height:inherit}
code{font-family:"Droid Sans Mono","DejaVu Sans Mono",monospace;font-weight:400;color:rgba(0,0,0,.9)}
ul,ol,dl{font-size:1em;line-height:1.6;margin-bottom:1.25em;list-style-position:outside;font-family:inherit}
ul,ol,ul.no-bullet,ol.no-bullet{margin-left:1.5em}
ul li ul,ul li ol{margin-left:1.25em;margin-bottom:0;font-size:1em}
ul.square li ul,ul.circle li ul,ul.disc li ul{list-style:inherit}
ul.square{list-style-type:square}
ul.circle{list-style-type:circle}
ul.disc{list-style-type:disc}
ul.no-bullet{list-style:none}
ol li ul,ol li ol{margin-left:1.25em;margin-bottom:0}
dl dt{margin-bottom:.3125em;font-weight:bold}
dl dd{margin-bottom:1.25em}
abbr,acronym{text-transform:uppercase;font-size:90%;color:rgba(0,0,0,.8);border-bottom:1px dotted #ddd;cursor:help}
abbr{text-transform:none}
blockquote{margin:0 0 1.25em;padding:.5625em 1.25em 0 1.1875em;border-left:1px solid #ddd}
blockquote cite{display:block;font-size:.9375em;color:rgba(0,0,0,.6)}
blockquote cite:before{content:"\2014 \0020"}
blockquote cite a,blockquote cite a:visited{color:rgba(0,0,0,.6)}
blockquote,blockquote p{line-height:1.6;color:rgba(0,0,0,.85)}
@media only screen and (min-width:768px){h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6{line-height:1.2}
h1{font-size:2.75em}
h2{font-size:2.3125em}
h3,#toctitle,.sidebarblock>.content>.title{font-size:1.6875em}
h4{font-size:1.4375em}}
table{background:#fff;margin-bottom:1.25em;border:solid 1px #dedede}
table thead,table tfoot{background:#f7f8f7;font-weight:bold}
table thead tr th,table thead tr td,table tfoot tr th,table tfoot tr td{padding:.5em .625em .625em;font-size:inherit;color:rgba(0,0,0,.8);text-align:left}
table tr th,table tr td{padding:.5625em .625em;font-size:inherit;color:rgba(0,0,0,.8)}
table tr.even,table tr.alt,table tr:nth-of-type(even){background:#f8f8f7}
table thead tr th,table tfoot tr th,table tbody tr td,table tr td,table tfoot tr td{display:table-cell;line-height:1.6}
body{tab-size:4}
h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6{line-height:1.2;word-spacing:-.05em}
h1 strong,h2 strong,h3 strong,#toctitle strong,.sidebarblock>.content>.title strong,h4 strong,h5 strong,h6 strong{font-weight:400}
.clearfix:before,.clearfix:after,.float-group:before,.float-group:after{content:" ";display:table}
.clearfix:after,.float-group:after{clear:both}
*:not(pre)>code{font-size:.9375em;font-style:normal!important;letter-spacing:0;padding:.1em .5ex;word-spacing:-.15em;background-color:#f7f7f8;-webkit-border-radius:4px;border-radius:4px;line-height:1.45;text-rendering:optimizeSpeed}
pre,pre>code{line-height:1.45;color:rgba(0,0,0,.9);font-family:"Droid Sans Mono","DejaVu Sans Mono",monospace;font-weight:400;text-rendering:optimizeSpeed}
.keyseq{color:rgba(51,51,51,.8)}
kbd{font-family:"Droid Sans Mono","DejaVu Sans Mono",monospace;display:inline-block;color:rgba(0,0,0,.8);font-size:.65em;line-height:1.45;background-color:#f7f7f7;border:1px solid #ccc;-webkit-border-radius:3px;border-radius:3px;-webkit-box-shadow:0 1px 0 rgba(0,0,0,.2),0 0 0 .1em white inset;box-shadow:0 1px 0 rgba(0,0,0,.2),0 0 0 .1em #fff inset;margin:0 .15em;padding:.2em .5em;vertical-align:middle;position:relative;top:-.1em;white-space:nowrap}
.keyseq kbd:first-child{margin-left:0}
.keyseq kbd:last-child{margin-right:0}
.menuseq,.menu{color:rgba(0,0,0,.8)}
b.button:before,b.button:after{position:relative;top:-1px;font-weight:400}
b.button:before{content:"[";padding:0 3px 0 2px}
b.button:after{content:"]";padding:0 2px 0 3px}
p a>code:hover{color:rgba(0,0,0,.9)}
#header,#content,#footnotes,#footer{width:100%;margin-left:auto;margin-right:auto;margin-top:0;margin-bottom:0;max-width:62.5em;*zoom:1;position:relative;padding-left:.9375em;padding-right:.9375em}
#header:before,#header:after,#content:before,#content:after,#footnotes:before,#footnotes:after,#footer:before,#footer:after{content:" ";display:table}
#header:after,#content:after,#footnotes:after,#footer:after{clear:both}
#content{margin-top:1.25em}
#content:before{content:none}
#header>h1:first-child{color:rgba(0,0,0,.85);margin-top:2.25rem;margin-bottom:0}
#header>h1:first-child+#toc{margin-top:8px;border-top:1px solid #ddddd8}
#header>h1:only-child,body.toc2 #header>h1:nth-last-child(2){border-bottom:1px solid #ddddd8;padding-bottom:8px}
#header .details{border-bottom:1px solid #ddddd8;line-height:1.45;padding-top:.25em;padding-bottom:.25em;padding-left:.25em;color:rgba(0,0,0,.6);display:-ms-flexbox;display:-webkit-flex;display:flex;-ms-flex-flow:row wrap;-webkit-flex-flow:row wrap;flex-flow:row wrap}
#header .details span:first-child{margin-left:-.125em}
#header .details span.email a{color:rgba(0,0,0,.85)}
#header .details br{display:none}
#header .details br+span:before{content:"\00a0\2013\00a0"}
#header .details br+span.author:before{content:"\00a0\22c5\00a0";color:rgba(0,0,0,.85)}
#header .details br+span#revremark:before{content:"\00a0|\00a0"}
#header #revnumber{text-transform:capitalize}
#header #revnumber:after{content:"\00a0"}
#content>h1:first-child:not([class]){color:rgba(0,0,0,.85);border-bottom:1px solid #ddddd8;padding-bottom:8px;margin-top:0;padding-top:1rem;margin-bottom:1.25rem}
#toc{border-bottom:1px solid #efefed;padding-bottom:.5em}
#toc>ul{margin-left:.125em}
#toc ul.sectlevel0>li>a{font-style:italic}
#toc ul.sectlevel0 ul.sectlevel1{margin:.5em 0}
#toc ul{font-family:"Open Sans","DejaVu Sans",sans-serif;list-style-type:none}
#toc li{line-height:1.3334;margin-top:.3334em}
#toc a{text-decoration:none}
#toc a:active{text-decoration:underline}
#toctitle{color:#7a2518;font-size:1.2em}
@media only screen and (min-width:768px){#toctitle{font-size:1.375em}
body.toc2{padding-left:15em;padding-right:0}
#toc.toc2{margin-top:0!important;background-color:#f8f8f7;position:fixed;width:15em;left:0;top:0;border-right:1px solid #efefed;border-top-width:0!important;border-bottom-width:0!important;z-index:1000;padding:1.25em 1em;height:100%;overflow:auto}
#toc.toc2 #toctitle{margin-top:0;margin-bottom:.8rem;font-size:1.2em}
#toc.toc2>ul{font-size:.9em;margin-bottom:0}
#toc.toc2 ul ul{margin-left:0;padding-left:1em}
#toc.toc2 ul.sectlevel0 ul.sectlevel1{padding-left:0;margin-top:.5em;margin-bottom:.5em}
body.toc2.toc-right{padding-left:0;padding-right:15em}
body.toc2.toc-right #toc.toc2{border-right-width:0;border-left:1px solid #efefed;left:auto;right:0}}
@media only screen and (min-width:1280px){body.toc2{padding-left:20em;padding-right:0}
#toc.toc2{width:20em}
#toc.toc2 #toctitle{font-size:1.375em}
#toc.toc2>ul{font-size:.95em}
#toc.toc2 ul ul{padding-left:1.25em}
body.toc2.toc-right{padding-left:0;padding-right:20em}}
#content #toc{border-style:solid;border-width:1px;border-color:#e0e0dc;margin-bottom:1.25em;padding:1.25em;background:#f8f8f7;-webkit-border-radius:4px;border-radius:4px}
#content #toc>:first-child{margin-top:0}
#content #toc>:last-child{margin-bottom:0}
#footer{max-width:100%;background-color:rgba(0,0,0,.8);padding:1.25em}
#footer-text{color:rgba(255,255,255,.8);line-height:1.44}
.sect1{padding-bottom:.625em}
@media only screen and (min-width:768px){.sect1{padding-bottom:1.25em}}
.sect1+.sect1{border-top:1px solid #efefed}
#content h1>a.anchor,h2>a.anchor,h3>a.anchor,#toctitle>a.anchor,.sidebarblock>.content>.title>a.anchor,h4>a.anchor,h5>a.anchor,h6>a.anchor{position:absolute;z-index:1001;width:1.5ex;margin-left:-1.5ex;display:block;text-decoration:none!important;visibility:hidden;text-align:center;font-weight:400}
#content h1>a.anchor:before,h2>a.anchor:before,h3>a.anchor:before,#toctitle>a.anchor:before,.sidebarblock>.content>.title>a.anchor:before,h4>a.anchor:before,h5>a.anchor:before,h6>a.anchor:before{content:"\00A7";font-size:.85em;display:block;padding-top:.1em}
#content h1:hover>a.anchor,#content h1>a.anchor:hover,h2:hover>a.anchor,h2>a.anchor:hover,h3:hover>a.anchor,#toctitle:hover>a.anchor,.sidebarblock>.content>.title:hover>a.anchor,h3>a.anchor:hover,#toctitle>a.anchor:hover,.sidebarblock>.content>.title>a.anchor:hover,h4:hover>a.anchor,h4>a.anchor:hover,h5:hover>a.anchor,h5>a.anchor:hover,h6:hover>a.anchor,h6>a.anchor:hover{visibility:visible}
#content h1>a.link,h2>a.link,h3>a.link,#toctitle>a.link,.sidebarblock>.content>.title>a.link,h4>a.link,h5>a.link,h6>a.link{color:#ba3925;text-decoration:none}
#content h1>a.link:hover,h2>a.link:hover,h3>a.link:hover,#toctitle>a.link:hover,.sidebarblock>.content>.title>a.link:hover,h4>a.link:hover,h5>a.link:hover,h6>a.link:hover{color:#a53221}
.audioblock,.imageblock,.literalblock,.listingblock,.stemblock,.videoblock{margin-bottom:1.25em}
.admonitionblock td.content>.title,.audioblock>.title,.exampleblock>.title,.imageblock>.title,.listingblock>.title,.literalblock>.title,.stemblock>.title,.openblock>.title,.paragraph>.title,.quoteblock>.title,table.tableblock>.title,.verseblock>.title,.videoblock>.title,.dlist>.title,.olist>.title,.ulist>.title,.qlist>.title,.hdlist>.title{text-rendering:optimizeLegibility;text-align:left;font-family:"Noto Serif","DejaVu Serif",serif;font-size:1rem;font-style:italic}
table.tableblock>caption.title{white-space:nowrap;overflow:visible;max-width:0}
.paragraph.lead>p,#preamble>.sectionbody>.paragraph:first-of-type p{color:rgba(0,0,0,.85)}
table.tableblock #preamble>.sectionbody>.paragraph:first-of-type p{font-size:inherit}
.admonitionblock>table{border-collapse:separate;border:0;background:none;width:100%}
.admonitionblock>table td.icon{text-align:center;width:80px}
.admonitionblock>table td.icon img{max-width:none}
.admonitionblock>table td.icon .title{font-weight:bold;font-family:"Open Sans","DejaVu Sans",sans-serif;text-transform:uppercase}
.admonitionblock>table td.content{padding-left:1.125em;padding-right:1.25em;border-left:1px solid #ddddd8;color:rgba(0,0,0,.6)}
.admonitionblock>table td.content>:last-child>:last-child{margin-bottom:0}
.exampleblock>.content{border-style:solid;border-width:1px;border-color:#e6e6e6;margin-bottom:1.25em;padding:1.25em;background:#fff;-webkit-border-radius:4px;border-radius:4px}
.exampleblock>.content>:first-child{margin-top:0}
.exampleblock>.content>:last-child{margin-bottom:0}
.sidebarblock{border-style:solid;border-width:1px;border-color:#e0e0dc;margin-bottom:1.25em;padding:1.25em;background:#f8f8f7;-webkit-border-radius:4px;border-radius:4px}
.sidebarblock>:first-child{margin-top:0}
.sidebarblock>:last-child{margin-bottom:0}
.sidebarblock>.content>.title{color:#7a2518;margin-top:0;text-align:center}
.exampleblock>.content>:last-child>:last-child,.exampleblock>.content .olist>ol>li:last-child>:last-child,.exampleblock>.content .ulist>ul>li:last-child>:last-child,.exampleblock>.content .qlist>ol>li:last-child>:last-child,.sidebarblock>.content>:last-child>:last-child,.sidebarblock>.content .olist>ol>li:last-child>:last-child,.sidebarblock>.content .ulist>ul>li:last-child>:last-child,.sidebarblock>.content .qlist>ol>li:last-child>:last-child{margin-bottom:0}
.literalblock pre,.listingblock pre:not(.highlight),.listingblock pre[class="highlight"],.listingblock pre[class^="highlight "],.listingblock pre.CodeRay,.listingblock pre.prettyprint{background:#f7f7f8}
.sidebarblock .literalblock pre,.sidebarblock .listingblock pre:not(.highlight),.sidebarblock .listingblock pre[class="highlight"],.sidebarblock .listingblock pre[class^="highlight "],.sidebarblock .listingblock pre.CodeRay,.sidebarblock .listingblock pre.prettyprint{background:#f2f1f1}
.literalblock pre,.literalblock pre[class],.listingblock pre,.listingblock pre[class]{-webkit-border-radius:4px;border-radius:4px;word-wrap:break-word;padding:1em;font-size:.8125em}
.literalblock pre.nowrap,.literalblock pre[class].nowrap,.listingblock pre.nowrap,.listingblock pre[class].nowrap{overflow-x:auto;white-space:pre;word-wrap:normal}
@media only screen and (min-width:768px){.literalblock pre,.literalblock pre[class],.listingblock pre,.listingblock pre[class]{font-size:.90625em}}
@media only screen and (min-width:1280px){.literalblock pre,.literalblock pre[class],.listingblock pre,.listingblock pre[class]{font-size:1em}}
.literalblock.output pre{color:#f7f7f8;background-color:rgba(0,0,0,.9)}
.listingblock pre.highlightjs{padding:0}
.listingblock pre.highlightjs>code{padding:1em;-webkit-border-radius:4px;border-radius:4px}
.listingblock pre.prettyprint{border-width:0}
.listingblock>.content{position:relative}
.listingblock code[data-lang]:before{display:none;content:attr(data-lang);position:absolute;font-size:.75em;top:.425rem;right:.5rem;line-height:1;text-transform:uppercase;color:#999}
.listingblock:hover code[data-lang]:before{display:block}
.listingblock.terminal pre .command:before{content:attr(data-prompt);padding-right:.5em;color:#999}
.listingblock.terminal pre .command:not([data-prompt]):before{content:"$"}
table.pyhltable{border-collapse:separate;border:0;margin-bottom:0;background:none}
table.pyhltable td{vertical-align:top;padding-top:0;padding-bottom:0;line-height:1.45}
table.pyhltable td.code{padding-left:.75em;padding-right:0}
pre.pygments .lineno,table.pyhltable td:not(.code){color:#999;padding-left:0;padding-right:.5em;border-right:1px solid #ddddd8}
pre.pygments .lineno{display:inline-block;margin-right:.25em}
table.pyhltable .linenodiv{background:none!important;padding-right:0!important}
.quoteblock{margin:0 1em 1.25em 1.5em;display:table}
.quoteblock>.title{margin-left:-1.5em;margin-bottom:.75em}
.quoteblock blockquote,.quoteblock blockquote p{color:rgba(0,0,0,.85);font-size:1.15rem;line-height:1.75;word-spacing:.1em;letter-spacing:0;font-style:italic;text-align:justify}
.quoteblock blockquote{margin:0;padding:0;border:0}
.quoteblock blockquote:before{content:"\201c";float:left;font-size:2.75em;font-weight:bold;line-height:.6em;margin-left:-.6em;color:#7a2518;text-shadow:0 1px 2px rgba(0,0,0,.1)}
.quoteblock blockquote>.paragraph:last-child p{margin-bottom:0}
.quoteblock .attribution{margin-top:.5em;margin-right:.5ex;text-align:right}
.quoteblock .quoteblock{margin-left:0;margin-right:0;padding:.5em 0;border-left:3px solid rgba(0,0,0,.6)}
.quoteblock .quoteblock blockquote{padding:0 0 0 .75em}
.quoteblock .quoteblock blockquote:before{display:none}
.verseblock{margin:0 1em 1.25em 1em}
.verseblock pre{font-family:"Open Sans","DejaVu Sans",sans;font-size:1.15rem;color:rgba(0,0,0,.85);font-weight:300;text-rendering:optimizeLegibility}
.verseblock pre strong{font-weight:400}
.verseblock .attribution{margin-top:1.25rem;margin-left:.5ex}
.quoteblock .attribution,.verseblock .attribution{font-size:.9375em;line-height:1.45;font-style:italic}
.quoteblock .attribution br,.verseblock .attribution br{display:none}
.quoteblock .attribution cite,.verseblock .attribution cite{display:block;letter-spacing:-.025em;color:rgba(0,0,0,.6)}
.quoteblock.abstract{margin:0 0 1.25em 0;display:block}
.quoteblock.abstract blockquote,.quoteblock.abstract blockquote p{text-align:left;word-spacing:0}
.quoteblock.abstract blockquote:before,.quoteblock.abstract blockquote p:first-of-type:before{display:none}
table.tableblock{max-width:100%;border-collapse:separate}
table.tableblock td>.paragraph:last-child p>p:last-child,table.tableblock th>p:last-child,table.tableblock td>p:last-child{margin-bottom:0}
table.tableblock,th.tableblock,td.tableblock{border:0 solid #dedede}
table.grid-all th.tableblock,table.grid-all td.tableblock{border-width:0 1px 1px 0}
table.grid-all tfoot>tr>th.tableblock,table.grid-all tfoot>tr>td.tableblock{border-width:1px 1px 0 0}
table.grid-cols th.tableblock,table.grid-cols td.tableblock{border-width:0 1px 0 0}
table.grid-all *>tr>.tableblock:last-child,table.grid-cols *>tr>.tableblock:last-child{border-right-width:0}
table.grid-rows th.tableblock,table.grid-rows td.tableblock{border-width:0 0 1px 0}
table.grid-all tbody>tr:last-child>th.tableblock,table.grid-all tbody>tr:last-child>td.tableblock,table.grid-all thead:last-child>tr>th.tableblock,table.grid-rows tbody>tr:last-child>th.tableblock,table.grid-rows tbody>tr:last-child>td.tableblock,table.grid-rows thead:last-child>tr>th.tableblock{border-bottom-width:0}
table.grid-rows tfoot>tr>th.tableblock,table.grid-rows tfoot>tr>td.tableblock{border-width:1px 0 0 0}
table.frame-all{border-width:1px}
table.frame-sides{border-width:0 1px}
table.frame-topbot{border-width:1px 0}
th.halign-left,td.halign-left{text-align:left}
th.halign-right,td.halign-right{text-align:right}
th.halign-center,td.halign-center{text-align:center}
th.valign-top,td.valign-top{vertical-align:top}
th.valign-bottom,td.valign-bottom{vertical-align:bottom}
th.valign-middle,td.valign-middle{vertical-align:middle}
table thead th,table tfoot th{font-weight:bold}
tbody tr th{display:table-cell;line-height:1.6;background:#f7f8f7}
tbody tr th,tbody tr th p,tfoot tr th,tfoot tr th p{color:rgba(0,0,0,.8);font-weight:bold}
p.tableblock>code:only-child{background:none;padding:0}
p.tableblock{font-size:1em}
td>div.verse{white-space:pre}
ol{margin-left:1.75em}
ul li ol{margin-left:1.5em}
dl dd{margin-left:1.125em}
dl dd:last-child,dl dd:last-child>:last-child{margin-bottom:0}
ol>li p,ul>li p,ul dd,ol dd,.olist .olist,.ulist .ulist,.ulist .olist,.olist .ulist{margin-bottom:.625em}
ul.unstyled,ol.unnumbered,ul.checklist,ul.none{list-style-type:none}
ul.unstyled,ol.unnumbered,ul.checklist{margin-left:.625em}
ul.checklist li>p:first-child>.fa-square-o:first-child,ul.checklist li>p:first-child>.fa-check-square-o:first-child{width:1em;font-size:.85em}
ul.checklist li>p:first-child>input[type="checkbox"]:first-child{width:1em;position:relative;top:1px}
ul.inline{margin:0 auto .625em auto;margin-left:-1.375em;margin-right:0;padding:0;list-style:none;overflow:hidden}
ul.inline>li{list-style:none;float:left;margin-left:1.375em;display:block}
ul.inline>li>*{display:block}
.unstyled dl dt{font-weight:400;font-style:normal}
ol.arabic{list-style-type:decimal}
ol.decimal{list-style-type:decimal-leading-zero}
ol.loweralpha{list-style-type:lower-alpha}
ol.upperalpha{list-style-type:upper-alpha}
ol.lowerroman{list-style-type:lower-roman}
ol.upperroman{list-style-type:upper-roman}
ol.lowergreek{list-style-type:lower-greek}
.hdlist>table,.colist>table{border:0;background:none}
.hdlist>table>tbody>tr,.colist>table>tbody>tr{background:none}
td.hdlist1,td.hdlist2{vertical-align:top;padding:0 .625em}
td.hdlist1{font-weight:bold;padding-bottom:1.25em}
.literalblock+.colist,.listingblock+.colist{margin-top:-.5em}
.colist>table tr>td:first-of-type{padding:0 .75em;line-height:1}
.colist>table tr>td:last-of-type{padding:.25em 0}
.thumb,.th{line-height:0;display:inline-block;border:solid 4px #fff;-webkit-box-shadow:0 0 0 1px #ddd;box-shadow:0 0 0 1px #ddd}
.imageblock.left,.imageblock[style*="float: left"]{margin:.25em .625em 1.25em 0}
.imageblock.right,.imageblock[style*="float: right"]{margin:.25em 0 1.25em .625em}
.imageblock>.title{margin-bottom:0}
.imageblock.thumb,.imageblock.th{border-width:6px}
.imageblock.thumb>.title,.imageblock.th>.title{padding:0 .125em}
.image.left,.image.right{margin-top:.25em;margin-bottom:.25em;display:inline-block;line-height:0}
.image.left{margin-right:.625em}
.image.right{margin-left:.625em}
a.image{text-decoration:none;display:inline-block}
a.image object{pointer-events:none}
sup.footnote,sup.footnoteref{font-size:.875em;position:static;vertical-align:super}
sup.footnote a,sup.footnoteref a{text-decoration:none}
sup.footnote a:active,sup.footnoteref a:active{text-decoration:underline}
#footnotes{padding-top:.75em;padding-bottom:.75em;margin-bottom:.625em}
#footnotes hr{width:20%;min-width:6.25em;margin:-.25em 0 .75em 0;border-width:1px 0 0 0}
#footnotes .footnote{padding:0 .375em 0 .225em;line-height:1.3334;font-size:.875em;margin-left:1.2em;text-indent:-1.05em;margin-bottom:.2em}
#footnotes .footnote a:first-of-type{font-weight:bold;text-decoration:none}
#footnotes .footnote:last-of-type{margin-bottom:0}
#content #footnotes{margin-top:-.625em;margin-bottom:0;padding:.75em 0}
.gist .file-data>table{border:0;background:#fff;width:100%;margin-bottom:0}
.gist .file-data>table td.line-data{width:99%}
div.unbreakable{page-break-inside:avoid}
.big{font-size:larger}
.small{font-size:smaller}
.underline{text-decoration:underline}
.overline{text-decoration:overline}
.line-through{text-decoration:line-through}
.aqua{color:#00bfbf}
.aqua-background{background-color:#00fafa}
.black{color:#000}
.black-background{background-color:#000}
.blue{color:#0000bf}
.blue-background{background-color:#0000fa}
.fuchsia{color:#bf00bf}
.fuchsia-background{background-color:#fa00fa}
.gray{color:#606060}
.gray-background{background-color:#7d7d7d}
.green{color:#006000}
.green-background{background-color:#007d00}
.lime{color:#00bf00}
.lime-background{background-color:#00fa00}
.maroon{color:#600000}
.maroon-background{background-color:#7d0000}
.navy{color:#000060}
.navy-background{background-color:#00007d}
.olive{color:#606000}
.olive-background{background-color:#7d7d00}
.purple{color:#600060}
.purple-background{background-color:#7d007d}
.red{color:#bf0000}
.red-background{background-color:#fa0000}
.silver{color:#909090}
.silver-background{background-color:#bcbcbc}
.teal{color:#006060}
.teal-background{background-color:#007d7d}
.white{color:#bfbfbf}
.white-background{background-color:#fafafa}
.yellow{color:#bfbf00}
.yellow-background{background-color:#fafa00}
span.icon>.fa{cursor:default}
.admonitionblock td.icon [class^="fa icon-"]{font-size:2.5em;text-shadow:1px 1px 2px rgba(0,0,0,.5);cursor:default}
.admonitionblock td.icon .icon-note:before{content:"\f05a";color:#19407c}
.admonitionblock td.icon .icon-tip:before{content:"\f0eb";text-shadow:1px 1px 2px rgba(155,155,0,.8);color:#111}
.admonitionblock td.icon .icon-warning:before{content:"\f071";color:#bf6900}
.admonitionblock td.icon .icon-caution:before{content:"\f06d";color:#bf3400}
.admonitionblock td.icon .icon-important:before{content:"\f06a";color:#bf0000}
.conum[data-value]{display:inline-block;color:#fff!important;background-color:rgba(0,0,0,.8);-webkit-border-radius:100px;border-radius:100px;text-align:center;font-size:.75em;width:1.67em;height:1.67em;line-height:1.67em;font-family:"Open Sans","DejaVu Sans",sans-serif;font-style:normal;font-weight:bold}
.conum[data-value] *{color:#fff!important}
.conum[data-value]+b{display:none}
.conum[data-value]:after{content:attr(data-value)}
pre .conum[data-value]{position:relative;top:-.125em}
b.conum *{color:inherit!important}
.conum:not([data-value]):empty{display:none}
dt,th.tableblock,td.content,div.footnote{text-rendering:optimizeLegibility}
h1,h2,p,td.content,span.alt{letter-spacing:-.01em}
p strong,td.content strong,div.footnote strong{letter-spacing:-.005em}
p,blockquote,dt,td.content,span.alt{font-size:1.0625rem}
p{margin-bottom:1.25rem}
.sidebarblock p,.sidebarblock dt,.sidebarblock td.content,p.tableblock{font-size:1em}
.exampleblock>.content{background-color:#fffef7;border-color:#e0e0dc;-webkit-box-shadow:0 1px 4px #e0e0dc;box-shadow:0 1px 4px #e0e0dc}
.print-only{display:none!important}
@media print{@page{margin:1.25cm .75cm}
*{-webkit-box-shadow:none!important;box-shadow:none!important;text-shadow:none!important}
a{color:inherit!important;text-decoration:underline!important}
a.bare,a[href^="#"],a[href^="mailto:"]{text-decoration:none!important}
a[href^="http:"]:not(.bare):after,a[href^="https:"]:not(.bare):after{content:"(" attr(href) ")";display:inline-block;font-size:.875em;padding-left:.25em}
abbr[title]:after{content:" (" attr(title) ")"}
pre,blockquote,tr,img,object,svg{page-break-inside:avoid}
thead{display:table-header-group}
svg{max-width:100%}
p,blockquote,dt,td.content{font-size:1em;orphans:3;widows:3}
h2,h3,#toctitle,.sidebarblock>.content>.title{page-break-after:avoid}
#toc,.sidebarblock,.exampleblock>.content{background:none!important}
#toc{border-bottom:1px solid #ddddd8!important;padding-bottom:0!important}
.sect1{padding-bottom:0!important}
.sect1+.sect1{border:0!important}
#header>h1:first-child{margin-top:1.25rem}
body.book #header{text-align:center}
body.book #header>h1:first-child{border:0!important;margin:2.5em 0 1em 0}
body.book #header .details{border:0!important;display:block;padding:0!important}
body.book #header .details span:first-child{margin-left:0!important}
body.book #header .details br{display:block}
body.book #header .details br+span:before{content:none!important}
body.book #toc{border:0!important;text-align:left!important;padding:0!important;margin:0!important}
body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-break-before:always}
.listingblock code[data-lang]:before{display:block}
#footer{background:none!important;padding:0 .9375em}
#footer-text{color:rgba(0,0,0,.6)!important;font-size:.9em}
.hide-on-print{display:none!important}
.print-only{display:block!important}
.hide-for-print{display:none!important}
.show-for-print{display:inherit!important}}
</style>
<style>
.listingblock .pygments .hll { background-color: #ffffcc }
.listingblock .pygments  { background: #f8f8f8; }
.listingblock .pygments .tok-c { color: #408080; font-style: italic } /* Comment */
.listingblock .pygments .tok-err { border: 1px solid #FF0000 } /* Error */
.listingblock .pygments .tok-k { color: #008000; font-weight: bold } /* Keyword */
.listingblock .pygments .tok-o { color: #666666 } /* Operator */
.listingblock .pygments .tok-ch { color: #408080; font-style: italic } /* Comment.Hashbang */
.listingblock .pygments .tok-cm { color: #408080; font-style: italic } /* Comment.Multiline */
.listingblock .pygments .tok-cp { color: #BC7A00 } /* Comment.Preproc */
.listingblock .pygments .tok-cpf { color: #408080; font-style: italic } /* Comment.PreprocFile */
.listingblock .pygments .tok-c1 { color: #408080; font-style: italic } /* Comment.Single */
.listingblock .pygments .tok-cs { color: #408080; font-style: italic } /* Comment.Special */
.listingblock .pygments .tok-gd { color: #A00000 } /* Generic.Deleted */
.listingblock .pygments .tok-ge { font-style: italic } /* Generic.Emph */
.listingblock .pygments .tok-gr { color: #FF0000 } /* Generic.Error */
.listingblock .pygments .tok-gh { color: #000080; font-weight: bold } /* Generic.Heading */
.listingblock .pygments .tok-gi { color: #00A000 } /* Generic.Inserted */
.listingblock .pygments .tok-go { color: #888888 } /* Generic.Output */
.listingblock .pygments .tok-gp { color: #000080; font-weight: bold } /* Generic.Prompt */
.listingblock .pygments .tok-gs { font-weight: bold } /* Generic.Strong */
.listingblock .pygments .tok-gu { color: #800080; font-weight: bold } /* Generic.Subheading */
.listingblock .pygments .tok-gt { color: #0044DD } /* Generic.Traceback */
.listingblock .pygments .tok-kc { color: #008000; font-weight: bold } /* Keyword.Constant */
.listingblock .pygments .tok-kd { color: #008000; font-weight: bold } /* Keyword.Declaration */
.listingblock .pygments .tok-kn { color: #008000; font-weight: bold } /* Keyword.Namespace */
.listingblock .pygments .tok-kp { color: #008000 } /* Keyword.Pseudo */
.listingblock .pygments .tok-kr { color: #008000; font-weight: bold } /* Keyword.Reserved */
.listingblock .pygments .tok-kt { color: #B00040 } /* Keyword.Type */
.listingblock .pygments .tok-m { color: #666666 } /* Literal.Number */
.listingblock .pygments .tok-s { color: #BA2121 } /* Literal.String */
.listingblock .pygments .tok-na { color: #7D9029 } /* Name.Attribute */
.listingblock .pygments .tok-nb { color: #008000 } /* Name.Builtin */
.listingblock .pygments .tok-nc { color: #0000FF; font-weight: bold } /* Name.Class */
.listingblock .pygments .tok-no { color: #880000 } /* Name.Constant */
.listingblock .pygments .tok-nd { color: #AA22FF } /* Name.Decorator */
.listingblock .pygments .tok-ni { color: #999999; font-weight: bold } /* Name.Entity */
.listingblock .pygments .tok-ne { color: #D2413A; font-weight: bold } /* Name.Exception */
.listingblock .pygments .tok-nf { color: #0000FF } /* Name.Function */
.listingblock .pygments .tok-nl { color: #A0A000 } /* Name.Label */
.listingblock .pygments .tok-nn { color: #0000FF; font-weight: bold } /* Name.Namespace */
.listingblock .pygments .tok-nt { color: #008000; font-weight: bold } /* Name.Tag */
.listingblock .pygments .tok-nv { color: #19177C } /* Name.Variable */
.listingblock .pygments .tok-ow { color: #AA22FF; font-weight: bold } /* Operator.Word */
.listingblock .pygments .tok-w { color: #bbbbbb } /* Text.Whitespace */
.listingblock .pygments .tok-mb { color: #666666 } /* Literal.Number.Bin */
.listingblock .pygments .tok-mf { color: #666666 } /* Literal.Number.Float */
.listingblock .pygments .tok-mh { color: #666666 } /* Literal.Number.Hex */
.listingblock .pygments .tok-mi { color: #666666 } /* Literal.Number.Integer */
.listingblock .pygments .tok-mo { color: #666666 } /* Literal.Number.Oct */
.listingblock .pygments .tok-sa { color: #BA2121 } /* Literal.String.Affix */
.listingblock .pygments .tok-sb { color: #BA2121 } /* Literal.String.Backtick */
.listingblock .pygments .tok-sc { color: #BA2121 } /* Literal.String.Char */
.listingblock .pygments .tok-dl { color: #BA2121 } /* Literal.String.Delimiter */
.listingblock .pygments .tok-sd { color: #BA2121; font-style: italic } /* Literal.String.Doc */
.listingblock .pygments .tok-s2 { color: #BA2121 } /* Literal.String.Double */
.listingblock .pygments .tok-se { color: #BB6622; font-weight: bold } /* Literal.String.Escape */
.listingblock .pygments .tok-sh { color: #BA2121 } /* Literal.String.Heredoc */
.listingblock .pygments .tok-si { color: #BB6688; font-weight: bold } /* Literal.String.Interpol */
.listingblock .pygments .tok-sx { color: #008000 } /* Literal.String.Other */
.listingblock .pygments .tok-sr { color: #BB6688 } /* Literal.String.Regex */
.listingblock .pygments .tok-s1 { color: #BA2121 } /* Literal.String.Single */
.listingblock .pygments .tok-ss { color: #19177C } /* Literal.String.Symbol */
.listingblock .pygments .tok-bp { color: #008000 } /* Name.Builtin.Pseudo */
.listingblock .pygments .tok-fm { color: #0000FF } /* Name.Function.Magic */
.listingblock .pygments .tok-vc { color: #19177C } /* Name.Variable.Class */
.listingblock .pygments .tok-vg { color: #19177C } /* Name.Variable.Global */
.listingblock .pygments .tok-vi { color: #19177C } /* Name.Variable.Instance */
.listingblock .pygments .tok-vm { color: #19177C } /* Name.Variable.Magic */
.listingblock .pygments .tok-il { color: #666666 } /* Literal.Number.Integer.Long */
</style>
<!--
  Custom styles for Asciidoctor
  (C) 2016 Sébastien Helleu <flashcode@flashtux.org>
-->
<style>
#header,#content,#footnotes,#footer {
  max-width: none;
  padding-left: 3em;
  padding-right: 3em;
}
#header #revnumber {
  text-transform: none;
}
h1,h2,h3,h4,h5 {
  font-weight: bold;
}
.literalblock pre {
  font-family: monospace, 'Courier New', Courier;
  line-height: normal;
  font-size: .95em;
}
.keyseq kbd {
  font-size: .7em;
}
.tableblock kbd {
  font-size: .7438em;
}
.hex {
  padding: 0 .2em;
  border: 1px solid #88b;
  margin: 0 .2em;
  font-family: monospace;
}
</style>
</head>
<body class="article">
<div id="header">
<h1>WeeChat FAQ (Frequently Asked Questions)</h1>
<div class="details">
<span id="author" class="author">Sébastien Helleu</span><br>
<span id="email" class="email"><a href="mailto:flashcode@flashtux.org">flashcode@flashtux.org</a></span><br>
<span id="revnumber">version 1.6</span>
</div>
</div>
<div id="content">
<div id="preamble">
<div class="sectionbody">
<div class="paragraph">
<p>This document is written for WeeChat versions ≥ 0.3.0 but should preferably be
used with latest stable version of WeeChat.</p>
</div>
<div id="toc" class="toc">
<div id="toctitle" class="title">Table of Contents</div>
<ul class="sectlevel1">
<li><a href="#general">1. General</a>
<ul class="sectlevel2">
<li><a href="#weechat_name">1.1. Where does the name "WeeChat" come from?</a></li>
<li><a href="#why_choose_weechat">1.2. Why choose WeeChat? X-Chat and Irssi are so good&#8230;&#8203;</a></li>
</ul>
</li>
<li><a href="#compilation_install">2. Compilation / install</a>
<ul class="sectlevel2">
<li><a href="#gui">2.1. I heard about many GUIs for WeeChat. How can I compile/use them?</a></li>
<li><a href="#compile_git">2.2. I can&#8217;t compile WeeChat after cloning git repository, why?</a></li>
<li><a href="#compile_osx">2.3. How can I install WeeChat on OS X?</a></li>
<li><a href="#lost">2.4. I&#8217;ve launched WeeChat, but I&#8217;m lost, what can I do?</a></li>
</ul>
</li>
<li><a href="#display">3. Display</a>
<ul class="sectlevel2">
<li><a href="#charset">3.1. I don&#8217;t see some chars with accents, what can I do?</a></li>
<li><a href="#unicode_chars">3.2. Some unicode chars are displayed in terminal but not in WeeChat, why?</a></li>
<li><a href="#bars_background">3.3. Bars like title and status are not filled, background color stops after text, why?</a></li>
<li><a href="#screen_weird_chars">3.4. When I&#8217;m using weechat under screen/tmux, I have weird random chars, how do I fix that?</a></li>
<li><a href="#osx_display_broken">3.5. I compiled WeeChat under OS X, and I see "(null)" everywhere on screen, what&#8217;s wrong?</a></li>
<li><a href="#buffer_vs_window">3.6. I heard about "buffers" and "windows", what&#8217;s the difference?</a></li>
<li><a href="#buffers_list">3.7. How to display the buffers list on the left side?</a></li>
<li><a href="#customize_prefix">3.8. How can I reduce length of nicks or remove nick alignment in chat area?</a></li>
<li><a href="#input_bar_size">3.9. How to use command line with more than one line?</a></li>
<li><a href="#one_input_root_bar">3.10. Is it possible to display only one input bar for all windows (after split)?</a></li>
<li><a href="#terminal_copy_paste">3.11. How can I copy/paste text without pasting nicklist?</a></li>
<li><a href="#urls">3.12. How can I click on long URLs (more than one line)?</a></li>
<li><a href="#change_locale_without_quit">3.13. I want to change the language used by WeeChat for messages, but without exiting WeeChat, is it possible?</a></li>
<li><a href="#use_256_colors">3.14. How can I use 256 colors in WeeChat?</a></li>
<li><a href="#search_text">3.15. How can I search text in buffer (like /lastlog in irssi)?</a></li>
<li><a href="#terminal_focus">3.16. How can I execute commands when terminal gets/loses focus?</a></li>
<li><a href="#screen_paste">3.17. When WeeChat is running in screen, pasting text in another screen window adds ~0 and ~1 around text, why?</a></li>
</ul>
</li>
<li><a href="#key_bindings">4. Key bindings</a>
<ul class="sectlevel2">
<li><a href="#meta_keys">4.1. Some meta keys (alt + key) are not working, why?</a></li>
<li><a href="#customize_key_bindings">4.2. How can I customize key bindings?</a></li>
<li><a href="#jump_to_buffer_11_or_higher">4.3. What is the key to jump to buffer 11 (or higher number)?</a></li>
<li><a href="#global_history">4.4. How to use global history (instead of buffer history) with up and down keys?</a></li>
</ul>
</li>
<li><a href="#mouse">5. Mouse</a>
<ul class="sectlevel2">
<li><a href="#mouse_not_working">5.1. Mouse is not working at all, what can I do?</a></li>
<li><a href="#mouse_coords">5.2. Mouse does nothing for X or Y greater than 94 (or 222), why?</a></li>
<li><a href="#mouse_select_paste">5.3. How can I select or paste text in terminal when mouse is enabled in WeeChat?</a></li>
</ul>
</li>
<li><a href="#irc">6. IRC</a>
<ul class="sectlevel2">
<li><a href="#irc_ssl_connection">6.1. I have some problems when connecting to a server using SSL, what can I do?</a></li>
<li><a href="#irc_ssl_handshake_error">6.2. When connecting to server with SSL, I see only error "TLS handshake failed", what can I do?</a></li>
<li><a href="#irc_ssl_freenode">6.3. How can I connect to freenode server using SSL?</a></li>
<li><a href="#irc_oauth">6.4. How to connect to a server that requires "oauth"?</a></li>
<li><a href="#irc_sasl">6.5. How can I be identified before joining channels?</a></li>
<li><a href="#ignore_vs_filter">6.6. What is the difference between the /ignore and /filter commands?</a></li>
<li><a href="#filter_irc_join_part_quit">6.7. How can I filter join/part/quit messages on IRC channels?</a></li>
<li><a href="#filter_irc_join_channel_messages">6.8. How can I filter some messages displayed when I join an IRC channel?</a></li>
<li><a href="#filter_voice_messages">6.9. How can I filter voice messages (eg on Bitlbee server)?</a></li>
<li><a href="#color_away_nicks">6.10. How can I see away nicks in nicklist?</a></li>
<li><a href="#highlight_notification">6.11. How can I be warned when someone highlights me on a channel?</a></li>
<li><a href="#irc_target_buffer">6.12. How can I change target buffer for commands on merged buffers (like buffer with servers)?</a></li>
</ul>
</li>
<li><a href="#plugins_scripts">7. Plugins / scripts</a>
<ul class="sectlevel2">
<li><a href="#openbsd_plugins">7.1. I&#8217;m using OpenBSD and WeeChat does not load any plugins, what&#8217;s wrong?</a></li>
<li><a href="#install_scripts">7.2. How can I install scripts? Are scripts compatible with other IRC clients?</a></li>
</ul>
</li>
<li><a href="#settings">8. Settings</a>
<ul class="sectlevel2">
<li><a href="#memory_usage">8.1. How can I tweak WeeChat to consume less memory?</a></li>
<li><a href="#cpu_usage">8.2. How can I tweak WeeChat to use less CPU?</a></li>
<li><a href="#security">8.3. I am paranoid about security, which settings could I change to be even more secure?</a></li>
</ul>
</li>
<li><a href="#development">9. Development</a>
<ul class="sectlevel2">
<li><a href="#bug_task_patch">9.1. How should I report bugs, ask for new features or send patches?</a></li>
<li><a href="#gdb_error_threads">9.2. When I run WeeChat under gdb, there is error about threads, what can I do?</a></li>
<li><a href="#supported_os">9.3. What is the list of supported platforms for WeeChat? Will it be ported to other operating systems?</a></li>
<li><a href="#help_developers">9.4. I want to help WeeChat developers. What can I do?</a></li>
<li><a href="#donate">9.5. Can I give money or other things to WeeChat developers?</a></li>
</ul>
</li>
</ul>
</div>
</div>
</div>
<div class="sect1">
<h2 id="general"><a class="anchor" href="#general"></a>1. General</h2>
<div class="sectionbody">
<div class="sect2">
<h3 id="weechat_name"><a class="anchor" href="#weechat_name"></a>1.1. Where does the name "WeeChat" come from?</h3>
<div class="paragraph">
<p>"Wee" is a recursive acronym and stands for "Wee Enhanced Environment".
So complete name is "Wee Enhanced Environment for Chat".</p>
</div>
<div class="paragraph">
<p>"Wee" also means "very small" (and yes, there is other meaning, but it does not
apply to WeeChat!).</p>
</div>
</div>
<div class="sect2">
<h3 id="why_choose_weechat"><a class="anchor" href="#why_choose_weechat"></a>1.2. Why choose WeeChat? X-Chat and Irssi are so good&#8230;&#8203;</h3>
<div class="paragraph">
<p>Because WeeChat is very light and brings innovating features.</p>
</div>
<div class="paragraph">
<p>More info on this page: <a href="https://weechat.org/about/features" class="bare">https://weechat.org/about/features</a></p>
</div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="compilation_install"><a class="anchor" href="#compilation_install"></a>2. Compilation / install</h2>
<div class="sectionbody">
<div class="sect2">
<h3 id="gui"><a class="anchor" href="#gui"></a>2.1. I heard about many GUIs for WeeChat. How can I compile/use them?</h3>
<div class="paragraph">
<p>Some remote GUIs are available, see the links on features page:
<a href="https://weechat.org/about/features" class="bare">https://weechat.org/about/features</a></p>
</div>
</div>
<div class="sect2">
<h3 id="compile_git"><a class="anchor" href="#compile_git"></a>2.2. I can&#8217;t compile WeeChat after cloning git repository, why?</h3>
<div class="paragraph">
<p>The recommended way to compile WeeChat is with cmake.</p>
</div>
<div class="paragraph">
<p>If you&#8217;re compiling with autotools (and not cmake), check that you have latest
version of autoconf and automake.</p>
</div>
<div class="paragraph">
<p>The other way is to install the "devel package", which needs less dependencies.
This package is built almost every day using git repository. Note that this
package may not correspond exactly to git base and that it&#8217;s less convenient
than git cloning for installing updates.</p>
</div>
</div>
<div class="sect2">
<h3 id="compile_osx"><a class="anchor" href="#compile_osx"></a>2.3. How can I install WeeChat on OS X?</h3>
<div class="paragraph">
<p>It is recommended to use <a href="http://brew.sh/">Homebrew</a>, you can get help with:</p>
</div>
<div class="listingblock">
<div class="content">
<pre>brew info weechat</pre>
</div>
</div>
<div class="paragraph">
<p>You can install WeeChat with this command:</p>
</div>
<div class="listingblock">
<div class="content">
<pre>brew install weechat --with-aspell --with-curl --with-python --with-perl --with-ruby --with-lua --with-guile</pre>
</div>
</div>
</div>
<div class="sect2">
<h3 id="lost"><a class="anchor" href="#lost"></a>2.4. I&#8217;ve launched WeeChat, but I&#8217;m lost, what can I do?</h3>
<div class="paragraph">
<p>For help you can type <code>/help</code>. For help about a command, type <code>/help command</code>.
Keys and commands are listed in documentation.</p>
</div>
<div class="paragraph">
<p>It&#8217;s recommended for new users to read the quickstart guide:
<a href="https://weechat.org/doc" class="bare">https://weechat.org/doc</a></p>
</div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="display"><a class="anchor" href="#display"></a>3. Display</h2>
<div class="sectionbody">
<div class="sect2">
<h3 id="charset"><a class="anchor" href="#charset"></a>3.1. I don&#8217;t see some chars with accents, what can I do?</h3>
<div class="paragraph">
<p>It&#8217;s common issue, please read carefully and check <strong>ALL</strong> solutions below:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>check that weechat is linked to libncursesw (warning: needed on most
distributions but not all): <code>ldd /path/to/weechat</code></p>
</li>
<li>
<p>check that the "charset" plugin is loaded with <code>/plugin</code> command (if it is
not, then you probably need the "weechat-plugins" package)</p>
</li>
<li>
<p>check the output of command <code>/charset</code> (on core buffer). You should see
<em>ISO-XXXXXX</em> or <em>UTF-8</em> for terminal charset. If you see <em>ANSI_X3.4-1968</em> or
other values, your locale is probably wrong (fix your $LANG).</p>
</li>
<li>
<p>setup global decode value, for example:
<code>/set charset.default.decode "ISO-8859-15"</code></p>
</li>
<li>
<p>if you are using UTF-8 locale:</p>
<div class="ulist">
<ul>
<li>
<p>check that your terminal is UTF-8 ready (terminal recommended for UTF-8 is
rxvt-unicode)</p>
</li>
<li>
<p>if you are using screen, check that it is run with UTF-8 mode
(&#8220;defutf8 on&#8221; in ~/.screenrc or <code>screen -U</code> to run screen)</p>
</li>
</ul>
</div>
</li>
<li>
<p>check that option <em>weechat.look.eat_newline_glitch</em> is off (this option may
cause display bugs)</p>
</li>
</ul>
</div>
<div class="admonitionblock note">
<table>
<tr>
<td class="icon">
<div class="title">Note</div>
</td>
<td class="content">
UTF-8 locale is recommended for WeeChat. If you&#8217;re using ISO or other
locale, please check that <strong>all</strong> your settings (terminal, screen, ..) are ISO
and <strong>not</strong> UTF-8.
</td>
</tr>
</table>
</div>
</div>
<div class="sect2">
<h3 id="unicode_chars"><a class="anchor" href="#unicode_chars"></a>3.2. Some unicode chars are displayed in terminal but not in WeeChat, why?</h3>
<div class="paragraph">
<p>This may be caused by a libc bug in function <em>wcwidth</em>, which should be fixed
in glibc 2.22 (maybe not yet available in your distribution).</p>
</div>
<div class="paragraph">
<p>There is a workaround to use the fixed <em>wcwidth</em> function:
<a href="https://blog.nytsoi.net/2015/05/04/emoji-support-for-weechat" class="bare">https://blog.nytsoi.net/2015/05/04/emoji-support-for-weechat</a></p>
</div>
<div class="paragraph">
<p>See this bug report for more information:
<a href="https://github.com/weechat/weechat/issues/79" class="bare">https://github.com/weechat/weechat/issues/79</a></p>
</div>
</div>
<div class="sect2">
<h3 id="bars_background"><a class="anchor" href="#bars_background"></a>3.3. Bars like title and status are not filled, background color stops after text, why?</h3>
<div class="paragraph">
<p>This may be caused by a bad value of the TERM variable in your shell (look at
output of <code>echo $TERM</code> in your terminal).</p>
</div>
<div class="paragraph">
<p>Depending on where you launch WeeChat, you should have:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>if WeeChat runs locally or on a remote machine without screen nor tmux, it
depends on the terminal used: <em>xterm</em>, <em>xterm-256color</em>, <em>rxvt-unicode</em>,
<em>rxvt-256color</em>, &#8230;&#8203;</p>
</li>
<li>
<p>if WeeChat runs under screen, you should have <em>screen</em> or <em>screen-256color</em>,</p>
</li>
<li>
<p>if WeeChat runs under tmux, you should have <em>tmux</em>, <em>tmux-256color</em>,
<em>screen</em> or <em>screen-256color</em>.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>If needed, fix your TERM variable: <code>export TERM="xxx"</code>.</p>
</div>
</div>
<div class="sect2">
<h3 id="screen_weird_chars"><a class="anchor" href="#screen_weird_chars"></a>3.4. When I&#8217;m using weechat under screen/tmux, I have weird random chars, how do I fix that?</h3>
<div class="paragraph">
<p>This may be caused by bad value of the TERM variable in your shell (look at
output of <code>echo $TERM</code> in your terminal, <strong>outside screen/tmux</strong>).</p>
</div>
<div class="paragraph">
<p>For example, <em>xterm-color</em> may display such weird chars, you can use <em>xterm</em>
which is OK (like many other values).</p>
</div>
<div class="paragraph">
<p>If needed, fix your TERM variable: <code>export TERM="xxx"</code>.</p>
</div>
</div>
<div class="sect2">
<h3 id="osx_display_broken"><a class="anchor" href="#osx_display_broken"></a>3.5. I compiled WeeChat under OS X, and I see "(null)" everywhere on screen, what&#8217;s wrong?</h3>
<div class="paragraph">
<p>If you compiled ncursesw yourself, try to use standard ncurses (that comes with
system).</p>
</div>
<div class="paragraph">
<p>Moreover, under OS X, it is recommended to install WeeChat with Homebrew package
manager.</p>
</div>
</div>
<div class="sect2">
<h3 id="buffer_vs_window"><a class="anchor" href="#buffer_vs_window"></a>3.6. I heard about "buffers" and "windows", what&#8217;s the difference?</h3>
<div class="paragraph">
<p>A <em>buffer</em> is composed by a number, a name, lines displayed (and some other
data).</p>
</div>
<div class="paragraph">
<p>A <em>window</em> is a screen area which displays a buffer. It is possible to split
your screen into many windows.</p>
</div>
<div class="paragraph">
<p>Each window displays one buffer. A buffer can be hidden (not displayed by a
window) or displayed by one or more windows.</p>
</div>
</div>
<div class="sect2">
<h3 id="buffers_list"><a class="anchor" href="#buffers_list"></a>3.7. How to display the buffers list on the left side?</h3>
<div class="paragraph">
<p>Use script <em>buffers.pl</em>:</p>
</div>
<div class="listingblock">
<div class="content">
<pre>/script install buffers.pl</pre>
</div>
</div>
<div class="paragraph">
<p>To limit size of bar:</p>
</div>
<div class="listingblock">
<div class="content">
<pre>/set weechat.bar.buffers.size_max 15</pre>
</div>
</div>
<div class="paragraph">
<p>To move bar to bottom:</p>
</div>
<div class="listingblock">
<div class="content">
<pre>/set weechat.bar.buffers.position bottom</pre>
</div>
</div>
<div class="paragraph">
<p>To scroll the bar: if mouse is enabled (key: <span class="keyseq"><kbd>Alt</kbd>+<kbd>m</kbd></span>), you can scroll the
bar with your mouse wheel.</p>
</div>
<div class="paragraph">
<p>Or you can define keys, similar to the existing keys to scroll nicklist.
For example to use <kbd>F1</kbd>, <kbd>F2</kbd>, <span class="keyseq"><kbd>Alt</kbd>+<kbd>F1</kbd></span> and <span class="keyseq"><kbd>Alt</kbd>+<kbd>F2</kbd></span>:</p>
</div>
<div class="listingblock">
<div class="content">
<pre>/key bind meta-OP /bar scroll buffers * -100%
/key bind meta-OQ /bar scroll buffers * +100%
/key bind meta-meta-OP /bar scroll buffers * b
/key bind meta-meta-OQ /bar scroll buffers * e</pre>
</div>
</div>
<div class="admonitionblock note">
<table>
<tr>
<td class="icon">
<div class="title">Note</div>
</td>
<td class="content">
Keys "meta-OP" and "meta-OQ" may be different in your terminal. To find key
code press <span class="keyseq"><kbd>Alt</kbd>+<kbd>k</kbd></span> then key.
</td>
</tr>
</table>
</div>
</div>
<div class="sect2">
<h3 id="customize_prefix"><a class="anchor" href="#customize_prefix"></a>3.8. How can I reduce length of nicks or remove nick alignment in chat area?</h3>
<div class="paragraph">
<p>To reduce max length of nicks in chat area:</p>
</div>
<div class="listingblock">
<div class="content">
<pre>/set weechat.look.prefix_align_max 15</pre>
</div>
</div>
<div class="paragraph">
<p>To remove nick alignment:</p>
</div>
<div class="listingblock">
<div class="content">
<pre>/set weechat.look.prefix_align none</pre>
</div>
</div>
</div>
<div class="sect2">
<h3 id="input_bar_size"><a class="anchor" href="#input_bar_size"></a>3.9. How to use command line with more than one line?</h3>
<div class="paragraph">
<p>The option <em>size</em> in input bar can be set to a value higher than 1 (for fixed
size, default size is 1) or 0 for dynamic size, and then option <em>size_max</em> will
set the max size (0 = no limit).</p>
</div>
<div class="paragraph">
<p>Example with dynamic size:</p>
</div>
<div class="listingblock">
<div class="content">
<pre>/set weechat.bar.input.size 0</pre>
</div>
</div>
<div class="paragraph">
<p>Max size of 2:</p>
</div>
<div class="listingblock">
<div class="content">
<pre>/set weechat.bar.input.size_max 2</pre>
</div>
</div>
</div>
<div class="sect2">
<h3 id="one_input_root_bar"><a class="anchor" href="#one_input_root_bar"></a>3.10. Is it possible to display only one input bar for all windows (after split)?</h3>
<div class="paragraph">
<p>Yes, you will have to create a bar with type "root" (with an item to know in
which window you are), then delete current input bar.</p>
</div>
<div class="paragraph">
<p>For example:</p>
</div>
<div class="listingblock">
<div class="content">
<pre>/bar add rootinput root bottom 1 0 [buffer_name]+[input_prompt]+(away),[input_search],[input_paste],input_text
/bar del input</pre>
</div>
</div>
<div class="paragraph">
<p>If ever you are not satisfied with that, just delete new bar, WeeChat will
automatically create default bar "input" if item "input_text" is not used in
any bar:</p>
</div>
<div class="listingblock">
<div class="content">
<pre>/bar del rootinput</pre>
</div>
</div>
</div>
<div class="sect2">
<h3 id="terminal_copy_paste"><a class="anchor" href="#terminal_copy_paste"></a>3.11. How can I copy/paste text without pasting nicklist?</h3>
<div class="paragraph">
<p>With WeeChat ≥ 1.0, you can use the bare display (default key: <span class="keyseq"><kbd>Alt</kbd>+<kbd>l</kbd></span>).</p>
</div>
<div class="paragraph">
<p>You can use a terminal with rectangular selection (like rxvt-unicode,
konsole, gnome-terminal, &#8230;&#8203;). Key is usually <kbd>Ctrl</kbd> + <kbd>Alt</kbd> + mouse
selection.</p>
</div>
<div class="paragraph">
<p>Another solution is to move nicklist to top or bottom, for example:</p>
</div>
<div class="listingblock">
<div class="content">
<pre>/set weechat.bar.nicklist.position top</pre>
</div>
</div>
</div>
<div class="sect2">
<h3 id="urls"><a class="anchor" href="#urls"></a>3.12. How can I click on long URLs (more than one line)?</h3>
<div class="paragraph">
<p>With WeeChat ≥ 1.0, you can use the bare display (default key: <span class="keyseq"><kbd>Alt</kbd>+<kbd>l</kbd></span>).</p>
</div>
<div class="paragraph">
<p>By default, WeeChat displays time and prefix for each line and optional bars
around chat area. To make easier URL click, you can move nicklist to top and
remove alignment on nick:</p>
</div>
<div class="listingblock">
<div class="content">
<pre>/set weechat.bar.nicklist.position top
/set weechat.look.prefix_align none
/set weechat.look.align_end_of_lines time</pre>
</div>
</div>
<div class="paragraph">
<p>With WeeChat ≥ 0.3.6, you can enable option "eat_newline_glitch", so that
new line char is not added at the end of each line displayed (it will not break
URL selection):</p>
</div>
<div class="listingblock">
<div class="content">
<pre>/set weechat.look.eat_newline_glitch on</pre>
</div>
</div>
<div class="admonitionblock important">
<table>
<tr>
<td class="icon">
<div class="title">Important</div>
</td>
<td class="content">
This option may cause display bugs. If you experience such problem, you must
turn off this option.
</td>
</tr>
</table>
</div>
<div class="paragraph">
<p>Other solution is to use a script:</p>
</div>
<div class="listingblock">
<div class="content">
<pre>/script search url</pre>
</div>
</div>
</div>
<div class="sect2">
<h3 id="change_locale_without_quit"><a class="anchor" href="#change_locale_without_quit"></a>3.13. I want to change the language used by WeeChat for messages, but without exiting WeeChat, is it possible?</h3>
<div class="paragraph">
<p>Yes, with WeeChat ≥ 1.0:</p>
</div>
<div class="listingblock">
<div class="content">
<pre>/set env LANG en_US.UTF-8
/upgrade</pre>
</div>
</div>
<div class="paragraph">
<p>With older WeeChat:</p>
</div>
<div class="listingblock">
<div class="content">
<pre>/script install shell.py
/shell setenv LANG=en_US.UTF-8
/upgrade</pre>
</div>
</div>
</div>
<div class="sect2">
<h3 id="use_256_colors"><a class="anchor" href="#use_256_colors"></a>3.14. How can I use 256 colors in WeeChat?</h3>
<div class="paragraph">
<p>256 colors are supported with WeeChat ≥ 0.3.4.</p>
</div>
<div class="paragraph">
<p>First check that your <em>TERM</em> environment variable is correct, recommended values
are:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>under screen: <em>screen-256color</em></p>
</li>
<li>
<p>under tmux: <em>screen-256color</em> or <em>tmux-256color</em></p>
</li>
<li>
<p>outside screen/tmux: <em>xterm-256color</em>, <em>rxvt-256color</em>, <em>putty-256color</em>, &#8230;&#8203;</p>
</li>
</ul>
</div>
<div class="admonitionblock note">
<table>
<tr>
<td class="icon">
<div class="title">Note</div>
</td>
<td class="content">
You may have to install package "ncurses-term" to use these values in <em>TERM</em>
variable.
</td>
</tr>
</table>
</div>
<div class="paragraph">
<p>If you are using screen, you can add this line to your <em>~/.screenrc</em>:</p>
</div>
<div class="listingblock">
<div class="content">
<pre>term screen-256color</pre>
</div>
</div>
<div class="paragraph">
<p>If your <em>TERM</em> variable has wrong value and that WeeChat is already running,
you can change it with these two commands (with WeeChat ≥ 1.0):</p>
</div>
<div class="listingblock">
<div class="content">
<pre>/set env TERM screen-256color
/upgrade</pre>
</div>
</div>
<div class="paragraph">
<p>For version 0.3.4, you must use command <code>/color</code> to add new colors.</p>
</div>
<div class="paragraph">
<p>For versions ≥ 0.3.5, you can use any color number in options (optional: you
can add color aliases with command <code>/color</code>).</p>
</div>
<div class="paragraph">
<p>Please read user&#8217;s guide for more information about colors management.</p>
</div>
</div>
<div class="sect2">
<h3 id="search_text"><a class="anchor" href="#search_text"></a>3.15. How can I search text in buffer (like /lastlog in irssi)?</h3>
<div class="paragraph">
<p>The default key is <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>r</kbd></span> (command is: <code>/input search_text_here</code>).
And jump to highlights: <span class="keyseq"><kbd>Alt</kbd>+<kbd>p</kbd></span> / <span class="keyseq"><kbd>Alt</kbd>+<kbd>n</kbd></span>.</p>
</div>
<div class="paragraph">
<p>See user&#8217;s guide for more info about this feature (default key bindings).</p>
</div>
</div>
<div class="sect2">
<h3 id="terminal_focus"><a class="anchor" href="#terminal_focus"></a>3.16. How can I execute commands when terminal gets/loses focus?</h3>
<div class="paragraph">
<p>You must enable the focus events with a special code sent to terminal.</p>
</div>
<div class="paragraph">
<p><strong>Important</strong>:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>Currently, <strong>only</strong> <em>xterm</em> seems to support this feature.</p>
</li>
<li>
<p>It does <strong>not</strong> work under screen/tmux.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>To send the code when WeeChat is starting:</p>
</div>
<div class="listingblock">
<div class="content">
<pre>/set weechat.startup.command_after_plugins "/print -stdout \033[?1004h\n"</pre>
</div>
</div>
<div class="paragraph">
<p>And then you bind two keys for the focus (replace the <code>/print</code> commands by the
commands of your choice):</p>
</div>
<div class="listingblock">
<div class="content">
<pre>/key bind meta2-I /print -core focus
/key bind meta2-O /print -core unfocus</pre>
</div>
</div>
</div>
<div class="sect2">
<h3 id="screen_paste"><a class="anchor" href="#screen_paste"></a>3.17. When WeeChat is running in screen, pasting text in another screen window adds ~0 and ~1 around text, why?</h3>
<div class="paragraph">
<p>This is caused by the bracketed paste option which is enabled by default, and
not properly handled by screen in other windows.</p>
</div>
<div class="paragraph">
<p>You can just disable bracketed paste mode:</p>
</div>
<div class="listingblock">
<div class="content">
<pre>/set weechat.look.paste_bracketed off</pre>
</div>
</div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="key_bindings"><a class="anchor" href="#key_bindings"></a>4. Key bindings</h2>
<div class="sectionbody">
<div class="sect2">
<h3 id="meta_keys"><a class="anchor" href="#meta_keys"></a>4.1. Some meta keys (alt + key) are not working, why?</h3>
<div class="paragraph">
<p>If you&#8217;re using some terminals like xterm or uxterm, some meta keys does not
work by default. You can add a line in file <em>~/.Xresources</em>:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>for xterm:</p>
</li>
</ul>
</div>
<div class="listingblock">
<div class="content">
<pre>XTerm*metaSendsEscape: true</pre>
</div>
</div>
<div class="ulist">
<ul>
<li>
<p>for uxterm:</p>
</li>
</ul>
</div>
<div class="listingblock">
<div class="content">
<pre>UXTerm*metaSendsEscape: true</pre>
</div>
</div>
<div class="paragraph">
<p>And then reload resources (<code>xrdb -override ~/.Xresources</code>) or restart X.</p>
</div>
</div>
<div class="sect2">
<h3 id="customize_key_bindings"><a class="anchor" href="#customize_key_bindings"></a>4.2. How can I customize key bindings?</h3>
<div class="paragraph">
<p>Key bindings are customizable with <code>/key</code> command.</p>
</div>
<div class="paragraph">
<p>Default key <span class="keyseq"><kbd>Alt</kbd>+<kbd>k</kbd></span> lets you grab key code and insert it in command line.</p>
</div>
</div>
<div class="sect2">
<h3 id="jump_to_buffer_11_or_higher"><a class="anchor" href="#jump_to_buffer_11_or_higher"></a>4.3. What is the key to jump to buffer 11 (or higher number)?</h3>
<div class="paragraph">
<p>The key is <span class="keyseq"><kbd>Alt</kbd>+<kbd>j</kbd></span> and then 2 digits, for example <span class="keyseq"><kbd>Alt</kbd>+<kbd>j</kbd></span>, <kbd>1</kbd>,
<kbd>1</kbd> to jump to buffer 11.</p>
</div>
<div class="paragraph">
<p>You can bind a key, for example:</p>
</div>
<div class="listingblock">
<div class="content">
<pre>/key bind meta-q /buffer *11</pre>
</div>
</div>
<div class="paragraph">
<p>List of default keys is in User&#8217;s guide.</p>
</div>
</div>
<div class="sect2">
<h3 id="global_history"><a class="anchor" href="#global_history"></a>4.4. How to use global history (instead of buffer history) with up and down keys?</h3>
<div class="paragraph">
<p>You can bind the up and down keys on global history (default keys for global
history are <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>↑</kbd></span> and <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>↓</kbd></span>).</p>
</div>
<div class="paragraph">
<p>Example:</p>
</div>
<div class="listingblock">
<div class="content">
<pre>/key bind meta2-A /input history_global_previous
/key bind meta2-B /input history_global_next</pre>
</div>
</div>
<div class="admonitionblock note">
<table>
<tr>
<td class="icon">
<div class="title">Note</div>
</td>
<td class="content">
Keys "meta2-A" and "meta2-B" may be different in your terminal. To find key
code press <span class="keyseq"><kbd>Alt</kbd>+<kbd>k</kbd></span> then key.
</td>
</tr>
</table>
</div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="mouse"><a class="anchor" href="#mouse"></a>5. Mouse</h2>
<div class="sectionbody">
<div class="sect2">
<h3 id="mouse_not_working"><a class="anchor" href="#mouse_not_working"></a>5.1. Mouse is not working at all, what can I do?</h3>
<div class="paragraph">
<p>Mouse is supported with WeeChat ≥ 0.3.6.</p>
</div>
<div class="paragraph">
<p>First try to enable mouse:</p>
</div>
<div class="listingblock">
<div class="content">
<pre>/mouse enable</pre>
</div>
</div>
<div class="paragraph">
<p>If mouse is still not working, check the TERM variable in your shell (look at
output of <code>echo $TERM</code> in your terminal).
According to terminfo used, mouse may not be supported.</p>
</div>
<div class="paragraph">
<p>You can test mouse support in terminal:</p>
</div>
<div class="listingblock">
<div class="content">
<pre>$ printf '\033[?1002h'</pre>
</div>
</div>
<div class="paragraph">
<p>And then click on first char of terminal (upper left). You should see " !!#!!".</p>
</div>
<div class="paragraph">
<p>To disable mouse in terminal:</p>
</div>
<div class="listingblock">
<div class="content">
<pre>$ printf '\033[?1002l'</pre>
</div>
</div>
</div>
<div class="sect2">
<h3 id="mouse_coords"><a class="anchor" href="#mouse_coords"></a>5.2. Mouse does nothing for X or Y greater than 94 (or 222), why?</h3>
<div class="paragraph">
<p>Some terminals are sending only ISO chars for mouse coordinates, so it does not
work for X/Y greater than 94 (or 222).</p>
</div>
<div class="paragraph">
<p>You should use a terminal that supports UTF-8 coordinates for mouse, like
rxvt-unicode.</p>
</div>
</div>
<div class="sect2">
<h3 id="mouse_select_paste"><a class="anchor" href="#mouse_select_paste"></a>5.3. How can I select or paste text in terminal when mouse is enabled in WeeChat?</h3>
<div class="paragraph">
<p>When mouse is enabled in WeeChat, you can use <kbd>Shift</kbd> modifier to select or
click in terminal, as if the mouse was disabled (on some terminals like iTerm,
you have to use <kbd>Alt</kbd> instead of <kbd>Shift</kbd>).</p>
</div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="irc"><a class="anchor" href="#irc"></a>6. IRC</h2>
<div class="sectionbody">
<div class="sect2">
<h3 id="irc_ssl_connection"><a class="anchor" href="#irc_ssl_connection"></a>6.1. I have some problems when connecting to a server using SSL, what can I do?</h3>
<div class="paragraph">
<p>If you are using Mac OS X, you must install <code>openssl</code> from Homebrew.
A CA file will be bootstrapped using certificates from the system keychain.
You can then set the path to certificates in WeeChat:</p>
</div>
<div class="listingblock">
<div class="content">
<pre>/set weechat.network.gnutls_ca_file "/usr/local/etc/openssl/cert.pem"</pre>
</div>
</div>
<div class="paragraph">
<p>If you see errors about gnutls handshake, you can try to use a smaller
Diffie-Hellman key (default is 2048):</p>
</div>
<div class="listingblock">
<div class="content">
<pre>/set irc.server.example.ssl_dhkey_size 1024</pre>
</div>
</div>
<div class="paragraph">
<p>If you see errors about certificate, you can disable "ssl_verify" (be careful,
connection will be less secure by doing that):</p>
</div>
<div class="listingblock">
<div class="content">
<pre>/set irc.server.example.ssl_verify off</pre>
</div>
</div>
<div class="paragraph">
<p>If the server has an invalid certificate and you know what the certificate
should be, you can specify the fingerprint (SHA-512, SHA-256 or SHA-1):</p>
</div>
<div class="listingblock">
<div class="content">
<pre>/set irc.server.example.ssl_fingerprint 0c06e399d3c3597511dc8550848bfd2a502f0ce19883b728b73f6b7e8604243b</pre>
</div>
</div>
</div>
<div class="sect2">
<h3 id="irc_ssl_handshake_error"><a class="anchor" href="#irc_ssl_handshake_error"></a>6.2. When connecting to server with SSL, I see only error "TLS handshake failed", what can I do?</h3>
<div class="paragraph">
<p>You can try a different priority string (WeeChat ≥ 0.3.5 only), replace "xxx"
by your server name:</p>
</div>
<div class="listingblock">
<div class="content">
<pre>/set irc.server.xxx.ssl_priorities "NORMAL:-VERS-TLS-ALL:+VERS-TLS1.0:+VERS-SSL3.0:%COMPAT"</pre>
</div>
</div>
</div>
<div class="sect2">
<h3 id="irc_ssl_freenode"><a class="anchor" href="#irc_ssl_freenode"></a>6.3. How can I connect to freenode server using SSL?</h3>
<div class="paragraph">
<p>Set option <em>weechat.network.gnutls_ca_file</em> to file with certificates:</p>
</div>
<div class="listingblock">
<div class="content">
<pre>/set weechat.network.gnutls_ca_file "/etc/ssl/certs/ca-certificates.crt"</pre>
</div>
</div>
<div class="admonitionblock note">
<table>
<tr>
<td class="icon">
<div class="title">Note</div>
</td>
<td class="content">
Check that you have this file on your system (commonly brought by package
"ca-certificates").
</td>
</tr>
</table>
</div>
<div class="paragraph">
<p>Setup server port, SSL, then connect:</p>
</div>
<div class="listingblock">
<div class="content">
<pre>/set irc.server.freenode.addresses "chat.freenode.net/7000"
/set irc.server.freenode.ssl on
/connect freenode</pre>
</div>
</div>
</div>
<div class="sect2">
<h3 id="irc_oauth"><a class="anchor" href="#irc_oauth"></a>6.4. How to connect to a server that requires "oauth"?</h3>
<div class="paragraph">
<p>Some servers like <em>twitch</em> require oauth to connect.</p>
</div>
<div class="paragraph">
<p>The oauth is simply a password with the value "oauth:XXXX".</p>
</div>
<div class="paragraph">
<p>You can add such server and connect with following commands (replace name
and address by appropriate values):</p>
</div>
<div class="listingblock">
<div class="content">
<pre>/server add name irc.server.org -password=oauth:XXXX
/connect name</pre>
</div>
</div>
</div>
<div class="sect2">
<h3 id="irc_sasl"><a class="anchor" href="#irc_sasl"></a>6.5. How can I be identified before joining channels?</h3>
<div class="paragraph">
<p>If server supports SASL, you should use that instead of sending command for
nickserv authentication, for example:</p>
</div>
<div class="listingblock">
<div class="content">
<pre>/set irc.server.freenode.sasl_username "mynick"
/set irc.server.freenode.sasl_password "xxxxxxx"</pre>
</div>
</div>
<div class="paragraph">
<p>If server does not support SASL, you can add a delay (between command and join
of channels):</p>
</div>
<div class="listingblock">
<div class="content">
<pre>/set irc.server.freenode.command_delay 5</pre>
</div>
</div>
</div>
<div class="sect2">
<h3 id="ignore_vs_filter"><a class="anchor" href="#ignore_vs_filter"></a>6.6. What is the difference between the /ignore and /filter commands?</h3>
<div class="paragraph">
<p>The <code>/ignore</code> command is an IRC command, so it applies only for IRC buffers
(servers and channels).
It lets you ignore some nicks or hostnames of users for a server or channel
(command will not apply on content of messages).
Matching messages are deleted by IRC plugin before display (so you&#8217;ll
never see them).</p>
</div>
<div class="paragraph">
<p>The <code>/filter</code> command is a core command, so it applies to any buffer.
It lets you filter some lines in buffers with tags or regular expression for
prefix and content of line.
Filtered lines are only hidden, not deleted, and you can see them if you
disable filters (by default, the key <span class="keyseq"><kbd>Alt</kbd>+<kbd>=</kbd></span> toggles filters).</p>
</div>
</div>
<div class="sect2">
<h3 id="filter_irc_join_part_quit"><a class="anchor" href="#filter_irc_join_part_quit"></a>6.7. How can I filter join/part/quit messages on IRC channels?</h3>
<div class="paragraph">
<p>With smart filter (keep join/part/quit from users who spoke recently):</p>
</div>
<div class="listingblock">
<div class="content">
<pre>/set irc.look.smart_filter on
/filter add irc_smart * irc_smart_filter *</pre>
</div>
</div>
<div class="paragraph">
<p>With a global filter (hide <strong>all</strong> join/part/quit):</p>
</div>
<div class="listingblock">
<div class="content">
<pre>/filter add joinquit * irc_join,irc_part,irc_quit *</pre>
</div>
</div>
<div class="admonitionblock note">
<table>
<tr>
<td class="icon">
<div class="title">Note</div>
</td>
<td class="content">
For help: <code>/help filter</code> and <code>/help irc.look.smart_filter</code>
</td>
</tr>
</table>
</div>
</div>
<div class="sect2">
<h3 id="filter_irc_join_channel_messages"><a class="anchor" href="#filter_irc_join_channel_messages"></a>6.8. How can I filter some messages displayed when I join an IRC channel?</h3>
<div class="paragraph">
<p>With WeeChat ≥ 0.4.1, you can choose which messages are displayed or not when
joining a channel with the option <em>irc.look.display_join_message</em> (see
<code>/help irc.look.display_join_message</code> for more info).</p>
</div>
<div class="paragraph">
<p>To hide messages (but keep them in buffer), you can filter them using the tag
(for example <em>irc_329</em> for channel creation date). See <code>/help filter</code> for help
with filters.</p>
</div>
</div>
<div class="sect2">
<h3 id="filter_voice_messages"><a class="anchor" href="#filter_voice_messages"></a>6.9. How can I filter voice messages (eg on Bitlbee server)?</h3>
<div class="paragraph">
<p>It&#8217;s not easy to filter voice messages, because voice mode can be set with other
modes in same IRC message.</p>
</div>
<div class="paragraph">
<p>If you want to do that, it&#8217;s probably because Bitlbee is using voice to show
away users, and you are flooded with voice messages. Therefore, you can change
that and let WeeChat use a special color for away nicks in nicklist.</p>
</div>
<div class="paragraph">
<p>For Bitlbee ≥ 3, do that on channel <em>&amp;bitlbee</em>:</p>
</div>
<div class="listingblock">
<div class="content">
<pre>channel set show_users online,away</pre>
</div>
</div>
<div class="paragraph">
<p>For older version of Bitlbee, do that on channel <em>&amp;bitlbee</em>:</p>
</div>
<div class="listingblock">
<div class="content">
<pre>set away_devoice false</pre>
</div>
</div>
<div class="paragraph">
<p>For checking away nicks in WeeChat, see question about
<a href="#color_away_nicks">away nicks</a>.</p>
</div>
<div class="paragraph">
<p>If you really want to filter voice messages, you can use this command, but this
is not perfect (will work only if first mode changed is voice):</p>
</div>
<div class="listingblock">
<div class="content">
<pre>/filter add hidevoices * irc_mode (\+|\-)v</pre>
</div>
</div>
</div>
<div class="sect2">
<h3 id="color_away_nicks"><a class="anchor" href="#color_away_nicks"></a>6.10. How can I see away nicks in nicklist?</h3>
<div class="paragraph">
<p>You have to set option <em>irc.server_default.away_check</em> to a positive value
(minutes between each check of away nicks).</p>
</div>
<div class="paragraph">
<p>You can set option <em>irc.server_default.away_check_max_nicks</em> to limit away check
on small channels only.</p>
</div>
<div class="paragraph">
<p>For example, check every 5 minutes for away nicks, for channels with max 25
nicks:</p>
</div>
<div class="listingblock">
<div class="content">
<pre>/set irc.server_default.away_check 5
/set irc.server_default.away_check_max_nicks 25</pre>
</div>
</div>
<div class="admonitionblock note">
<table>
<tr>
<td class="icon">
<div class="title">Note</div>
</td>
<td class="content">
For WeeChat ≤ 0.3.3, options are <em>irc.network.away_check</em> and
<em>irc.network.away_check_max_nicks</em>.
</td>
</tr>
</table>
</div>
</div>
<div class="sect2">
<h3 id="highlight_notification"><a class="anchor" href="#highlight_notification"></a>6.11. How can I be warned when someone highlights me on a channel?</h3>
<div class="paragraph">
<p>With WeeChat ≥ 1.0, there is a default trigger "beep" which sends a <em>BEL</em> to
the terminal on a highlight or private message. Thus you can configure your
terminal (or multiplexer like screen/tmux) to run a command or play a sound
when a <em>BEL</em> occurs.</p>
</div>
<div class="paragraph">
<p>Or you can add a command in "beep" trigger:</p>
</div>
<div class="listingblock">
<div class="content">
<pre>/set trigger.trigger.beep.command "/print -beep;/exec -bg /path/to/command arguments"</pre>
</div>
</div>
<div class="paragraph">
<p>With an older WeeChat, you can use a script like <em>beep.pl</em> or <em>launcher.pl</em>.</p>
</div>
<div class="paragraph">
<p>For <em>launcher.pl</em>, you have to setup command:</p>
</div>
<div class="listingblock">
<div class="content">
<pre>/set plugins.var.perl.launcher.signal.weechat_highlight "/path/to/command arguments"</pre>
</div>
</div>
<div class="paragraph">
<p>Other scripts on this subject:</p>
</div>
<div class="listingblock">
<div class="content">
<pre>/script search notify</pre>
</div>
</div>
</div>
<div class="sect2">
<h3 id="irc_target_buffer"><a class="anchor" href="#irc_target_buffer"></a>6.12. How can I change target buffer for commands on merged buffers (like buffer with servers)?</h3>
<div class="paragraph">
<p>The default key is <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>x</kbd></span> (command is: <code>/input switch_active_buffer</code>).</p>
</div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="plugins_scripts"><a class="anchor" href="#plugins_scripts"></a>7. Plugins / scripts</h2>
<div class="sectionbody">
<div class="sect2">
<h3 id="openbsd_plugins"><a class="anchor" href="#openbsd_plugins"></a>7.1. I&#8217;m using OpenBSD and WeeChat does not load any plugins, what&#8217;s wrong?</h3>
<div class="paragraph">
<p>Under OpenBSD, plugin filenames end with ".so.0.0" (".so" for Linux).</p>
</div>
<div class="paragraph">
<p>You must set that up:</p>
</div>
<div class="listingblock">
<div class="content">
<pre>/set weechat.plugin.extension ".so.0.0"
/plugin autoload</pre>
</div>
</div>
</div>
<div class="sect2">
<h3 id="install_scripts"><a class="anchor" href="#install_scripts"></a>7.2. How can I install scripts? Are scripts compatible with other IRC clients?</h3>
<div class="paragraph">
<p>You can use the command <code>/script</code> to install and manage scripts
(see <code>/help script</code> for help).</p>
</div>
<div class="paragraph">
<p>Scripts are not compatible with other IRC clients.</p>
</div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="settings"><a class="anchor" href="#settings"></a>8. Settings</h2>
<div class="sectionbody">
<div class="sect2">
<h3 id="memory_usage"><a class="anchor" href="#memory_usage"></a>8.1. How can I tweak WeeChat to consume less memory?</h3>
<div class="paragraph">
<p>You can try following tips to consume less memory:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>use the latest stable version (it is supposed to have less memory leaks than
older versions)</p>
</li>
<li>
<p>do not load some plugins if you don&#8217;t use them, for example: aspell, fifo,
logger, perl, python, ruby, lua, tcl, guile, javascript, xfer (used for DCC)</p>
</li>
<li>
<p>load only scripts that you really need</p>
</li>
<li>
<p>do not load certificates if SSL is <strong>NOT</strong> used: set empty string in option
<em>weechat.network.gnutls_ca_file</em></p>
</li>
<li>
<p>reduce value of option <em>weechat.history.max_buffer_lines_number</em> or set value
of option <em>weechat.history.max_buffer_lines_minutes</em></p>
</li>
<li>
<p>reduce value of option <em>weechat.history.max_commands</em></p>
</li>
</ul>
</div>
</div>
<div class="sect2">
<h3 id="cpu_usage"><a class="anchor" href="#cpu_usage"></a>8.2. How can I tweak WeeChat to use less CPU?</h3>
<div class="paragraph">
<p>You can follow same tips as for <a href="#memory_usage">memory</a>, and these ones:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>hide "nicklist" bar: <code>/bar hide nicklist</code></p>
</li>
<li>
<p>remove display of seconds in status bar time:
<code>/set weechat.look.item_time_format "%H:%M"</code> (this is the default value)</p>
</li>
<li>
<p>disable real time check of misspelled words in command line (if you enabled it):
<code>/set aspell.check.real_time off</code></p>
</li>
<li>
<p>set the <em>TZ</em> variable (for example: <code>export TZ="Europe/Paris"</code>), to prevent
frequent access to file <em>/etc/localtime</em></p>
</li>
</ul>
</div>
</div>
<div class="sect2">
<h3 id="security"><a class="anchor" href="#security"></a>8.3. I am paranoid about security, which settings could I change to be even more secure?</h3>
<div class="paragraph">
<p>Disable IRC part and quit messages:</p>
</div>
<div class="listingblock">
<div class="content">
<pre>/set irc.server_default.default_msg_part ""
/set irc.server_default.default_msg_quit ""</pre>
</div>
</div>
<div class="paragraph">
<p>Disable answers to all CTCP queries:</p>
</div>
<div class="listingblock">
<div class="content">
<pre>/set irc.ctcp.clientinfo ""
/set irc.ctcp.finger ""
/set irc.ctcp.source ""
/set irc.ctcp.time ""
/set irc.ctcp.userinfo ""
/set irc.ctcp.version ""
/set irc.ctcp.ping ""</pre>
</div>
</div>
<div class="paragraph">
<p>Unload and disable auto-loading of "xfer" plugin (used for IRC DCC):</p>
</div>
<div class="listingblock">
<div class="content">
<pre>/plugin unload xfer
/set weechat.plugin.autoload "*,!xfer"</pre>
</div>
</div>
<div class="paragraph">
<p>Define a passphrase and use secured data wherever you can for sensitive data
like passwords: see <code>/help secure</code> and <code>/help</code> on options
(if you can use secured data, it is written in the help).</p>
</div>
<div class="paragraph">
<p>For example:</p>
</div>
<div class="listingblock">
<div class="content">
<pre>/secure passphrase xxxxxxxxxx
/secure set freenode_username username
/secure set freenode_password xxxxxxxx
/set irc.server.freenode.sasl_username "${sec.data.freenode_username}"
/set irc.server.freenode.sasl_password "${sec.data.freenode_password}"</pre>
</div>
</div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="development"><a class="anchor" href="#development"></a>9. Development</h2>
<div class="sectionbody">
<div class="sect2">
<h3 id="bug_task_patch"><a class="anchor" href="#bug_task_patch"></a>9.1. How should I report bugs, ask for new features or send patches?</h3>
<div class="paragraph">
<p>See: <a href="https://weechat.org/dev/support" class="bare">https://weechat.org/dev/support</a></p>
</div>
</div>
<div class="sect2">
<h3 id="gdb_error_threads"><a class="anchor" href="#gdb_error_threads"></a>9.2. When I run WeeChat under gdb, there is error about threads, what can I do?</h3>
<div class="paragraph">
<p>When you run WeeChat under gdb, you may have this error:</p>
</div>
<div class="listingblock">
<div class="content">
<pre>$ gdb /path/to/weechat
(gdb) run
[Thread debugging using libthread_db enabled]
Cannot find new threads: generic error</pre>
</div>
</div>
<div class="paragraph">
<p>To fix that, you can run gdb with this command (replace path to libpthread and
WeeChat with paths on your system):</p>
</div>
<div class="listingblock">
<div class="content">
<pre>$ LD_PRELOAD=/lib/libpthread.so.0 gdb /path/to/weechat
(gdb) run</pre>
</div>
</div>
</div>
<div class="sect2">
<h3 id="supported_os"><a class="anchor" href="#supported_os"></a>9.3. What is the list of supported platforms for WeeChat? Will it be ported to other operating systems?</h3>
<div class="paragraph">
<p>The full list is on this page: <a href="https://weechat.org/download" class="bare">https://weechat.org/download</a></p>
</div>
<div class="paragraph">
<p>We do our best to run on as many platforms as possible. Help is welcome for
some OS' we don&#8217;t have, to test WeeChat.</p>
</div>
</div>
<div class="sect2">
<h3 id="help_developers"><a class="anchor" href="#help_developers"></a>9.4. I want to help WeeChat developers. What can I do?</h3>
<div class="paragraph">
<p>There&#8217;s many tasks to do (testing, code, documentation, &#8230;&#8203;)</p>
</div>
<div class="paragraph">
<p>Please contact us via IRC or mail, look at support page:
<a href="https://weechat.org/dev/support" class="bare">https://weechat.org/dev/support</a></p>
</div>
</div>
<div class="sect2">
<h3 id="donate"><a class="anchor" href="#donate"></a>9.5. Can I give money or other things to WeeChat developers?</h3>
<div class="paragraph">
<p>You can give us money to help development.
Details on <a href="https://weechat.org/about/donate" class="bare">https://weechat.org/about/donate</a></p>
</div>
</div>
</div>
</div>
</div>
<div id="footer">
<div id="footer-text">
Version 1.6<br>
</div>
</div>
</body>
</html>
weechat-doc 1.6-1+deb9u2 / usr / share / doc / weechat-doc / html / weechat_faq.en.html
