weechat man page

weechat — the extensible chat client

Synopsis

weechat [-a|--no-connect] [-d|--dir <path>] [-p|--no-plugin] [-r|--run-command <command>] [-s|--no-script] [--upgrade] [plugin:option...]
weechat [-c|--colors]
weechat [-h|--help]
weechat [-l|--license]
weechat [-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.

Options

-a, --no-connect
Disable auto-connect to servers when WeeChat is starting.
-c, --colors
Display default colors in terminal.
-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).
-h, --help
Display help.
-l, --license
Display WeeChat license.
-p, --no-plugin
Disable plugins auto-load.
-r, --run-command <command>
Run command(s) after startup (many commands can be separated by semicolons).
-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.

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/charset.conf

configuration file for charset plugin

$HOME/.weechat/exec.conf

configuration file for exec plugin

$HOME/.weechat/irc.conf

configuration file for irc plugin

$HOME/.weechat/logger.conf

configuration file for logger plugin

$HOME/.weechat/relay.conf

configuration file for relay plugin

$HOME/.weechat/script.conf

configuration file for script 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

Authors

This manpage was written by Sébastien Helleu.

Support / Reporting Bugs

For help or a bug report:

Author(s)

Sébastien Helleu

Author(s).

Info

2016-10-02 WeeChat 1.6 WeeChat Manual