weechat-headless(1)

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

NAME

6       weechat-headless - the extensible chat client (headless version)
7

SYNOPSIS

9       weechat-headless [-a|--no-connect] [--daemon] [-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-headless [-c|--colors]
11       weechat-headless [-h|--help]
12       weechat-headless [-l|--license]
13       weechat-headless [-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
20       The command weechat-headless runs WeeChat in a headless mode (no
21       interface). It can be used for tests or to daemonize WeeChat with the
22       option "--daemon".
23

OPTIONS

25       -a, --no-connect
26           Disable auto-connect to servers when WeeChat is starting.
27
28       -c, --colors
29           Display default colors in terminal.
30
31       --daemon
32           Run WeeChat in background, as a daemon (works only with the command
33           weechat-headless).
34
35       -d, --dir <path>
36           Set path as home for WeeChat (used for configuration files, logs,
37           user plugins and scripts), default value is "~/.weechat" (note:
38           directory is created if not found by WeeChat). If this option is
39           not given, the environment variable WEECHAT_HOME is used (if not
40           empty).
41
42       -t, --temp-dir
43           Create a temporary WeeChat home directory and delete it on exit
44           (incompatible with option "-d").
45           The name of the directory is automatically built by WeeChat, with
46           this template: "weechat_temp_XXXXXX" (where "XXXXXX" is random). It
47           it created in the first available directory in this list:
48           environment variable "TMPDIR", "/tmp" (may be different according
49           to the operating system), environment variable "HOME", current
50           directory.
51           The temporary home directory has permissions 0700 (only owner can
52           read, write and execute).
53
54       -h, --help
55           Display help.
56
57       -l, --license
58           Display WeeChat license.
59
60       -p, --no-plugin
61           Disable plugins auto-load.
62
63       -P, --plugins <plugins>
64           Load only these plugins at startup (see /help
65           weechat.plugin.autoload). If this option is given, the option
66           weechat.plugin.autoload is not used.
67
68       -r, --run-command <command>
69           Run command(s) after startup; many commands can be separated by
70           semicolons, this option can be given multiple times.
71
72       -s, --no-script
73           Disable scripts auto-load.
74
75       --upgrade
76           Upgrade WeeChat using session files generated with command /upgrade
77           -quit.
78
79       -v, --version
80           Display WeeChat version.
81
82       plugin:option
83           Option for a plugin.
84

DEBUG OPTIONS

86       WARNING: these options are for debug purposes only, DO NOT USE IN
87       PRODUCTION!
88
89       --no-dlclose
90           Do not call the function dlclose after plugins are unloaded. This
91           is useful with tools like Valgrind to display stack for unloaded
92           plugins.
93
94       --no-gnutls
95           Do not call the init and deinit functions of GnuTLS library. This
96           is useful with tools like Valgrind and electric-fence, to prevent
97           GnuTLS memory errors.
98
99       --no-gcrypt
100           Do not call the init and deinit functions of Gcrypt library. This
101           is useful with tools like Valgrind, to prevent Gcrypt memory
102           errors.
103

PLUGIN OPTIONS

105       For complete doc on plugin options, please look at plugins
106       documentation in WeeChat user’s guide <https://weechat.org/doc>.
107
108       With irc plugin, you can connect to temporary server with an URL like:
109
110           irc[6][s]://[[nickname][:password]@]server[:port][/#channel1[,#channel2...]]
111
112       To join WeeChat IRC channel support with nick "mynick":
113
114           irc://mynick@chat.freenode.net/#weechat
115
116       IPv6 address can be enclosed in brackets to add a port after address,
117       for example:
118
119           irc://mynick@[2001:db8:0:85a3::ac1f:8001]:6668/#test
120

FILES

122       $HOME/.weechat/weechat.conf
123           main WeeChat configuration file
124
125       $HOME/.weechat/plugins.conf
126           plugins configuration file
127
128       $HOME/.weechat/sec.conf
129           configuration file with secured data
130
131       $HOME/.weechat/alias.conf
132           configuration file for alias plugin
133
134       $HOME/.weechat/buflist.conf
135           configuration file for buflist plugin
136
137       $HOME/.weechat/charset.conf
138           configuration file for charset plugin
139
140       $HOME/.weechat/exec.conf
141           configuration file for exec plugin
142
143       $HOME/.weechat/fifo.conf
144           configuration file for fifo plugin
145
146       $HOME/.weechat/fset.conf
147           configuration file for fset plugin
148
149       $HOME/.weechat/guile.conf
150           configuration file for guile plugin
151
152       $HOME/.weechat/irc.conf
153           configuration file for irc plugin
154
155       $HOME/.weechat/javascript.conf
156           configuration file for javascript plugin
157
158       $HOME/.weechat/logger.conf
159           configuration file for logger plugin
160
161       $HOME/.weechat/lua.conf
162           configuration file for lua plugin
163
164       $HOME/.weechat/perl.conf
165           configuration file for perl plugin
166
167       $HOME/.weechat/php.conf
168           configuration file for php plugin
169
170       $HOME/.weechat/python.conf
171           configuration file for python plugin
172
173       $HOME/.weechat/relay.conf
174           configuration file for relay plugin
175
176       $HOME/.weechat/ruby.conf
177           configuration file for ruby plugin
178
179       $HOME/.weechat/script.conf
180           configuration file for script plugin
181
182       $HOME/.weechat/spell.conf
183           configuration file for spell plugin
184
185       $HOME/.weechat/tcl.conf
186           configuration file for tcl plugin
187
188       $HOME/.weechat/trigger.conf
189           configuration file for trigger plugin
190
191       $HOME/.weechat/xfer.conf
192           configuration file for xfer plugin
193
194       $HOME/.weechat/weechat.log
195           WeeChat log file
196

AUTHORS

201       This manpage was written by Sébastien Helleu.
202

COPYRIGHT

204       WeeChat is written by Sébastien Helleu and contributors (complete list
205       is in the AUTHORS.adoc file).
206
207       Copyright © 2003-2020 Sébastien Helleu
208
209       WeeChat is free software; you can redistribute it and/or modify it
210       under the terms of the GNU General Public License as published by the
211       Free Software Foundation; either version 3 of the License, or (at your
212       option) any later version.
213
214       Please read the COPYING file for more information.
215
216       Web: https://weechat.org/
217

SUPPORT / REPORTING BUGS

219       For help or a bug report: https://weechat.org/about/support
220

AUTHOR

222       Sébastien Helleu
223
224
225
226WeeChat 2.8                       2020-04-01               WEECHAT-HEADLESS(1)