alias [alias_name [command [arguments]]]
create an alias for a command
alias_name: name of alias
command: command name (WeeChat or IRC command, many commands can be separated by semicolons)
arguments: arguments for command
is replaced by all arguments.
Variables $nick, $channel and $server are replaced by current nick/channel/server.
buffer [action [args] | number | [[server] [channel]]]
manage buffers
action: action to do:
move: move buffer in the list (may be relative, for example -1)
close: close buffer (optional arg is part message, for a channel)
list: list open buffers (no parameter implies this list)
notify: set notify level for buffer (0=never, 1=highlight, 2=1+msg, 3=2+join/part)
(when executed on server buffer, this sets default notify level for whole server)
server,
channel: jump to buffer by server and/or channel name
number: jump to buffer by number
builtin command
launch WeeChat/IRC builtin command (do not look at plugins handlers or aliases)
command: command to execute (a '/' is automatically added if not found at beginning of command)
clear [-all | number]
clear window(s)
-all: clear all buffers
number: clear buffer by number
connect [-all | servername [servername ...]]
connect to server(s)
-all: connect to all servers
servername: server name to connect
disconnect [-all | servername [servername ...]]
disconnect from server(s)
-all: disconnect from all servers
servername: server name to disconnect
dcc action [nickname [file]]
starts DCC (file or chat) or close chat
action: 'send' (file) or 'chat' or 'close' (chat)
nickname: nickname to send file or chat
file: filename (on local host)
debug dump | windows
print debug messages
dump: save memory dump in WeeChat log file (same dump is written when WeeChat crashes)
windows: display windows tree
help [command]
display help about commands
command: name of a WeeChat or IRC command
history [clear | value]
show buffer command history
clear: clear history
value: number of history entries to show
ignore [mask [[type | command] [channel [server]]]]
ignore IRC messages and/or hosts
mask: nick or host mask to ignore
type: type of message to ignore (action, ctcp, dcc, pv)
command: IRC command
channel: name of channel for ignore
server: name of server for ignore
For each argument, '*' means all.
Without argument, /ignore command lists all defined ignore.
key [key [function/command]] [unbind key] [functions] [call function ["args"]] [reset -yes]
bind/unbind keys
key: display or bind this key to an internal function or a command (beginning by "/")
unbind: unbind a key
functions: list internal functions for key bindings
call: call a function by name (with optional arguments)
reset: restore bindings to the default values and delete ALL personal bindings (use carefully!)
plugin [list [name]] | [listfull [name]] | [load filename] | [autoload] | [reload [name]] | [unload [name]]
list/load/unload plugins
list: list loaded plugins
listfull: list loaded plugins with detailed info for each plugin
load: load a plugin
autoload: autoload plugins in system or user directory
reload: reload one plugin (if no name given, unload all plugins, then autoload plugins)
unload: unload one or all plugins
Without argument, /plugin command lists loaded plugins.
reconnect [-all | servername [servername ...]]
reconnect to server(s)
-all: reconnect to all servers
servername: server name to reconnect
server [servername] | [servername hostname port [-auto | -noauto] [-ipv6] [-ssl] [-pwd password] [-nicks nick1 nick2 nick3] [-username username] [-realname realname] [-command command] [-autojoin channel[,channel]] ] | [del servername]
list, add or remove servers
servername: server name, for internal and display use
hostname: name or IP address of server
port: port for server (integer)
ipv6: use IPv6 protocol
ssl: use SSL protocol
password: password for server
nick1: first nick for server
nick2: alternate nick for server
nick3: second alternate nick for server
username: user name
realname: real name of user
save [file]
save config to disk
file: filename for writing config
set [option [ = value]]
set config options
option: name of an option (if name is full and no value is given, then help is displayed on option)
value: value for option
Option may be: servername.server_xxx where "servername" is an internal server name and "xxx" an option for this server.
setp [option [ = value]]
set plugin config options
option: name of a plugin option
value: value for option
Option is format: plugin.option, example: perl.myscript.item1
unalias alias_name
remove an alias
alias_name: name of alias to remove
unignore [number | [mask [[type | command] [channel [server]]]]]
unignore IRC messages and/or hosts
number: # of ignore to unignore (number is displayed by list of ignore)
mask: nick or host mask to unignore
type: type of message to unignore (action, ctcp, dcc, pv)
command: IRC command
channel: name of channel for unignore
server: name of server for unignore
For each argument, '*' means all.
Without argument, /unignore command lists all defined ignore.
upgrade [path_to_binary]
upgrade WeeChat without disconnecting from servers
path_to_binary: path to WeeChat binary (default is current binary)
This command run again a WeeChat binary, so it should have been compiled or installed with a package manager before running this command.
uptime [-o]
show WeeChat uptime
-o: send uptime on current channel as an IRC message
window [list | -1 | +1 | b# | up | down | left | right | splith [pct] | splitv [pct] | resize pct | merge [all]]
manage windows
list: list open windows (no parameter implies this list)
-1: jump to previous window
+1: jump to next window
b#: jump to next window displaying buffer number #
up: switch to window above current one
down: switch to window below current one
left: switch to window on the left
right: switch to window on the right
splith: split current window horizontally
splitv: split current window vertically
resize: resize window size, new size is <pct> pourcentage of parent window
merge: merge window with another (all = keep only one window)
For splith and splitv, pct is a pourcentage which represents size of new window, computed with current window as size reference. For example 25 means create a new window with size = current_size / 4