1WEECHAT(1)                      WeeChat Manual                      WEECHAT(1)
2
3
4

NAME

6       weechat - the extensible chat client
7

SYNOPSIS

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] [plugin:option...]
10       weechat [-c|--colors]
11       weechat [-h|--help]
12       weechat [-l|--license]
13       weechat [-v|--version]
14

DESCRIPTION

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

OPTIONS

21       -a, --no-connect
22           Disable auto-connect to servers when WeeChat is starting.
23
24       -c, --colors
25           Display default colors in terminal.
26
27       --daemon
28           Run WeeChat in background, as a daemon (works only with the command
29           weechat-headless).
30
31       -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
38       -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
50       -h, --help
51           Display help.
52
53       -l, --license
54           Display WeeChat license.
55
56       -p, --no-plugin
57           Disable plugins auto-load.
58
59       -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
64       -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
68       -s, --no-script
69           Disable scripts auto-load.
70
71       --upgrade
72           Upgrade WeeChat using session files generated with command /upgrade
73           -quit.
74
75       -v, --version
76           Display WeeChat version.
77
78       plugin:option
79           Option for a plugin.
80

PLUGIN OPTIONS

82       For complete doc on plugin options, please look at plugins
83       documentation in WeeChat user’s guide <https://weechat.org/doc>.
84
85       With irc plugin, you can connect to temporary server with an URL like:
86
87           irc[6][s]://[[nickname][:password]@]server[:port][/#channel1[,#channel2...]]
88
89       To join WeeChat IRC channel support with nick "mynick":
90
91           irc://mynick@chat.freenode.net/#weechat
92
93       IPv6 address can be enclosed in brackets to add a port  after  address,
94       for example:
95
96           irc://mynick@[2001:db8:0:85a3::ac1f:8001]:6668/#test
97

FILES

99       $HOME/.weechat/weechat.conf
100           main WeeChat configuration file
101
102       $HOME/.weechat/plugins.conf
103           plugins configuration file
104
105       $HOME/.weechat/sec.conf
106           configuration file with secured data
107
108       $HOME/.weechat/alias.conf
109           configuration file for alias plugin
110
111       $HOME/.weechat/aspell.conf
112           configuration file for aspell plugin
113
114       $HOME/.weechat/buflist.conf
115           configuration file for buflist plugin
116
117       $HOME/.weechat/charset.conf
118           configuration file for charset plugin
119
120       $HOME/.weechat/exec.conf
121           configuration file for exec plugin
122
123       $HOME/.weechat/fifo.conf
124           configuration file for fifo plugin
125
126       $HOME/.weechat/fset.conf
127           configuration file for fset plugin
128
129       $HOME/.weechat/guile.conf
130           configuration file for guile plugin
131
132       $HOME/.weechat/irc.conf
133           configuration file for irc plugin
134
135       $HOME/.weechat/javascript.conf
136           configuration file for javascript plugin
137
138       $HOME/.weechat/logger.conf
139           configuration file for logger plugin
140
141       $HOME/.weechat/lua.conf
142           configuration file for lua plugin
143
144       $HOME/.weechat/perl.conf
145           configuration file for perl plugin
146
147       $HOME/.weechat/php.conf
148           configuration file for php plugin
149
150       $HOME/.weechat/python.conf
151           configuration file for python plugin
152
153       $HOME/.weechat/relay.conf
154           configuration file for relay plugin
155
156       $HOME/.weechat/ruby.conf
157           configuration file for ruby plugin
158
159       $HOME/.weechat/script.conf
160           configuration file for script plugin
161
162       $HOME/.weechat/tcl.conf
163           configuration file for tcl plugin
164
165       $HOME/.weechat/trigger.conf
166           configuration file for trigger plugin
167
168       $HOME/.weechat/xfer.conf
169           configuration file for xfer plugin
170
171       $HOME/.weechat/weechat.log
172           WeeChat log file
173

SEE ALSO

175       weechat-headless(1)
176

AUTHORS

178       This manpage was written by Sébastien Helleu.
179

COPYRIGHT

181       WeeChat  is written by Sébastien Helleu and contributors (complete list
182       is in the AUTHORS.adoc file).
183
184       Copyright © 2003-2019 Sébastien Helleu
185
186       WeeChat is free software; you can  redistribute  it  and/or  modify  it
187       under  the  terms of the GNU General Public License as published by the
188       Free Software Foundation; either version 3 of the License, or (at  your
189       option) any later version.
190
191       Please read the COPYING file for more information.
192
193       Web: <https://weechat.org/>
194

SUPPORT / REPORTING BUGS

196       For help or a bug report: <https://weechat.org/about/support>
197

AUTHOR(S)

199       Sébastien Helleu
200           Author(s).
201
202
203
204WeeChat 2.4                       2019-02-17                        WEECHAT(1)