WeeChat 0.2.6 - User guide

need

$ ./configure
$ make
$ su
(enter root password)
# make install
$ cvs -z3 -d:pserver:anonymous@cvs.savannah.nongnu.org:/sources/weechat co weechat
irc[6][s]://[pseudo[:mot_passe]@]irc.example.org[:port][/channel][,channel[...]
$ weechat-curses irc://nono@irc.freenode.net/#weechat,#toto
/query toto
hello
//query toto
^Cc12^Cbhello^Cb^Cc04^Cu everybody^Cu^Cc!
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

Variables $nick, $channel and $server are replaced by current nick/channel/server.

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)
 scroll: scroll in history (may be relative, and may end by a letter: s=sec, m=min, h=hour, d=day, M=month, y=year); if there is only letter, then scroll to beginning of this item

 number: jump to buffer by number
server,
channel: jump to buffer by server and/or channel name

Examples:
        move buffer: /buffer move 5
       close buffer: /buffer close this is part msg
         set notify: /buffer notify 2
    scroll 1 day up: /buffer scroll 1d  ==  /buffer scroll -1d  ==  /buffer scroll -24h
scroll to beginning
        of this day: /buffer scroll d
 scroll 15 min down: /buffer scroll +15m
  scroll 20 msgs up: /buffer scroll -20
   jump to #weechat: /buffer #weechat

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 window(s)

  -all: clear all buffers
number: clear buffer by number

connect to server(s)

      -all: connect to all servers
servername: internal server name to connect
   -nojoin: do not join any channel (even if autojoin is enabled on server)
  hostname: hostname to connect, creating temporary server
      port: port for server (integer, default is 6667)
      ipv6: use IPv6 protocol
       ssl: use SSL protocol

disconnect from server(s)

      -all: disconnect from all servers
servername: server name to disconnect

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)

print debug messages

   dump: save memory dump in WeeChat log file (same dump is written when WeeChat crashes)
 buffer: dump buffer content with hexadecimal values in log file
windows: display windows tree

display help about commands

command: name of a WeeChat or IRC command

show buffer command history

clear: clear history
value: number of history entries to show

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.

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!)

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 to server(s)

      -all: reconnect to all servers
servername: server name to reconnect
   -nojoin: do not join any channel (even if autojoin is enabled on server)

save config to disk

file: filename for writing config

list, add or remove servers

      list: list servers (no parameter implies this list)
  listfull: list servers with detailed info for each server
       add: create a new server
servername: server name, for internal and display use
  hostname: name or IP address of server
      port: port for server (integer, default is 6667)
      temp: create temporary server (not saved in config file)
      auto: automatically connect to server when WeeChat starts
    noauto: do not connect to server when WeeChat starts (default)
      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
      copy: duplicate a server
    rename: rename a server
      keep: keep server in config file (for temporary servers only)
       del: delete a server
   deloutq: delete messages out queue for all servers (all messages WeeChat is currently sending)

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.

set plugin config options

option: name of a plugin option
 value: value for option

Option is format: plugin.option, example: perl.myscript.item1

remove an alias

alias_name: name of alias to remove

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 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.

show WeeChat uptime

-o: send uptime on current channel as an IRC message

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

find information about the administrator of the server

target: server

send a CTCP action to all channels of all connected servers

message: message to send

send message to all channels of all connected servers

text: text to send

toggle away status

   -all: toggle away status on all connected servers
message: message for away (if no message is given, away status is removed)

bans nicks or hosts

 channel: channel for ban
nickname: user or host to ban

send a CTCP message (Client-To-Client Protocol)

 receiver: nick or channel to send CTCP to
     type: CTCP type (examples: "version", "ping", ..)
arguments: arguments for CTCP

leave and rejoin a channel

     channel: channel name for cycle
part_message: part message (displayed to other users)

removes half channel operator status from nickname(s)

removes channel operator status from nickname(s)

removes voice from nickname(s)

shutdown the server

gives half channel operator status to nickname(s)

get information describing the server

target: server name

invite a nick on a channel

nickname: nick to invite
 channel: channel to invite

check if a nickname is currently on IRC

nickname: nickname

join a channel

channel: channel name to join
    key: key to join the channel

forcibly remove a user from a channel

 channel: channel where user is
nickname: nickname to kick
 comment: comment for kick

kicks and bans a nick from a channel

 channel: channel where user is
nickname: nickname to kick and ban
 comment: comment for kick

close client-server connection

nickname: nickname
 comment: comment for kill

list all servernames which are known by the server answering the query

     server: this server should answer the query
server_mask: list of servers must match this mask

list channels and their topic

channel: channel to list (a regexp is allowed)
server: server name

get statistics about the size of the IRC network

  mask: servers matching the mask only
target: server for forwarding request

send a CTCP action to the current channel

message: message to send

change channel or user mode

channel modes:
  channel: channel name to modify
  o: give/take channel operator privileges
  p: private channel flag
  s: secret channel flag
  i: invite-only channel flag
  t: topic settable by channel operator only flag
  n: no messages to channel from clients on the outside
  m: moderated channel
  l: set the user limit to channel
  b: set a ban mask to keep users out
  e: set exception mask
  v: give/take the ability to speak on a moderated channel
  k: set a channel key (password)
user modes:
  nickname: nickname to modify
  i: mark a user as invisible
  s: mark a user for receive server notices
  w: user receives wallops
  o: operator flag

get the "Message Of The Day"

target: server name

send message to a nick or channel

receiver: nick or channel (may be mask, '*' = current channel)
text: text to send

list nicknames on channels

channel: channel name

change current nickname

    -all: set new nickname for all connected servers
nickname: new nickname

send notice message to user

nickname: user to send notice to
    text: text to send

gives channel operator status to nickname(s)

get operator privileges

user/password: used to get privileges on current IRC server

leave a channel

     channel: channel name to leave
part_message: part message (displayed to other users)

ping server

server1: server to ping
server2: forward ping to this server

answer to a ping message

 daemon: daemon who has responded to Ping message
daemon2: forward message to this daemon

send a private message to a nick

nickname: nickname for private conversation
    text: text to send

close all connections and quit

quit_message: quit message (displayed to other users)

send raw data to server without parsing

data: raw data to send

tell the server to reload its config file

tell the server to restart itself

register a new service

distribution: visibility of service
        type: reserved for future usage

list services currently connected to the network

mask: list only services matching this mask
type: list only services of this type

deliver a message to a service

service: name of service
text: text to send

disconnect server links

server: server name
comment: comment for quit

query statistics about server

 query: c/h/i/k/l/m/o/y/u (see RFC1459)
server: server name

give users who are on a host running an IRC server a message asking them to please join IRC

   user: username
target: server name
channel: channel name

query local time from server

target: query time from specified server

get/set channel topic

channel: channel name
topic: new topic for channel (if topic is "-delete" then topic is deleted)

find the route to specific server

target: server

unbans nicks or hosts

 channel: channel for unban
nickname: user or host to unban

return a list of information about nicknames

nickname: nickname

list of users logged into the server

target: server

gives the version info of nick or server (current or specified)

  server: server name
nickname: nickname

gives voice to nickname(s)

send a message to all currently connected users who have set the 'w' user mode for themselves

text to send

generate a query which returns a list of information

mask: only information which match this mask
   o: only operators are returned according to the mask supplied

query information about user(s)

  server: server name
nickname: nickname (may be a mask)

ask for information about a nickname which no longer exists

nickname: nickname to search
   count: number of replies to return (full search if negative number)
  target: reply should match this mask

