1WEECHAT(1) WeeChat Manual WEECHAT(1)
2
6 weechat - the extensible chat client
7
9 weechat [-a|--no-connect] [-d|--dir <path>] [-t|--temp-dir] [-p|--no-plugin] [-P|--plugins <plugins>] [-r|--run-command <command>] [-s|--no-script] [--upgrade] [debug-option...] [plugin:option...]
10 weechat [-c|--colors]
11 weechat [-h|--help]
12 weechat [-l|--license]
13 weechat [-v|--version]
14
16 WeeChat (Wee Enhanced Environment for Chat) is a free chat client, fast
17 and light, designed for many operating systems. It is highly
18 customizable and extensible with scripts.
19
21 -a, --no-connect
22 Disable auto-connect to servers when WeeChat is starting.
23 -c, --colors
25 Display default colors in terminal.
26 --daemon
28 Run WeeChat in background, as a daemon (works only with the command
29 weechat-headless).
30 -d, --dir <path>
32 Set path as home for WeeChat (used for configuration files, logs,
33 user plugins and scripts), default value is "~/.weechat" (note:
34 directory is created if not found by WeeChat). If this option is
35 not given, the environment variable WEECHAT_HOME is used (if not
36 empty).
37 -t, --temp-dir
39 Create a temporary WeeChat home directory and delete it on exit
40 (incompatible with option "-d").
41 The name of the directory is automatically built by WeeChat, with
42 this template: "weechat_temp_XXXXXX" (where "XXXXXX" is random). It
43 it created in the first available directory in this list:
44 environment variable "TMPDIR", "/tmp" (may be different according
45 to the operating system), environment variable "HOME", current
46 directory.
47 The temporary home directory has permissions 0700 (only owner can
48 read, write and execute).
49 -h, --help
51 Display help.
52 -l, --license
54 Display WeeChat license.
55 -p, --no-plugin
57 Disable plugins auto-load.
58 -P, --plugins <plugins>
60 Load only these plugins at startup (see /help
61 weechat.plugin.autoload). If this option is given, the option
62 weechat.plugin.autoload is not used.
63 -r, --run-command <command>
65 Run command(s) after startup; many commands can be separated by
66 semicolons, this option can be given multiple times.
67 -s, --no-script
69 Disable scripts auto-load.
70 --upgrade
72 Upgrade WeeChat using session files generated with command /upgrade
73 -quit.
74 -v, --version
76 Display WeeChat version.
77 plugin:option
79 Option for a plugin.
80
82 WARNING: these options are for debug purposes only, DO NOT USE IN
83 PRODUCTION!
84 --no-dlclose
86 Do not call the function dlclose after plugins are unloaded. This
87 is useful with tools like Valgrind to display stack for unloaded
88 plugins.
89 --no-gnutls
91 Do not call the init and deinit functions of GnuTLS library. This
92 is useful with tools like Valgrind and electric-fence, to prevent
93 GnuTLS memory errors.
94 --no-gcrypt
96 Do not call the init and deinit functions of Gcrypt library. This
97 is useful with tools like Valgrind, to prevent Gcrypt memory
98 errors.
99
101 For complete doc on plugin options, please look at plugins
102 documentation in WeeChat user’s guide <https://weechat.org/doc>.
103 With irc plugin, you can connect to temporary server with an URL like:
105 irc[6][s]://[[nickname][:password]@]server[:port][/#channel1[,#channel2...]]
107 To join WeeChat IRC channel support with nick "mynick":
109 irc://mynick@chat.freenode.net/#weechat
111 IPv6 address can be enclosed in brackets to add a port after address,
113 for example:
114 irc://mynick@[2001:db8:0:85a3::ac1f:8001]:6668/#test
116
118 $HOME/.weechat/weechat.conf
119 main WeeChat configuration file
120 $HOME/.weechat/plugins.conf
122 plugins configuration file
123 $HOME/.weechat/sec.conf
125 configuration file with secured data
126 $HOME/.weechat/alias.conf
128 configuration file for alias plugin
129 $HOME/.weechat/buflist.conf
131 configuration file for buflist plugin
132 $HOME/.weechat/charset.conf
134 configuration file for charset plugin
135 $HOME/.weechat/exec.conf
137 configuration file for exec plugin
138 $HOME/.weechat/fifo.conf
140 configuration file for fifo plugin
141 $HOME/.weechat/fset.conf
143 configuration file for fset plugin
144 $HOME/.weechat/guile.conf
146 configuration file for guile plugin
147 $HOME/.weechat/irc.conf
149 configuration file for irc plugin
150 $HOME/.weechat/javascript.conf
152 configuration file for javascript plugin
153 $HOME/.weechat/logger.conf
155 configuration file for logger plugin
156 $HOME/.weechat/lua.conf
158 configuration file for lua plugin
159 $HOME/.weechat/perl.conf
161 configuration file for perl plugin
162 $HOME/.weechat/php.conf
164 configuration file for php plugin
165 $HOME/.weechat/python.conf
167 configuration file for python plugin
168 $HOME/.weechat/relay.conf
170 configuration file for relay plugin
171 $HOME/.weechat/ruby.conf
173 configuration file for ruby plugin
174 $HOME/.weechat/script.conf
176 configuration file for script plugin
177 $HOME/.weechat/spell.conf
179 configuration file for spell plugin
180 $HOME/.weechat/tcl.conf
182 configuration file for tcl plugin
183 $HOME/.weechat/trigger.conf
185 configuration file for trigger plugin
186 $HOME/.weechat/xfer.conf
188 configuration file for xfer plugin
189 $HOME/.weechat/weechat.log
191 WeeChat log file
192
194 weechat-headless(1)
195
197 This manpage was written by Sébastien Helleu.
198
200 WeeChat is written by Sébastien Helleu and contributors (complete list
201 is in the AUTHORS.adoc file).
202 Copyright © 2003-2020 Sébastien Helleu
204 WeeChat is free software; you can redistribute it and/or modify it
206 under the terms of the GNU General Public License as published by the
207 Free Software Foundation; either version 3 of the License, or (at your
208 option) any later version.
209 Please read the COPYING file for more information.
211 Web: https://weechat.org/
213
215 For help or a bug report: https://weechat.org/about/support
216
218 Sébastien Helleu
219WeeChat 2.8 2020-04-01 WEECHAT(1)