weechat man page

weechat — the extensible chat client


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]


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.


-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 WeeChat using session files generated with command /upgrade -quit.

-v, --version

Display WeeChat version.


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:


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


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




main WeeChat configuration file


plugins configuration file


configuration file with secured data


configuration file for alias plugin


configuration file for aspell plugin


configuration file for buflist plugin


configuration file for charset plugin


configuration file for exec plugin


configuration file for fifo plugin


configuration file for irc plugin


configuration file for logger plugin


configuration file for relay plugin


configuration file for script plugin


configuration file for trigger plugin


configuration file for xfer plugin


WeeChat log file


This manpage was written by Sébastien Helleu.

Support / Reporting Bugs

For help or a bug report: https://weechat.org/dev/support


Sébastien Helleu



2017-09-23 WeeChat 1.9.1 WeeChat Manual