server,channel *text or command here
$ echo 'freenode */nick mynick|out' >~/.weechat/weechat_fifo_12345
$ echo 'freenode,#weechat *hello everybody!' >~/.weechat/weechat_fifo_12345
$ echo '*hello!' >~/.weechat/weechat_fifo_12345
$ echo -e "freenode */perl unload\nfreenode */perl autoload" >~/.weechat/weechat_fifo_12345
#!/bin/sh
if [ $# -eq 1 ]; then
    for fifo in ~/.weechat/weechat_fifo_*
    do
        echo -e "$1" >$fifo
    done
fi

$ ./auto_weechat_command "freenode,#weechat *hello"
plugin->set_charset (plugin, "ISO-8859-1");
char *str = plugin->iconv_to_internal (plugin, "ISO-8859-1", "iso string: é à");
char *str = plugin->iconv_from_internal (plugin, "ISO-8859-1", "utf-8 string: é à");
if (plugin->ascii_strcasecmp (plugin, "abc", "def") != 0) ...
if (plugin->ascii_strncasecmp (plugin, "abc", "def", 2) != 0) ...
char **argv;
int argc;
argv = plugin->explode_string (plugin, string, " ", 0, &argc);
...
if (argv != NULL)
    plugin->free_exploded_string (plugin, argv);

char *argv;
int argc;
argv = plugin->explode_string (plugin, string, " ", 0, &argc);
...
if (argv != NULL)
    plugin->free_exploded_string (plugin, argv);

if (!plugin->mkdir_home (plugin, "temp"))
    plugin->print_server(plugin, "Failed to create 'temp' directory in WeeChat home.");

int callback (t_weechat_plugin *plugin, char *file)
{
    plugin->print_server (plugin, "file: %s", file);
    return 1;
}
...
plugin->exec_on_files (plugin, "/tmp", &callback);

plugin->print (plugin, NULL, NULL, "hello");
plugin->print (plugin, NULL, "#weechat", "hello");
plugin->print (plugin, "freenode", "#weechat", "hello");
plugin->print (plugin, NULL, NULL,
               "test: \x02 bold \x0F\x03%02d blue \x03%02d green",
               plugin->get_irc_color (plugin, "blue"),
               plugin->get_irc_color (plugin, "green"));

plugin->print_server (plugin, "hello");
plugin->print_infobar (plugin, 5, "hello");

plugin->infobar_remove (1);
plugin->log (plugin, "freenode", "#weechat", "test");

int msg_kick (t_weechat_plugin *plugin, int argc, char **argv,
              char *handler_args, void *handler_pointer)
{
    plugin->print (plugin, argv[0], NULL, "KICK received");
    return PLUGIN_RC_OK;
}
...
t_plugin_handler *msg_handler;
msg_handler = plugin->msg_handler_add (plugin, "KICK",
                                       &msg_kick, NULL, NULL);

int cmd_test (t_weechat_plugin *plugin, int argc, char **argv,
              char *handler_args, void *handler_pointer)
{
    plugin->print (plugin, argv[0], NULL,
                   "test command, nick: %s",
                   (argv[2]) ? argv[2] : "none");
    return PLUGIN_RC_OK;
}
...
t_plugin_handler *cmd_handler;
cmd_handler = plugin->cmd_handler_add (plugin, "test", "Test command",
                                       "[nick]", "nick: nick of channel",
                                       "%n", &cmd_test, NULL, NULL);

int my_timer (t_weechat_plugin *plugin, int argc, char **argv,
              char *handler_args, void *handler_pointer)
{
    plugin->print (plugin, NULL, NULL, "my timer");
    return PLUGIN_RC_OK;
}
...
t_plugin_handler *timer_handler;
timer_handler = plugin->timer_handler_add (plugin, 60, &my_timer);

int my_keyb (t_weechat_plugin *plugin, int argc, char **argv,
             char *handler_args, void *handler_pointer)
{
    if (argc == 2)
    {
        plugin->print (plugin, NULL, NULL, "key pressed: %s", argv[0]);
        if (argv[1] && (argv[1][0] == '1'))
            plugin->print (plugin, NULL, NULL, "input text changed");
        else
            plugin->print (plugin, NULL, NULL, "input text not changed");
    }
    return PLUGIN_RC_OK;
}
...
t_plugin_handler *keyb_handler;
keyb_handler = plugin->keyboard_handler_add (plugin, &my_keyb);

int my_event (t_weechat_plugin *plugin, int argc, char **argv,
              char *handler_args, void *handler_pointer)
{
    plugin->print (plugin, NULL, NULL, "my_event");
    return PLUGIN_RC_OK;
}
...
t_plugin_handler *event_handler;
event_handler = plugin->event_handler_add (plugin, "buffer_open",
                                           &my_event);

plugin->handler_remove (plugin, my_handler);
plugin->handler_remove_all (plugin);
char *adder (t_weechat_plugin *plugin, int argc, char **argv,
             char *modifier_args, void *modifier_pointer)
{
    char *string;
    string = (char *)malloc (strlen (argv[1]) + 16);
    strcpy (string, argv[1]);
    strcat (string, "test");
    return string;
}
...
t_plugin_modifier *modifier;
modifier = plugin->modifier_add (plugin, "irc_in", "privmsg",
                                 &adder, NULL, NULL);

plugin->modifier_remove (plugin, my_modifier);
plugin->modifier_remove_all (plugin);
plugin->exec_command (plugin, NULL, NULL, "/help nick");
plugin->exec_command (plugin, "freenode", "#weechat", "hello");

char *version = plugin->get_info (plugin, "version", NULL);
char *nick = plugin->get_info (plugin, "nick", "freenode");
char *inactivity = plugin->get_info (plugin, "inactivity", NULL);

plugin->print (plugin, NULL, NULL,
               "WeeChat version %s, you are %s on freenode "
               "(inactive for %s seconds)",
               version, nick, inactivity);

if (version)
    free (version);
if (nick)
    free (nick);
if (inactivity)
    free (inactivity);

t_plugin_dcc_info *dcc_info = plugin->get_dcc_info (plugin);
for (ptr_dcc = dcc_info; ptr_dcc; ptr_dcc = ptr_dcc->next_dcc)
{
    plugin->print_server (plugin, "DCC type=%d, with: %s",
                          ptr_dcc->type, ptr_dcc->nick);
}
if (dcc_info)
    plugin->free_dcc_info (plugin, dcc_info);

plugin->free_dcc_info (plugin, dcc_info);
t_plugin_server_info *server_info, *ptr_server_info;
server_info = plugin->get_server_info (plugin);
if (server_info)
{
    for (ptr_server_info = server_info; ptr_server_info;
         ptr_server_info = ptr_server_info->next_server)
    {
        plugin->print (plugin, NULL, NULL,
                       "server: %s, address: %s, port: %d %s",
                       ptr_server_info->name,
                       ptr_server_info->address,
                       ptr_server_info->port,
                       (ptr_server_info->is_connected) ? "(connected)" : "");
    }
    plugin->free_server_info (plugin, server_info);
}

plugin->free_server_info (plugin, server_info);
t_plugin_channel_info *channel_info, *ptr_chan_info;
channel_info = plugin->get_channel_info (plugin, "freenode");
if (channel_info)
{
    for (ptr_chan_info = channel_info; ptr_chan_info;
         ptr_chan_info = ptr_chan_info->next_channel)
    {
        plugin->print (plugin, NULL, NULL,
                       "  %s (type %d)",
                       ptr_chan_info->name,
                       ptr_chan_info->type);
    }
    plugin->free_channel_info (plugin, channel_info);
}

plugin->free_channel_info (plugin, channel_info);
t_plugin_nick_info *nick_info, *ptr_nick_info;
nick_info = plugin->get_nick_info (plugin, "freenode", "#weechat");
if (nick_info)
{
    for (ptr_nick_info = nick_info; ptr_nick_info;
         ptr_nick_info = ptr_nick_info->next_nick)
    {
        plugin->print (plugin, NULL, NULL,
                       "  %s (flags: %d)",
                       ptr_nick_info->nick,
                       ptr_nick_info->flags);
    }
    plugin->free_nick_info (plugin, nick_info);
}

plugin->free_nick_info (plugin, nick_info);
char *value1 = plugin->get_config (plugin, "look_set_title");
char *value2 = plugin->get_config (plugin, "freenode.server_autojoin");

plugin->set_config (plugin, "look_nicklist", "off");

char *value = plugin->get_plugin_config (plugin, "my_var");

plugin->set_plugin_config (plugin, "my_var", "value");

int color_blue = plugin->get_irc_color (plugin, "blue"); /* return 2 */

plugin->input_color (plugin, plugin->get_irc_color (plugin, "blue"), 10, 5);

t_plugin_window_info *window_info, *ptr_window;

window_info = plugin->get_window_info (plugin);
if (window_info)
{
    for (ptr_window = window_info; ptr_window; ptr_window = ptr_window->next_window)
    {
        plugin->print (plugin, NULL, NULL, "--- window info ---");
        plugin->print (plugin, NULL, NULL, "(%d,%d), size: %dx%d, %%size: %d%%x%d%%",
                       ptr_window->win_x, ptr_window->win_y,
                       ptr_window->win_width, ptr_window->win_height,
                       ptr_window->win_width_pct, ptr_window->win_height_pct);
        plugin->print (plugin, NULL, NULL, "num_buffer: %d", ptr_window->num_buffer);
    }
    plugin->free_window_info (plugin, window_info);
}
else
    plugin->print (plugin, NULL, NULL, "no window info!");

plugin->free_window_info (plugin, window_info);
t_plugin_buffer_info *buffer_info, *ptr_buffer;

buffer_info = plugin->get_buffer_info (plugin);
if (buffer_info)
{
    for (ptr_buffer = buffer_info; ptr_buffer; ptr_buffer = ptr_buffer->next_buffer)
    {
        plugin->print (plugin, NULL, NULL, "--- buffer info ---");
        plugin->print (plugin, NULL, NULL, "type: %d", ptr_buffer->type);
        plugin->print (plugin, NULL, NULL, "number: %d", ptr_buffer->number);
        plugin->print (plugin, NULL, NULL, "num_displayed: %d", ptr_buffer->num_displayed);
        plugin->print (plugin, NULL, NULL, "server: %s", ptr_buffer->server_name);
        plugin->print (plugin, NULL, NULL, "channel: %s", ptr_buffer->channel_name);
        plugin->print (plugin, NULL, NULL, "notify level: %d", ptr_buffer->notify_level);
        plugin->print (plugin, NULL, NULL, "log filename: %s", ptr_buffer->log_filename);
    }
    plugin->free_buffer_info (plugin, buffer_info);
}
else
    plugin->print (plugin, NULL, NULL, "no buffer info!");

plugin->free_buffer_info (plugin, buffer_info);
t_plugin_buffer_line *buffer_line, *ptr_line;
char text_time[256];

buffer_line = plugin->get_buffer_data (plugin);
if (buffer_line)
{
    for (ptr_line = buffer_line; ptr_line; ptr_line = ptr_line->next_line)
    {
        strftime (text_time, sizeof (text_time), "%x %X", localtime (&(ptr_line->date)));
        plugin->print (plugin, NULL, NULL, "date: %s, nick: %s, data: %s",
                       text_time, ptr_line->nick, ptr_line->data);
    }
    plugin->free_buffer_data (plugin, buffer_line);
}

plugin->free_buffer_data (plugin, buffer_line);
$ gcc -fPIC -Wall -c toto.c
$ gcc -shared -fPIC -o libtoto.so toto.o

/plugin load toto
#include <stdlib.h>

#include "weechat-plugin.h"

char plugin_name[]        = "Double";
char plugin_version[]     = "0.1";
char plugin_description[] = "Test plugin for WeeChat";

/* "/double" command manager */

int double_cmd (t_weechat_plugin *plugin, int argc, char **argv,
                char *handler_args, void *handler_pointer)
{
    if (argv[2] && (argv[2][0] != '/'))
    {
        plugin->exec_command (plugin, NULL, NULL, argv[2]);
        plugin->exec_command (plugin, NULL, NULL, argv[2]);
    }
    return PLUGIN_RC_OK;
}

int weechat_plugin_init (t_weechat_plugin *plugin)
{
    plugin->cmd_handler_add (plugin, "double",
                             "Display two times a message",
                             "msg",
                             "msg: message to display two times",
                             NULL,
                             &double_cmd,
                             NULL, NULL);
    return PLUGIN_RC_OK;
}

void weechat_plugin_end (t_weechat_plugin *plugin)
{
    /* nothing done here */
}

/plugin load charset
-P- Charset plugin starting, terminal charset: ISO-8859-15 (WeeChat internal: UTF-8)

/setp charset.global.decode = ISO-8859-15
/setp charset.global.encode = ISO-8859-15

/charset ISO-8859-15
/charset decode ISO-8859-15
/charset encode ISO-8859-15

ldd /path/to/weechat-curses
/setp charset.global.decode = ISO-8859-15
weechat::register("test", "1.0", "end_test", "WeeChat perl script");
import weechat
weechat.register("test", "1.0", "end_test", "WeeChat python script")
def weechat_init
    Weechat.register("test", "1.0", "end_test", "WeeChat ruby script")
    Weechat.add_command_handler("command", "my_command")
    return Weechat::PLUGIN_RC_OK
end

def my_command(server, args)
    Weechat.print("my command")
    return Weechat::PLUGIN_RC_OK
end

function message_handler(server, args)
   weechat.print("I am a message handler")
   return weechat.PLUGIN_RC_OK()
end

# perl
weechat::register("test", "1.0", "end_test", "Test script!", "ISO-8859-1");

# python
weechat.register("test", "1.0", "end_test", "Test script!", "ISO-8859-1")

# ruby
Weechat.register("test", "1.0", "end_test", "Test script!", "ISO-8859-1")

-- lua
weechat.register("test", "1.0", "end_test", "Test script!", "ISO-8859-1")

# perl
weechat::set_charset("ISO-8859-1");

# python
weechat.set_charset("ISO-8859-1")

# ruby
Weechat.set_charset("ISO-8859-1")

-- lua
weechat.set_charset("ISO-8859-1")

# perl
weechat::print("message");
weechat::print("message", "#weechat");
weechat::print("message", "#weechat", "freenode");
weechat::print("test: \x0305 red \x0F normal");

# python
weechat.prnt("message")
weechat.prnt("message", "#weechat")
weechat.prnt("message", "#weechat", "freenode")

# ruby
Weechat.print("message")
Weechat.print("message", "#weechat")
Weechat.print("message", "#weechat", "freenode")

-- lua
weechat.print("message")
weechat.print("message", "#weechat")
weechat.print("message", "#weechat", "freenode")

# perl
weechat::print_server("message");
weechat::print_server("test: \x0305 red \x0F normal");

# python
weechat.print_server("message")

# ruby
Weechat.print_server("message")

-- lua
weechat.print_server("message")

# perl
weechat::print_infobar(5, "message");

# python
weechat.print_infobar(5, "message")

# ruby
Weechat.print_infobar(5, "message")

-- lua
weechat.print_infobar(5, "message")

# perl
weechat::remove_infobar(1);

# python
weechat.remove_infobar(1)

# ruby
Weechat.remove_infobar(1)

-- lua
weechat.remove_infobar(1)

# perl
weechat::log("message", "#weechat", "freenode");

# python
weechat.log("message", "#weechat", "freenode")

# ruby
Weechat.log("message", "#weechat", "freenode")

-- lua
weechat.log("message", "#weechat", "freenode")

# perl
weechat::add_message_handler ("privmsg", "my_function");
sub my_function
{
    weechat::print("server=$_[0]");
    ($null, $channel, $message) = split ":",$_[1],3;
    ($mask, $null, $channel) = split " ", $channel;
    weechat::print("mask=$mask, channel=$channel, msg=$message");
    return weechat::PLUGIN_RC_OK;
}

# python
weechat.add_message_handler ("privmsg", "my_function")
def my_function(server, args):
    weechat.prnt("server="+server)
    null, channel, message = string.split(args, ":", 2)
    mask, null, channel = string.split(string.strip(channel), " ", 2)
    weechat.prnt("mask="+mask+", canal="+channel+", message="+message)
    return weechat.PLUGIN_RC_OK

# ruby
Weechat.add_message_handler("privmsg", "my_function")
def my_function(server, args)
    Weechat.print("server=#{server}, args=#{args}")
    return Weechat::PLUGIN_RC_OK
end

-- lua
weechat.add_message_handler ("privmsg", "my_function")
function my_function(server, args)
    weechat.print("server=" .. server .. ", args=" .. args)
    return weechat.PLUGIN_RC_OK()
end

# perl
weechat::add_command_handler("command", "my_command");
sub my_command
{
    weechat::print("server= $_[0], args: $_[1]");
    return weechat::PLUGIN_RC_OK;
}

# python
weechat.add_command_handler("command", "my_command")
def my_command(server, args):
    weechat.prnt("server="+server+", args="+args)
    return weechat.PLUGIN_RC_OK

# ruby
Weechat.add_command_handler("command", "my_command")
def my_command(server, args)
    Weechat.print("server=#{server}, args=#{args}")
    return Weechat::PLUGIN_RC_OK
end

-- lua
weechat.add_command_handler("command", "my_command")
def my_command(server, args)
    weechat.print("server="..server..", args="..args)
    return weechat.PLUGIN_RC_OK()
end

# perl
weechat::add_timer_handler(60, "my_timer");
sub my_timer
{
    weechat::print("this is timer handler");
    return weechat::PLUGIN_RC_OK;
}

# python
weechat.add_timer_handler(60, "my_timer")
def my_timer():
    weechat.prnt("this is timer handler")
    return weechat.PLUGIN_RC_OK

# ruby
Weechat.add_timer_handler(60, "my_timer")
def my_timer()
    Weechat.print("this is timer handler")
    return Weechat::PLUGIN_RC_OK
end

-- lua
weechat.add_timer_handler(60, "my_timer")
function my_timer()
    weechat.print("this is timer handler")
    return weechat.PLUGIN_RC_OK()
end

# perl
weechat::add_keyboard_handler("my_keyboard");
sub my_keyboard
{
    my $key = shift;
    my $input_before = shift;
    my $input_after = shift;
    weechat::print("keyboard handler: key = '$key', "
                   ."input before = '$input_before' "
                   ."after = '$input_after'");
    return weechat::PLUGIN_RC_OK;
}

# python
weechat.add_keyboard_handler("my_keyboard")
def my_keyboard(key, input_before, input_after):
    weechat.prnt("keyboard handler: key = '%s', " \
                 "input before = '%s' after = '%s'"
                 %(key, input_before, input_after))
    return weechat.PLUGIN_RC_OK

# ruby
Weechat.add_keyboard_handler("my_keyboard")
def my_keyboard(key, input_before, input_after)
    Weechat.print("keyboard handler: key = '#{key}', " \
                  "input before = '#{input_before}' " \
                  "after = '#{input_after}'")
    return Weechat::PLUGIN_RC_OK
end

-- lua
weechat.add_keyboard_handler("my_keyboard")
function my_keyboard(key, input_before, input_after)
    weechat.print("keyboard handler: key = '"..key..
                  "', input before = '"..input_before..
                  "' after = '"..input_after.."'")
    return weechat.PLUGIN_RC_OK()
end

# perl
weechat::add_event_handler("buffer_open", "my_event");
sub my_event
{
    weechat::print("buffer open");
    return weechat::PLUGIN_RC_OK;
}

# python
weechat.add_event_handler("buffer_open", "my_event")
def my_event():
    weechat.prnt("buffer open")
    return weechat.PLUGIN_RC_OK

# ruby
Weechat.add_event_handler("buffer_open", "my_event")
def my_event()
    Weechat.print("buffer open")
    return Weechat::PLUGIN_RC_OK
end

-- lua
weechat.add_event_handler("buffer_open", "my_event")
function my_event()
    weechat.print("buffer open")
    return weechat.PLUGIN_RC_OK()
end

# perl
weechat::remove_handler("command", "my_command");

# python
weechat.remove_handler("command", "my_command")

# ruby
Weechat.remove_handler("command", "my_command")

-- lua
weechat.remove_handler("command", "my_command")

# perl
weechat::remove_timer_handler("my_timer");

# python
weechat.remove_timer_handler("my_timer")

# ruby
Weechat.remove_timer_handler("my_timer")

-- lua
weechat.remove_timer_handler("my_timer")

# perl
weechat::remove_keyboard_handler("my_keyboard");

# python
weechat.remove_keyboard_handler("my_keyboard")

# ruby
Weechat.remove_keyboard_handler("my_keyboard")

-- lua
weechat.remove_keyboard_handler("my_keyboard")

# perl
weechat::remove_event_handler("my_event");

# python
weechat.remove_event_handler("my_event")

# ruby
Weechat.remove_event_handler("my_event")

-- lua
weechat.remove_event_handler("my_event")

# perl
weechat::add_modifier("irc_in", "privmsg", "mod_in");
weechat::add_modifier("irc_out", "privmsg", "mod_out");
sub mod_in
{
    return "$_[1] [modifier IN]";
}
sub mod_out
{
    return "$_[1] [modifier OUT]";
}

# python
weechat.add_modifier("irc_in", "privmsg", "mod_in")
weechat.add_modifier("irc_out", "privmsg", "mod_out")
def mod_in(serveur, args):
    return args + " [modifier IN]"
def mod_out(serveur, args):
    return args + " [modifier OUT]"

# ruby
Weechat.add_modifier("irc_in", "privmsg", "mod_in")
Weechat.add_modifier("irc_out", "privmsg", "mod_out")
def mod_in(server, args)
    return args + " [modifier IN]"
end
def mod_out(server, args)
    return args + " [modifier OUT]"
end

-- lua
weechat.add_modifier("irc_in", "privmsg", "mod_in")
weechat.add_modifier("irc_out", "privmsg", "mod_out")
function mod_in(server, args)
    return args .. " [modifier IN]"
end
function mod_out(server, args)
    return args .. " [modifier OUT]"
end

# perl
weechat::remove_modifier("irc_in", "privmsg", "mod_in");

# python
weechat.remove_modifier("irc_in", "privmsg", "mod_in")

# ruby
Weechat.remove_modifier("irc_in", "privmsg", "mod_in")

-- lua
weechat.remove_modifier("irc_in", "privmsg", "mod_in")

# perl
weechat::command("hello everybody!");
weechat::command("/kick toto please leave this channel", "#weechat");
weechat::command("/nick newnick", "", "freenode");

# python
weechat.command("hello everybody!")
weechat.command("/kick toto please leave this channel", "#weechat")
weechat.command("/nick newnick", "", "freenode")

# ruby
Weechat.command("hello everybody!")
Weechat.command("/kick toto please leave this channel", "#weechat")
Weechat.command("/nick newnick", "", "freenode")

-- lua
weechat.command("hello everybody!")
weechat.command("/kick toto please leave this channel", "#weechat")
weechat.command("/nick newnick", "", "freenode")

# perl
$version = get_info("version");
$nick = get_info("nick", "freenode");

# python
version = weechat.get_info("version")
nick = weechat.get_info("nick", "freenode")

# ruby
version = Weechat.get_info("version")
nick = Weechat.get_info("nick", "freenode")

-- lua
version = weechat.get_info("version")
nick = weechat.get_info("nick", "freenode")

# perl
my @dccs = weechat::get_dcc_info();
if (@dccs)
{
    foreach my $dcc (@dccs)
    {
        while (my ($key, $value) = each %$dcc)
        {
            weechat::print("$key = '$value'");
        }
    }
}
else
{
    weechat::print("no DCC");
}

# python
dccs = weechat.get_dcc_info()
if dccs != None:
    if dccs == []:
        weechat.prnt("no DCC")
    else:
        for d in dccs:
            for b in d.keys():
                weechat.prnt("%s = '%s'" %(b, d[b]))
else:
    weechat.prnt("error while getting DCC")

# ruby
dccs = Weechat.get_dcc_info()
if dccs != nil   
    if dccs == []
        Weechat.print("no DCC")
    else
        dccs.each do |m|
            m.each do |key, value|
                Weechat.print("#{key} = '#{value}'")
            end
        end
    end
else
    Weechat.print("error while getting DCC")
end

-- lua
dccs = weechat.get_dcc_info()
if dccs ~= nil then
    if dccs then
        dcc, dccinfos = next (dccs, nil)
        while (dcc) do
            key, value = next (dccinfos, nil)
            while (key) do
                weechat.print(key.." = '"..value.."'")
                key, value = next (dccinfos, key)
            end
            dcc, dccinfos = next (dccs, dcc)
        end 
    else
        weechat.print("no DCC")
    end
else
    weechat.print("error while getting DCC")
end

# perl
my $servers = weechat::get_server_info();
if ($servers)
{
    while (my ($srvname, $srvinfos) = each %$servers)
    {
        while ( my ($key, $value) = each %$srvinfos)
        {
            weechat::print("$srvname -> $key = '$value'");
        }
    }
}
else
{
    weechat::print("no server");
}

# python
servers = weechat.get_server_info()
if servers != None:
    if servers == {}:
        weechat.prnt("no server")
    else:
        for s in servers:
            for i in servers[s]:
                weechat.prnt("%s -> %s = '%s'" % (s, i, str(servers[s][i])))
else:
    weechat.prnt("error while getting servers")

# ruby
servers = Weechat.get_server_info()
if servers != nil
    if servers == []
        Weechat.print("no server")
    else
        servers.each do |n, s|
            s.each do |key, value|
                Weechat.print("#{n} -> #{key} = '#{value}'")
            end
        end
    end
else
    Weechat.print("error while getting servers")
end

-- lua
servers = weechat.get_server_info()
if servers ~= nil then
    if servers then
        srv, srvinfos = next (servers, nil)
        while (srv) do
            key, value = next (srvinfos, nil)
            while (key) do
                weechat.print(srv.." -> "..key.." = '"..value.."'")
                key, value = next (srvinfos, key)
            end	
            srv, srvinfos = next (servers, srv)
        end
    else
        weechat.print("no server")
    end
else
    weechat.print("error while getting servers")
end

# perl
my $channels = weechat::get_channel_info(weechat::get_info("server"));
if ($channels)
{
    while (my ($channame, $chaninfos) = each %$channels)
    {
        while (my ($key, $value) = each %$chaninfos)
        {
            weechat::print("$channame -> $key = '$value'");
        }
    }
}
else
{
    weechat::print("no channel");
}

# python
chans = weechat.get_channel_info(weechat.get_info("server"))
if chans != None:
    if chans == {}:
        weechat.prnt("no channel")
    else:
        for s in chans:
            for i in chans[s]:
                weechat.prnt("%s -> %s = '%s'" % (s, i, str(chans[s][i])))
else:
    weechat.prnt("error while getting channels")

# ruby
channels = Weechat.get_channel_info(Weechat.get_info("server"))
if channels != nil
    if channels == {}
        Weechat.print("no channel")
    else
        channels.each do |n, c|
            c.each do |key, value|
                Weechat.print("#{n} -> #{key} = '#{value}'")
            end
        end
    end
else
    Weechat.print("error while getting channels")
end

-- lua
chans = weechat.get_channel_info(weechat.get_info("server"))
if chans ~= nil then
    if chans then
        chan, chaninfos = next (chans, nil)
        while (chan) do
            key, value = next (chaninfos, nil)
            while (key) do
                weechat.print(chan.." -> "..key.." = '"..value.."'")
                key, value = next (chaninfos, key)
            end
            chan, chaninfos = next (chans, chan)
        end
    else
        weechat.print("no channel")
    end
else
    weechat.print("error while getting channels")
end

# perl
my $nicks = weechat::get_nick_info("freenode", "#weechat");
if ($nicks)
{
    while (my ($nickname, $nickinfos) = each %$nicks)
    {
        while ( my ($key, $value) = each %$nickinfos)
        {
            weechat::print("$nickname -> $key = '$value'");
        }
    }
}
else
{
    weechat::print("no nick");
}

# python
nicks = weechat.get_nick_info("freenode", "#weechat")
if nicks != None:
    if nicks == {}:
        weechat.prnt("no nick")
    else:
        for n in nicks:
            for f in nicks[n]:
                weechat.prnt("%s -> %s = '%s'" % (n, f, str(nicks[n][f])))
else:
    weechat.prnt("error while getting nicks")

# ruby
nicks = Weechat.get_nick_info("freenode", "#weechat")
if nicks != nil
    if nicks == {}
        Weechat.print("no nick")
    else
        nicks.each do |nk, nattr|
            nattr.each do |key, value|
                Weechat.print("#{nk} -> #{key} = '#{value}'")
            end
        end
    end
else
    Weechat.print("error while getting nicks")
end

-- lua
nicks = weechat.get_nick_info("freenode", "#weechat")
if nicks ~= nil then
    if nicks then	
        nick, nickinfos = next (nicks, nil)
        while (nick) do
            key, value = next (nickinfos, nil)
            while (key) do
                weechat.print(nick.." -> "..key.." = '"..value.."'")
                key, value = next (nickinfos, key)
            end
            nick, nickinfos = next (nicks, nick)
        end
    else
        weechat.print("no nick")
    end
else
    weechat.print("error while getting nicks")
end

# perl
$value1 = weechat::get_config("look_nicklist");
$value2 = weechat::get_config("freenode.server_autojoin");

# python
value1 = weechat.get_config("look_nicklist")
value2 = weechat.get_config("freenode.server_autojoin")

# ruby
value1 = Weechat.get_config("look_nicklist")
value2 = Weechat.get_config("freenode.server_autojoin")

-- lua
value1 = weechat.get_config("look_nicklist")
value2 = weechat.get_config("freenode.server_autojoin")

# perl
weechat::set_config("look_nicklist", "off");
weechat::set_config("freenode.server_autojoin", "#weechat");

# python
weechat.set_config("look_nicklist", "off")
weechat.set_config("freenode.server_autojoin", "#weechat")

# ruby
Weechat.set_config("look_nicklist", "off")
Weechat.set_config("freenode.server_autojoin", "#weechat")

-- lua
weechat.set_config("look_nicklist", "off")
weechat.set_config("freenode.server_autojoin", "#weechat")

# perl
$value = weechat::get_plugin_config("my_var");

# python
value = weechat.get_plugin_config("my_var")

# ruby
value = Weechat.get_plugin_config("my_var")

-- lua
value = weechat.get_plugin_config("my_var")

# perl
weechat::set_plugin_config("my_var", "value");

# python
weechat.set_plugin_config("my_var", "value")

# ruby
Weechat.set_plugin_config("my_var", "value")

-- lua
weechat.set_plugin_config("my_var", "value")

# perl
my $color_blue = weechat::get_irc_color("blue");

# python
color_blue = weechat.get_irc_color("blue")

# ruby
color_blue = Weechat.get_irc_color("blue")

-- lua
color_blue = weechat.get_irc_color("blue")

# perl
weechat::input_color(weechat::get_irc_color("blue"), 10, 5);

# python
weechat.input_color(weechat.get_irc_color("blue"), 10, 5)

# ruby
Weechat.input_color(Weechat.get_irc_color("blue"), 10, 5)

-- lua
weechat.input_color(weechat.get_irc_color("blue"), 10, 5)

# perl
my @wf = weechat::get_window_info();
if (@wf)
{
    weechat::print("**** windows infos ****");
    foreach my $w (@wf)
    {
        while ( my ($key, $value) = each %$w)
        {
            weechat::print(" > $key => $value");
        }
        weechat::print("----------------------");
    }
}
else
{
    weechat::print("**** no window info ****");
}

# python
wf = weechat.get_window_info()
if wf != None and wf != []:
    weechat.prnt ("**** windows infos ****")
    for w in wf:
        for i in w:
            weechat.prnt (" > %s => %s" % (i, w[i]))
        weechat.prnt ("----------------------")
else:
    weechat.prnt ("**** no window info ****")

# ruby
wf = Weechat.get_window_info()
if wf != nil and wf != []   
    Weechat.print("**** windows infos ****")
    wf.each do |w|
        w.each do |key, value|
            Weechat.print(" > #{key} => #{value}")
        end
        Weechat.print("----------------------")
    end
else
    Weechat.print("**** no window info ****")
end

-- lua
wf = weechat.get_window_info()
if wf then
    weechat.print ("**** windows infos ****")
    w, winfos = next (wf, nil)
    while (w) do
        key, value = next (winfos, nil)
        while (key) do
            weechat.print(" > " .. key .. " => " .. value)
            key, value = next (winfos, key)
        end
        weechat.print ("----------------------")
        w, winfos = next (wf, w)
    end
else
    weechat.print("**** no window info ****")
end

# perl
my $bf = weechat::get_buffer_info();
if ($bf)
{
    while ( my ($nobuf, $binfos) = each %$bf)
    {
        while ( my ($key, $value) = each %$binfos)
        {
            weechat::print(" > $key => $value");
        }
        weechat::print("----------------------");
    }
}
else
{
    weechat::print("**** no buffer info ****");
}

# python
bf = weechat.get_buffer_info()
if bf != None and bf != {}:
    for b in bf:
        weechat.prnt ("**** info for buffer no %d ****" % b)
        for c in bf[b]:
            weechat.prnt (" > %s => %s" % (c, bf[b][c]))
        weechat.prnt ("----------------------")
else:
    weechat.prnt ("**** no buffer info ****")

# ruby
bf = Weechat.get_buffer_info()
if bf != nil and bf != {}
    bf.each do |n, c|
        Weechat.print("**** info for buffer no #{n} ****")
        c.each do |key, value|
            Weechat.print(" > #{key} => #{value}")
        end
        Weechat.print("----------------------")
    end
else
    Weechat.print("**** no buffer info ****")
end

-- lua
bf = weechat.get_buffer_info()
if bf then
    b, binfos = next (bf, nil)
    while (b) do
        weechat.print("**** info for buffer no " .. b .. " ****")
        key, value = next (binfos, nil)
        while (key) do
            weechat.print(" > " .. key .. " => " .. value)
            key, value = next (binfos, key)
        end
        weechat.print ("----------------------")
        b, infos = next (bf, b)
    end
else
    weechat.print("**** no buffer info ****")
end

# perl
my $server = weechat::get_info("server");
my $channel = weechat::get_info("channel");
my @bc = weechat::get_buffer_data($server, $channel);
if (@bc)
{
    weechat::print("**** buffer data for '$channel'\@'$server' ****");
    foreach my $l (@bc) {
        while ( my ($key, $value) = each %$l) {
            weechat::print(" > $key => $value");
        }
        weechat::print("----------------------");
    }
}
else
{
    weechat::print("**** no buffer data ****");
}

# python
server = weechat.get_info("server")
channel = weechat.get_info("channel")
bc = weechat.get_buffer_data(server, channel)
if bc != None and bc != []:
    weechat.prnt ("**** buffer data for '%s'@'%s' ****" % (channel, server))
    for l in bc:
        for i in l:
            weechat.prnt (" > %s => %s" % (i, l[i]))
        weechat.prnt ("----------------------")
else:
    weechat.prnt ("**** no buffer data ****")

# ruby
server = Weechat.get_info("server")
channel = Weechat.get_info("channel")
bc = Weechat.get_buffer_data(server, channel)
if bc != nil and bc != []   
    Weechat.print("**** buffer data for '#{channel}'@'#{server}' ****")
    bc.each do |l|
        l.each do |key, value|
            Weechat.print(" > #{key} => #{value}")
        end
        Weechat.print("----------------------")
    end
else
    Weechat.print("**** no buffer data ****")
end

-- lua
server = weechat.get_info("server")
channel = weechat.get_info("channel")
bc = weechat.get_buffer_data(server, channel)
if bc then
    b, bdatas = next (bc, nil)
    weechat.print("**** buffer data for '" .. channel .. "'@'" .. server .. "' ****")
    while (b) do 
        key, value = next (bdatas, nil)
        while (key) do
            weechat.print(" > " .. key .. " => " .. value)
            key, value = next (bdatas, key)
        end
        weechat.print ("----------------------")
        b, bdatas = next (bc, b)
    end
else
    weechat.print("**** no buffer data ****")
end

Parameter	Description
`-a, --no-connect`	Disable auto-connect to servers at startup
`-c, --config`	Display config help (list of options)
`-d, --dir <path>`	Set path as home for WeeChat (used for configuration files, logs, user plugins and scripts). Default value is "`~/.weechat`". Please note that directory is created if not found by WeeChat.
`-f, --key-functions`	Display WeeChat internal functions for keys
`-h, --help`	Display help
`-i, --irc-commands`	Display IRC commands list
`-k, --keys`	Display WeeChat default keys
`-l, --license`	Display WeeChat license
`-p, --no-plugin`	Disable plugins auto-load
`-v, --version`	Display WeeChat version
`-w, --weechat-commands`	Display WeeChat commands list

Key	Action
Left arrow / Ctrl + B	Go to previous char in command line
Right arrow / Ctrl + F	Go to next char in command line
Ctrl + left arrow	Go to previous word in command line
Ctrl + right arrow	Go to next word in command line
Home / Ctrl + A	Go to the beginning of command line
Ctrl + C then B	Insert code for bold text.
Ctrl + C then C	Insert code for colored text.
Ctrl + C then O	Insert code for color reset.
Ctrl + C then R	Insert code for reverse color.
Ctrl + C then U	Insert code for underlined text.
End / Ctrl + E	Go to the end of command line
Ctrl + K	Delete from cursor until end of command line
Ctrl + L	Redraw whole window
Ctrl + R	Search for text in buffer history (two times: search exact text)
Ctrl + S then Ctrl + U	Set unread marker on all buffers
Ctrl + T	Transpose chars
Ctrl + U	Delete from cursor until beginning of command line
Ctrl + W	Delete previous word of command line
Ctrl + Y	Paste clipboard content
Backspace / Ctrl + H	Delete previous char in command line
Delete / Ctrl + D	Delete next char in command line
Tab / Shift + Tab	Complete command or nick (Tab again: find next completion)
Any char	Insert char at cursor position in command line
Enter / Ctrl + J / Ctrl + M	Execute command or send message (in search mode: stop search)
Up arrow / Down arrow	Call again last commands/messages (in search mode: search up/down)
Ctrl + up arrow / Ctrl + down arrow	Call again last commands/messages in global history (common for all buffers)
PageUp / PageDown	Scroll up / down one page in buffer history
Alt + PageUp / Alt + PageDown	Scroll up / down a few lines in buffer history
Alt + Home / Alt + End	Scroll to top / bottom of buffer
F5 / Alt + left arrow	Switch to previous buffer
F6 / Alt + right arrow	Switch to next buffer
F7	Switch to previous window
F8	Switch to next window
F9 / F10	Scroll topic
F11 / F12	Scroll nicklist
Alt + F11 / Alt + F12	Go to the beginning / the end of nicklist
Alt + A	Switch to next buffer with activity (with priority: highlight, message, other)
Alt + B	Go to previous word in command line
Alt + D	Delete next word in command line
Alt + F	Go to next word in command line
Alt + H	Clear hotlist (activity notification on other buffers)
Alt + I	Remove last infobar message
Alt + J then Alt + D	Display DCC buffer
Alt + J then Alt + L	Switch to last buffer
Alt + J then Alt + P	Switch to buffer previously displayed
Alt + J then Alt + R	Switch to raw IRC data buffer
Alt + J then Alt + S	Switch to server buffer
Alt + J then Alt + X	Switch to first channel of next server (or server buffer if no channel is opened)
Alt + digit (0-9)	Switch to buffer by number (0 = 10)
Alt + J then number (01-99)	Switch to buffer by number
Alt + K	Grab a key and insert its code in command line
Alt + N	Scroll to next highlight
Alt + P	Scroll to previous highlight
Alt + R	Delete entire command line
Alt + S	Switch servers on servers buffer (if option "look_one_server_buffer" is enabled)
Alt + U	Scroll to first unread line in buffer
Alt + W then Alt + arrow	Switch to window with direction

Code	Description
^Cb	bold text
^Ccxx	text color "`xx`" (see colors table below)
^Ccxx,yy	text color "`xx`" and background "`yy`" (see colors table below)
^Co	disable color and attributes
^Cr	reverse video (revert text color with background)
^Cu	underlined text

Code	Color
00	white
01	black
02	dark blue
03	dark green
04	light red
05	dark red
06	magenta
07	orange
08	yellow
09	light green
10	cyan
11	light cyan
12	light blue
13	light magenta
14	gray
15	light gray (white)

Function	Description
`return`	terminate line
`tab`	complete word
`tab_previous`	find previous completion for word
`backspace`	delete previous char
`delete`	delete next char
`delete_end_line`	delete until end of line
`delete_beginning_line`	delete until beginning of line
`delete_line`	delete entire line
`delete_previous_word`	delete previous word
`delete_next_word`	delete next word
`clipboard_paste`	paste current clipboard content
`transpose_chars`	transpose chars
`home`	go to beginning of line
`end`	go to end of line
`left`	move one char left
`previous_word`	move to previous word
`right`	move one char right
`next_word`	move to next word
`up`	call previous command in history
`up_global`	call previous command in global history
`down`	call next command in history
`down_global`	call next command in global history
`page_up`	scroll one page up
`page_down`	scroll one page down
`scroll_up`	scroll a few lines up
`scroll_down`	scroll a few lines down
`scroll_top`	scroll to top of buffer
`scroll_bottom`	scroll to bottom of buffer
`scroll_topic_left`	scroll left topic
`scroll_topic_right`	scroll right topic
`nick_beginning`	display beginning of nicklist
`nick_end`	display end of nicklist
`nick_page_up`	scroll nicklist one page up
`nick_page_down`	scroll nicklist one page down
`jump_smart`	jump to buffer with activity
`jump_dcc`	jump to DCC buffer
`jump_raw_data`	jump to raw IRC data buffer
`jump_last_buffer`	jump to last buffer
`jump_previous_buffer`	jump to previous buffer
`jump_server`	jump to server buffer
`jump_next_server`	jump to next server
`switch_server`	switch active server on servers buffer
`scroll_previous_highlight`	scroll to previous highlight in buffer
`scroll_next_highlight`	scroll to next highlight in buffer
`scroll_unread`	scroll to first unread line in buffer
`set_unread`	set unread marker on all buffers
`hotlist_clear`	clear hotlist
`infobar_clear`	clear infobar
`refresh`	refresh screen
`grab_key`	grab a key
`insert`	insert a string in command line
`search_text`	search text in buffer history

Option	Type	Values	Default	Description
`look_save_on_exit`	boolean	'on' or 'off'	'on'	Save config file on exit
`look_set_title`	boolean	'on' or 'off'	'on'	Set title for window (terminal for Curses GUI) with name and version
`look_startup_logo`	boolean	'on' or 'off'	'on'	Display WeeChat logo at startup
`look_startup_version`	boolean	'on' or 'off'	'on'	Display WeeChat version at startup
`look_weechat_slogan`	string	any string	'the geekest IRC client!'	WeeChat slogan (if empty, slogan is not used)
`look_one_server_buffer`	boolean	'on' or 'off'	'off'	Use same buffer for all servers
`look_open_near_server`	boolean	'on' or 'off'	'off'	Open new channels/privates near server
`look_scroll_amount`	integer	between 1 and 2147483647	3	How many lines to scroll by with scroll_up and scroll_down
`look_buffer_timestamp`	string	any string	'[%H:%M:%S]'	Timestamp for buffers
`look_color_nicks_number`	integer	between 1 and 10	10	Number of colors to use for nicks colors
`look_color_actions`	boolean	'on' or 'off'	'on'	Display actions with different colors
`look_nicklist`	boolean	'on' or 'off'	'on'	Display nicklist window (for channel windows)
`look_nicklist_position`	string	'left', 'right', 'top', 'bottom'	'right'	Nicklist position (top, left, right (default), bottom)
`look_nicklist_min_size`	integer	between 0 and 100	0	Min size for nicklist (width or height, depending on look_nicklist_position (0 = no min size))
`look_nicklist_max_size`	integer	between 0 and 100	0	Max size for nicklist (width or height, depending on look_nicklist_position (0 = no max size; if min = max and > 0, then size is fixed))
`look_nicklist_separator`	boolean	'on' or 'off'	'on'	Separator between chat and nicklist
`look_no_nickname`	string	any string	'-cmd-'	Text to display instead of nick when not connected
`look_nickmode`	boolean	'on' or 'off'	'on'	Display nick mode ((half)op/voice) before each nick
`look_nickmode_empty`	boolean	'on' or 'off'	'off'	Display space if nick mode is not (half)op/voice
`look_nick_prefix`	string	any string	''	Text to display before nick in chat window
`look_nick_suffix`	string	any string	' \|'	Text to display after nick in chat window
`look_align_nick`	string	'none', 'left', 'right'	'right'	Nick alignment (fixed size for nicks in chat window (none, left, right))
`look_align_other`	boolean	'on' or 'off'	'on'	Alignment for other messages (not beginning with a nick)
`look_align_size`	integer	between 8 and 64	14	Size for aligning nick and other messages
`look_align_size_max`	integer	between 8 and 64	20	Max size for aligning nick and other messages (should be >= to look_align_size)
`look_align_text_offset`	integer	between -1 and 64	-1	Offset for aligning lines of messages (except first lines), default is -1 (align after nick), a null or positive value is offset after beginning of line
`look_nick_completor`	string	any string	':'	The string inserted after nick completion
`look_nick_completion_ignore`	string	any string	'[]-^'	Chars ignored for nick completion
`look_nick_completion_smart`	boolean	'on' or 'off'	'on'	Smart completion for nicks (completes with last speakers first)
`look_nick_complete_first`	boolean	'on' or 'off'	'off'	Complete only with first nick found
`look_infobar`	boolean	'on' or 'off'	'on'	Enable info bar
`look_infobar_timestamp`	string	any string	'%B, %A %d %Y'	Timestamp for time in infobar
`look_infobar_seconds`	boolean	'on' or 'off'	'on'	Display seconds in infobar time
`look_infobar_delay_highlight`	integer	between 0 and 2147483647	7	Delay (in seconds) for highlight messages in infobar (0 = disable highlight notifications in infobar)
`look_hotlist_names_count`	integer	between 0 and 32	3	Max number of names in hotlist (0 = no name displayed, only buffer numbers)
`look_hotlist_names_level`	integer	between 1 and 15	12	Level for displaying names in hotlist (combination of: 1=join/part, 2=message, 4=private, 8=highlight, for example: 12=private+highlight)
`look_hotlist_names_length`	integer	between 0 and 32	0	Max length of names in hotlist (0 = no limit)
`look_hotlist_sort`	string	'group_time_asc', 'group_time_desc', 'group_number_asc', 'group_number_desc', 'number_asc', 'number_desc'	'group_time_asc'	Hotlist sort type (group_time_asc (default), group_time_desc, group_number_asc, group_number_desc, number_asc, number_desc)
`look_day_change`	boolean	'on' or 'off'	'on'	Display special message when day changes
`look_day_change_timestamp`	string	any string	'%a, %d %b %Y'	Timestamp for date displayed when day changed
`look_read_marker`	char	any char	' '	Use a marker on servers/channels to show first unread line
`look_input_format`	string	any string	'[%n(%m)] '	Format for input prompt ('%c' is replaced by channel or server, '%n' by nick and '%m' by nick modes)
`look_paste_max_lines`	integer	between 0 and 2147483647	3	Max number of lines for paste without asking user (0 = disable this feature)
`col_real_white`	boolean	'on' or 'off'	'off'	If set, uses real white color, disabled by default for terms with white background (if you never use white background, you should turn on this option to see real white instead of default term foreground color)
`col_separator`	color	Curses or Gtk color	'blue'	Color for window separators (when splited)
`col_title`	color	Curses or Gtk color	'default'	Color for title bar
`col_title_more`	color	Curses or Gtk color	'lightmagenta'	Color for '+' when scrolling topic
`col_title_bg`	color	Curses or Gtk color	'blue'	Background for title bar
`col_chat`	color	Curses or Gtk color	'default'	Color for chat text
`col_chat_time`	color	Curses or Gtk color	'default'	Color for time in chat window
`col_chat_time_sep`	color	Curses or Gtk color	'brown'	Color for time separator (chat window)
`col_chat_prefix1`	color	Curses or Gtk color	'lightcyan'	Color for 1st and 3rd char of prefix
`col_chat_prefix2`	color	Curses or Gtk color	'white'	Color for middle char of prefix
`col_chat_server`	color	Curses or Gtk color	'brown'	Color for server name
`col_chat_join`	color	Curses or Gtk color	'lightgreen'	Color for join arrow (prefix)
`col_chat_part`	color	Curses or Gtk color	'lightred'	Color for part/quit arrow (prefix)
`col_chat_nick`	color	Curses or Gtk color	'lightcyan'	Color for nicks in actions (chat window)
`col_chat_host`	color	Curses or Gtk color	'cyan'	Color for hostnames (chat window)
`col_chat_channel`	color	Curses or Gtk color	'white'	Color for channel names in actions (chat window)
`col_chat_dark`	color	Curses or Gtk color	'green'	Color for dark separators (chat window)
`col_chat_highlight`	color	Curses or Gtk color	'yellow'	Color for highlighted nick (chat window)
`col_chat_bg`	color	Curses or Gtk color	'default'	Background for chat window
`col_chat_read_marker`	color	Curses or Gtk color	'yellow'	Color for unread data marker
`col_chat_read_marker_bg`	color	Curses or Gtk color	'magenta'	Background for unread data marker
`col_status`	color	Curses or Gtk color	'default'	Color for status bar
`col_status_delimiters`	color	Curses or Gtk color	'cyan'	Color for status bar delimiters
`col_status_channel`	color	Curses or Gtk color	'white'	Color for current channel in status bar
`col_status_data_msg`	color	Curses or Gtk color	'yellow'	Color for window with new messages (status bar)
`col_status_private`	color	Curses or Gtk color	'lightmagenta'	Color for window with private message (status bar)
`col_status_highlight`	color	Curses or Gtk color	'lightred'	Color for window with highlight (status bar)
`col_status_data_other`	color	Curses or Gtk color	'default'	Color for window with new data (not messages) (status bar)
`col_status_more`	color	Curses or Gtk color	'white'	Color for window with new data (status bar)
`col_status_bg`	color	Curses or Gtk color	'blue'	Background for status window
`col_infobar`	color	Curses or Gtk color	'black'	Color for info bar text
`col_infobar_delimiters`	color	Curses or Gtk color	'blue'	Color for infobar delimiters
`col_infobar_highlight`	color	Curses or Gtk color	'white'	Color for info bar highlight notification
`col_infobar_bg`	color	Curses or Gtk color	'cyan'	Background for info bar window
`col_input`	color	Curses or Gtk color	'default'	Color for input text
`col_input_server`	color	Curses or Gtk color	'brown'	Color for input text (server name)
`col_input_channel`	color	Curses or Gtk color	'white'	Color for input text (channel name)
`col_input_nick`	color	Curses or Gtk color	'lightcyan'	Color for input text (nick name)
`col_input_delimiters`	color	Curses or Gtk color	'cyan'	Color for input text (delimiters)
`col_input_text_not_found`	color	Curses or Gtk color	'red'	Color for text not found
`col_input_actions`	color	Curses or Gtk color	'lightgreen'	Color for actions in input window
`col_input_bg`	color	Curses or Gtk color	'default'	Background for input window
`col_nick`	color	Curses or Gtk color	'default'	Color for nicknames
`col_nick_away`	color	Curses or Gtk color	'cyan'	Color for away nicknames
`col_nick_chanowner`	color	Curses or Gtk color	'lightgreen'	Color for chan owner symbol (specific to unrealircd)
`col_nick_chanadmin`	color	Curses or Gtk color	'lightgreen'	Color for chan admin symbol (specific to unrealircd)
`col_nick_op`	color	Curses or Gtk color	'lightgreen'	Color for operator symbol
`col_nick_halfop`	color	Curses or Gtk color	'lightmagenta'	Color for half-operator symbol
`col_nick_voice`	color	Curses or Gtk color	'yellow'	Color for voice symbol
`col_nick_user`	color	Curses or Gtk color	'blue'	Color for user symbol
`col_nick_more`	color	Curses or Gtk color	'lightmagenta'	Color for '+' when scrolling nicks
`col_nick_sep`	color	Curses or Gtk color	'blue'	Color for nick separator
`col_nick_self`	color	Curses or Gtk color	'white'	Color for local nick
`col_nick_color1`	color	Curses or Gtk color	'cyan'	Color for nick
`col_nick_color2`	color	Curses or Gtk color	'magenta'	Color for nick
`col_nick_color3`	color	Curses or Gtk color	'green'	Color for nick
`col_nick_color4`	color	Curses or Gtk color	'brown'	Color for nick
`col_nick_color5`	color	Curses or Gtk color	'lightblue'	Color for nick
`col_nick_color6`	color	Curses or Gtk color	'default'	Color for nick
`col_nick_color7`	color	Curses or Gtk color	'lightcyan'	Color for nick
`col_nick_color8`	color	Curses or Gtk color	'lightmagenta'	Color for nick
`col_nick_color9`	color	Curses or Gtk color	'lightgreen'	Color for nick
`col_nick_color10`	color	Curses or Gtk color	'blue'	Color for nick
`col_nick_private`	color	Curses or Gtk color	'default'	Color for other nick in private window
`col_nick_bg`	color	Curses or Gtk color	'default'	Background for nicknames
`col_chat_dcc_selected`	color	Curses or Gtk color	'white'	Color for selected DCC (chat window)
`col_dcc_waiting`	color	Curses or Gtk color	'lightcyan'	Color for "waiting" dcc status
`col_dcc_connecting`	color	Curses or Gtk color	'yellow'	Color for "connecting" dcc status
`col_dcc_active`	color	Curses or Gtk color	'lightblue'	Color for "active" dcc status
`col_dcc_done`	color	Curses or Gtk color	'lightgreen'	Color for "done" dcc status
`col_dcc_failed`	color	Curses or Gtk color	'lightred'	Color for "failed" dcc status
`col_dcc_aborted`	color	Curses or Gtk color	'lightred'	Color for "aborted" dcc status
`history_max_lines`	integer	between 0 and 2147483647	4096	Maximum number of lines in history for one server/channel/private window (0 = unlimited)
`history_max_commands`	integer	between 0 and 2147483647	100	Maximum number of user commands in history (0 = unlimited)
`history_display_default`	integer	between 0 and 2147483647	5	Maximum number of commands to display by default in history listing (0 = unlimited)
`log_auto_server`	boolean	'on' or 'off'	'off'	Automatically log server messages
`log_auto_channel`	boolean	'on' or 'off'	'off'	Automatically log channel chats
`log_auto_private`	boolean	'on' or 'off'	'off'	Automatically log private chats
`log_plugin_msg`	boolean	'on' or 'off'	'off'	Log messages from plugins (scripts)
`log_path`	string	any string	'%h/logs/'	Path for WeeChat log files ('%h' will be replaced by WeeChat home, ~/.weechat by default)
`log_timestamp`	string	any string	'%Y %b %d %H:%M:%S'	Timestamp for log (see man strftime for date/time specifiers)
`log_hide_nickserv_pwd`	boolean	'on' or 'off'	'on'	Hide password displayed by nickserv
`irc_display_away`	string	'off', 'local', 'channel'	'off'	Display message when (un)marking as away
`irc_show_away_once`	boolean	'on' or 'off'	'on'	Show remote away message only once in private
`irc_default_msg_part`	string	any string	'WeeChat %v'	Default part message (leaving channel) ('%v' will be replaced by WeeChat version in string)
`irc_default_msg_quit`	string	any string	'WeeChat %v'	Default quit message ('%v' will be replaced by WeeChat version in string)
`irc_notice_as_pv`	boolean	'on' or 'off'	'off'	Display notices as private messages
`irc_away_check`	integer	between 0 and 2147483647	0	Interval between two checks for away (in minutes, 0 = never check)
`irc_away_check_max_nicks`	integer	between 0 and 2147483647	0	Do not check away nicks on channels with high number of nicks (0 = unlimited)
`irc_lag_check`	integer	between 30 and 2147483647	60	Interval between two checks for lag (in seconds)
`irc_lag_min_show`	integer	between 0 and 2147483647	1	Minimum lag to show (in seconds)
`irc_lag_disconnect`	integer	between 0 and 2147483647	5	Disconnect after important lag (in minutes, 0 = never disconnect)
`irc_anti_flood`	integer	between 0 and 5	2	Anti-flood: # seconds between two user messages (0 = no anti-flood)
`irc_fifo_pipe`	boolean	'on' or 'off'	'off'	Create a FIFO pipe for remote control
`irc_highlight`	string	any string	''	Comma separated list of words to highlight (case insensitive comparison, words may begin or end with "*" for partial match)
`irc_colors_receive`	boolean	'on' or 'off'	'on'	When off, colors codes are ignored in incoming messages
`irc_colors_send`	boolean	'on' or 'off'	'on'	Allow user to send colors with special codes (^Cb=bold, ^Ccxx=color, ^Ccxx,yy=color+background, ^Cu=underline, ^Cr=reverse)
`irc_send_unknown_commands`	boolean	'on' or 'off'	'off'	Send unknown commands to IRC server
`dcc_auto_accept_files`	boolean	'on' or 'off'	'off'	Automatically accept incoming dcc files
`dcc_auto_accept_chats`	boolean	'on' or 'off'	'off'	Automatically accept dcc chats (use carefully!)
`dcc_timeout`	integer	between 5 and 2147483647	300	Timeout for dcc request (in seconds)
`dcc_blocksize`	integer	between 1024 and 102400	65536	Block size for dcc packets in bytes (default: 65536)
`dcc_fast_send`	boolean	'on' or 'off'	'on'	Does not wait for ACK when sending file
`dcc_port_range`	string	any string	''	Restricts outgoing dcc to use only ports in the given range (useful for NAT) (syntax: a single port, ie. 5000 or a port range, ie. 5000-5015, empty value means any port)
`dcc_own_ip`	string	any string	''	IP or DNS address used for outgoing dcc (if empty, local interface IP is used)
`dcc_download_path`	string	any string	'%h/dcc'	Path for writing incoming files with dcc (default: user home)
`dcc_upload_path`	string	any string	'~'	Path for reading files when sending thru dcc (when no path is specified)
`dcc_convert_spaces`	boolean	'on' or 'off'	'on'	Convert spaces to underscores when sending files
`dcc_auto_rename`	boolean	'on' or 'off'	'on'	Rename incoming files if already exists (add '.1', '.2', ...)
`dcc_auto_resume`	boolean	'on' or 'off'	'on'	Automatically resume dcc transfer if connection with remote host is loosed
`proxy_use`	boolean	'on' or 'off'	'off'	Use a proxy server to connect to irc server
`proxy_type`	string	'http', 'socks4', 'socks5'	'http'	Proxy type (http (default), socks4, socks5)
`proxy_ipv6`	boolean	'on' or 'off'	'off'	Connect to proxy in ipv6
`proxy_address`	string	any string	''	Proxy server address (IP or hostname)
`proxy_port`	integer	between 0 and 65535	3128	Port for connecting to proxy server
`proxy_username`	string	any string	''	Username for proxy server
`proxy_password`	string	any string	''	Password for proxy server
`plugins_path`	string	any string	'%h/plugins'	Path for searching plugins ('%h' will be replaced by WeeChat home, ~/.weechat by default)
`plugins_autoload`	string	any string	'*'	Comma separated list of plugins to load automatically at startup, "*" means all plugins found (names may be partial, for example "perl" is ok for "libperl.so")
`plugins_extension`	string	any string	'.so'	Standard plugins extension in filename, used for autoload (if empty, then all files are loaded when autoload is "*")
`server_name`	string	any string	''	Name associated to IRC server (for display only)
`server_autoconnect`	boolean	'on' or 'off'	'on'	Automatically connect to server when WeeChat is starting
`server_autoreconnect`	boolean	'on' or 'off'	'on'	Automatically reconnect to server when disconnected
`server_autoreconnect_delay`	integer	between 0 and 65535	30	Delay (in seconds) before trying again to reconnect to server
`server_address`	string	any string	''	IP address or hostname of IRC server
`server_port`	integer	between 0 and 65535	6667	Port for connecting to server
`server_ipv6`	boolean	'on' or 'off'	'off'	Use IPv6 protocol for server communication
`server_ssl`	boolean	'on' or 'off'	'off'	Use SSL for server communication
`server_password`	string	any string	''	Password for IRC server
`server_nick1`	string	any string	''	Nickname to use on IRC server
`server_nick2`	string	any string	''	Alternate nickname to use on IRC server (if nickname is already used)
`server_nick3`	string	any string	''	2nd alternate nickname to use on IRC server (if alternate nickname is already used)
`server_username`	string	any string	''	User name to use on IRC server
`server_realname`	string	any string	''	Real name to use on IRC server
`server_hostname`	string	any string	''	Custom hostname/IP for server (optional, if empty local hostname is used)
`server_command`	string	any string	''	Command(s) to run when connected to server (many commands should be separated by ';', use '\;' for a semicolon, special variables $nick, $channel and $server are replaced by their value)
`server_command_delay`	integer	between 0 and 3600	0	Delay (in seconds) after command was executed (example: give some time for authentication)
`server_autojoin`	string	any string	''	Comma separated list of channels to join when connected to server (example: "#chan1,#chan2,#chan3 key1,key2")
`server_autorejoin`	boolean	'on' or 'off'	'on'	Automatically rejoin channels when kicked
`server_notify_levels`	string	any string	''	Comma separated list of notify levels for channels of this server (format: #channel:1,..), a channel name '*' is reserved for server default notify level

Keyword	Color
`default`	default color (transparent for background)
`black`	black
`red`	dark red
`lightred`	light red
`green`	dark green
`lightgreen`	light green
`brown`	brown
`yellow`	yellow
`blue`	dark blue
`lightblue`	light blue
`magenta`	dark magenta
`lightmagenta`	light magenta
`cyan`	dark cyan
`lightcyan`	light cyan
`white`	white

Variable	Description
`char plugin_name[]`	plugin name
`char plugin_version[]`	plugin version
`char plugin_description[]`	short description of plugin

Function	Description
`int weechat_plugin_init (t_weechat_plugin *plugin)`	function called when plugin is loaded, must return PLUGIN_RC_OK if successful, PLUGIN_RC_KO if error (if error, plugin will NOT be loaded)
`void weechat_plugin_end (t_weechat_plugin *plugin)`	function called when plugin is unloaded

Code	Description
0x02	bold text
0x03 + "xx"	text color "`xx`" (see the section called “get_irc_color” for colors)
0x03 + "xx,yy"	text color "`xx`" and background "`yy`" (see the section called “get_irc_color” for colors)
0x0F	disable color and attributes
0x12	reverse video (revert text color with background)
0x1F	underlined text

Name	Description
`weechat_pv`	private message received
`weechat_highlight`	message with highlight (on a channel or pv)
`weechat_ctcp`	CTCP message received (VERSION, PING, ..)
`weechat_dcc`	DCC message received (chat or file)

Code	Description
`%-`	no completion for argument
`%*`	repeat last completion for all following arguments (this code has to be at the end of completion template, preceded by "\|")
`%a`	alias
`%A`	alias and commands (WeeChat, IRC and plugins)
`%c`	current channel
`%C`	all channels (including queries)
`%f`	file name
`%h`	plugins commands
`%i`	IRC commands (sent)
`%I`	IRC commands (received)
`%k`	key functions
`%m`	nick on current server
`%M`	nicks on current server (on all open channels)
`%n`	nicks of current channel
`%N`	nicks and hostnames of current channel
`%o`	setup options
`%O`	plugin options
`%p`	default "part" message
`%q`	default "quit" message
`%s`	current server name
`%S`	all servers names
`%t`	topic of current channel
`%v`	setup option value
`%V`	plugin option value
`%w`	WeeChat commands

Event	Description	Arguments
`buffer_open`	a buffer was open	argc = 1, argv = { buffer number }
`buffer_close`	a buffer was closed	argc = 1, argv = { buffer number }
`buffer_move`	a buffer was moved	argc = 2, argv = { new buffer number, old number }

Type	Description
`irc_in`	called for incoming IRC messages
`irc_user`	called for each user message (or command) (before WeeChat parses message)
`irc_out`	called for outgoing messages, immediately before sending it to IRC server (this includes messages sent automatically by WeeChat to server)

Info	Description
`version`	WeeChat's version
`nick`	nick
`channel`	name of channel (NULL for a server or private)
`server`	name of server
`type`	buffer type: 0=standard, 1=DCC, 2=raw IRC data
`away`	"away" flag
`inactivity`	number of seconds since last key was pressed
`input`	content of command line for current window
`input_mask`	content of color mask for command line
`input_pos`	cursor position in command line
`weechat_dir`	WeeChat home directory (by default: ~/.weechat/)
`weechat_libdir`	WeeChat system lib directory
`weechat_sharedir`	WeeChat system share directory

Type	Field	Description
char *	`server`	IRC server
char *	`channel`	IRC channel
int	`type`	DCC type: 0 = chat received, 1 = chat sent, 2 = file received, 3 = file sent
int*	`status`	DCC status: 0 = waiting, 1 = connecting, 2 = active, 3 = finished, 4 = failed, 5 = interrupted by user
time_t	`start_time`	date/time of DCC creation
time_t	`start_transfer`	date/time of DCC transfer start
unsigned long	`addr`	IP address of remote user
int	`port`	port used for DCC
char *	`nick`	remote nick
char *	`filename`	file name
char *	`local_filename`	local file name
int	`filename_suffix`	suffix if renaming file
unsigned long	`size`	file size
unsigned long	`pos`	position in file
unsigned long	`start_resume`	start position after interruption
unsigned long	`bytes_per_sec`	number of bytes per second since transfer start
t_plugin_dcc_info *	`prev_dcc`	pointer to previous DCC info
t_plugin_dcc_info *	`next_dcc`	pointer to next DCC info

Type	Field	Description
char *	`name`	server internal name
int	`autoconnect`	1 if autoconnect at start-up, 0 otherwise
int	`autoreconnect`	1 if autoreconnect when disconnected, 0 otherwise
int	`autoreconnect_delay`	delay before trying again connection
int	`command_line`	1 if server was on command line (so it is temporary), 0 otherwise
char *	`address`	server address (host or IP)
int	`port`	port
int	`ipv6`	IPv6 connection
int	`ssl`	SSL connection
char *	`password`	server password
char *	`nick1`	first nickname
char *	`nick2`	alternate nickname
char *	`nick3`	second alternate nickname
char *	`username`	user name
char *	`real name`	real name
char *	`command`	command run once connected
int	`command_delay`	delay after execution of command
char *	`autojoin`	channels joined automatically
int	`autorejoin`	1 if channels are rejoined when kicked, 0 otherwise
char *	`notify_levels`	channels notify levels
char *	`charset_decode_iso`	channels charsets for decoding ISO
char *	`charset_decode_utf`	channels charsets for decoding UTF
char *	`charset_encode`	channels charsets for encoding messages
int	`is_connected`	1 if connected to server, 0 otherwise
int	`ssl_connected`	1 if connected with SSL, 0 otherwise
char *	`nick`	current nickname
int	`is_away`	1 if away, 0 otherwise
time_t	`away_time`	time when user is marking as away
int	`lag`	lag (in milliseconds)
t_plugin_server_info *	`prev_server`	pointer to previous server info
t_plugin_server_info *	`next_server`	pointer to next server info

Type	Field	Description
int	`type`	0 for a channel, 1 for a private
char *	`name`	name of channel
char *	`topic`	topic of channel
char *	`modes`	channel modes
int	`limit`	user limit
char *	`key`	channel key
int	`nicks_count`	number of nicks on channel
t_plugin_channel_info *	`prev_channel`	pointer to previous channel info
t_plugin_channel_info *	`next_channel`	pointer to next channel info

Type	Field	Description
char *	`nick`	nick name
char *	`host`	hostname
int	`flags`	nick flags, binary "or" between values (1 = channel owner, 2 = channel admin, 4 = op, 8 = halfop, 16 = voice, 32 = away)
t_plugin_nick_info *	`prev_nick`	pointer to previous nick info
t_plugin_nick_info *	`next_nick`	pointer to next nick info

Color name	Value
white	0
black	1
blue	2
green	3
lightred	4
red	5
magenta	6
brown	7
yellow	8
lightgreen	9
cyan	10
lightcyan	11
lightblue	12
lightmagenta	13
gray	14
lightgray	15

Type	Field	Description
int	`win_x`	horizontal position of window
int	`win_y`	vertical position of window
int	`win_width`	width of window
int	`win_height`	height of window
int	`win_width_pct`	width % (compared to parent window)
int	`win_height_pct`	height % (compared to parent window)
int	`num_buffer`	number of displayed buffer
t_plugin_window_info *	`prev_window`	pointer to previous window info
t_plugin_window_info *	`next_window`	pointer to next window info

Type	Field	Description
int	`type`	buffer type: 0=standard, 1=DCC, 2=raw IRC data
int	`number`	buffer number
int	`num_displayed`	number of windows displaying buffer
char *	`server_name`	server name for buffer (may be NULL)
char *	`channel_name`	channel name for buffer (may be NULL)
int	`notify_level`	notify level for buffer
char *	`log_filename`	log filename (NULL means not logging)
t_plugin_buffer_info *	`prev_buffer`	pointer to previous buffer info
t_plugin_buffer_info *	`next_buffer`	pointer to next buffer info

Type	Field	Description
time_t	`date`	date and time
char *	`nick`	nick
char *	`data`	line content (color codes are removed)
t_plugin_buffer_line *	`prev_line`	pointer to previous line
t_plugin_buffer_line *	`next_line`	pointer to next line

WeeChat 0.2.6 - User guide

Fast, light and extensible IRC client

Sébastien Helleu

Chapter 1. Introduction

Description

Pre-requisites

Chapter 2. Installation

Binary packages

Source package

CVS sources

Chapter 3. Usage

Running WeeChat

Key bindings

Command line

WeeChat / IRC commands

WeeChat commands

Key functions

IRC commands

Configuration file

FIFO pipe

Chapter 4. Plugins

Plugins in WeeChat

Write a plugin

API functions

set_charset

iconv_to_internal

iconv_from_internal

ascii_strcasecmp

ascii_strncasecmp

explode_string

free_exploded_string

mkdir_home

exec_on_files

print

print_server

print_infobar

infobar_remove

log

msg_handler_add

cmd_handler_add

timer_handler_add

keyboard_handler_add

event_handler_add

handler_remove

handler_remove_all

modifier_add

modifier_remove

modifier_remove_all

exec_command

get_info

get_dcc_info

free_dcc_info

get_server_info

free_server_info

get_channel_info

free_channel_info

get_nick_info

free_nick_info

get_config

set_config

get_plugin_config

set_plugin_config

get_irc_color

input_color

get_window_info

free_window_info

get_buffer_info

free_buffer_info

get_buffer_data

free_buffer_data

Compile plugin

Load plugin into WeeChat

Plugin example

Charset plugin

Settings

FAQ

Scripts plugins

Load / unload scripts

Syntax by language

Perl