WEECHAT\-HEADLESS

Section: WeeChat Manual (1)
Updated: 2019-02-17
Page Index
 

NAME

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

SYNOPSIS

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...]
weechat-headless [-c|--colors]
weechat-headless [-h|--help]
weechat-headless [-l|--license]
weechat-headless [-v|--version]

 

DESCRIPTION

WeeChat (Wee Enhanced Environment for Chat) is a free chat client, fast and light, designed for many operating systems. It is highly customizable and extensible with scripts.

The command weechat-headless runs WeeChat in a headless mode (no interface). It can be used for tests or to daemonize WeeChat with the option "--daemon".  

OPTIONS

-a, --no-connect

Disable auto-connect to servers when WeeChat is starting.

-c, --colors

Display default colors in terminal.

--daemon

Run WeeChat in background, as a daemon (works only with the command weechat-headless).

-d, --dir <path>

Set path as home for WeeChat (used for configuration files, logs, user plugins and scripts), default value is "~/.weechat" (note: directory is created if not found by WeeChat). If this option is not given, the environment variable WEECHAT_HOME is used (if not empty).

-t, --temp-dir

Create a temporary WeeChat home directory and delete it on exit (incompatible with option "-d").
The name of the directory is automatically built by WeeChat, with this template: "weechat_temp_XXXXXX" (where "XXXXXX" is random). It it created in the first available directory in this list: environment variable "TMPDIR", "/tmp" (may be different according to the operating system), environment variable "HOME", current directory.
The temporary home directory has permissions 0700 (only owner can read, write and execute).

-h, --help

Display help.

-l, --license

Display WeeChat license.

-p, --no-plugin

Disable plugins auto-load.

-P, --plugins <plugins>

Load only these plugins at startup (see /help weechat.plugin.autoload). If this option is given, the option weechat.plugin.autoload is not used.

-r, --run-command <command>

Run command(s) after startup; many commands can be separated by semicolons, this option can be given multiple times.

-s, --no-script

Disable scripts auto-load.

--upgrade

Upgrade WeeChat using session files generated with command /upgrade -quit.

-v, --version

Display WeeChat version.

plugin:option

Option for a plugin.
 

PLUGIN OPTIONS

For complete doc on plugin options, please look at plugins documentation in WeeChat user's guide <URL: https://weechat.org/doc >.

With irc plugin, you can connect to temporary server with an URL like:

irc[6][s]://[[nickname][:password]@]server[:port][/#channel1[,#channel2...]]

To join WeeChat IRC channel support with nick "mynick":

irc://mynick@chat.freenode.net/#weechat

IPv6 address can be enclosed in brackets to add a port after address, for example:

irc://mynick@[2001:db8:0:85a3::ac1f:8001]:6668/#test
 

FILES

$HOME/.weechat/weechat.conf

main WeeChat configuration file

$HOME/.weechat/plugins.conf

plugins configuration file

$HOME/.weechat/sec.conf

configuration file with secured data

$HOME/.weechat/alias.conf

configuration file for alias plugin

$HOME/.weechat/aspell.conf

configuration file for aspell plugin

$HOME/.weechat/buflist.conf

configuration file for buflist plugin

$HOME/.weechat/charset.conf

configuration file for charset plugin

$HOME/.weechat/exec.conf

configuration file for exec plugin

$HOME/.weechat/fifo.conf

configuration file for fifo plugin

$HOME/.weechat/fset.conf

configuration file for fset plugin

$HOME/.weechat/guile.conf

configuration file for guile plugin

$HOME/.weechat/irc.conf

configuration file for irc plugin

$HOME/.weechat/javascript.conf

configuration file for javascript plugin

$HOME/.weechat/logger.conf

configuration file for logger plugin

$HOME/.weechat/lua.conf

configuration file for lua plugin

$HOME/.weechat/perl.conf

configuration file for perl plugin

$HOME/.weechat/php.conf

configuration file for php plugin

$HOME/.weechat/python.conf

configuration file for python plugin

$HOME/.weechat/relay.conf

configuration file for relay plugin

$HOME/.weechat/ruby.conf

configuration file for ruby plugin

$HOME/.weechat/script.conf

configuration file for script plugin

$HOME/.weechat/tcl.conf

configuration file for tcl plugin

$HOME/.weechat/trigger.conf

configuration file for trigger plugin

$HOME/.weechat/xfer.conf

configuration file for xfer plugin

$HOME/.weechat/weechat.log

WeeChat log file
 

SEE ALSO

weechat(1)  

AUTHORS

This manpage was written by Sébastien Helleu.  

COPYRIGHT

WeeChat is written by Sébastien Helleu and contributors (complete list is in the AUTHORS.adoc file).

Copyright © 2003-2019 Sébastien Helleu

WeeChat is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.

Please read the COPYING file for more information.

Web: <URL: https://weechat.org/ >  

SUPPORT / REPORTING BUGS

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

AUTHOR(S)

Sébastien Helleu

Author(s).

 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
PLUGIN OPTIONS
FILES
SEE ALSO
AUTHORS
COPYRIGHT
SUPPORT / REPORTING BUGS
AUTHOR(S)