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] [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

PLUGIN OPTIONS

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

FILES

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

AUTHORS

182       This manpage was written by Sébastien Helleu.
183

COPYRIGHT

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

SUPPORT / REPORTING BUGS

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

AUTHOR(S)

203       Sébastien Helleu
204           Author(s).
205
206
207
208WeeChat 2.4                       2019-02-17               WEECHAT-HEADLESS(1)