window: inside windows, with optional conditions (see below)
cond1,...: condition(s) for displaying bar (only for type "window"):
active: on active window
inactive: on inactive windows
nicklist: on windows with nicklist
without condition, bar is always displayed
position: bottom, top, left or right
size: size of bar (in chars)
separator: 1 for using separator (line), 0 or nothing means no separator
item1,...: items for this bar (items can be separated by comma (space between items) or "+" (glued items))
default: create default bars
del: delete a bar (or all bars with -all)
set: set a value for a bar property
option: option to change (for options list, look at /set weechat.bar.<barname>.*)
value: new value for option
hide: hide a bar
show: show an hidden bar
toggle: hide/show a bar
scroll: scroll bar
buffer: name of buffer to scroll ('*' means current buffer, you should use '*' for root bars)
scroll_value: value for scroll: 'x' or 'y', followed by '+', '-', 'b' (beginning) or 'e' (end), value (for +/-), and optional %% (to scroll by %% of width/height, otherwise value is number of chars)
Examples:
create a bar with time, buffer number + name, and completion:
[command]*`history`* show buffer command history::
........................................
/history clear
<value>
clear: clear history
value: number of history entries to show
........................................
[command]*`input`* functions for command line::
........................................
/input <action> [<arguments>]
list of actions:
return: simulate key "enter"
complete_next: complete word with next completion
complete_previous: complete word with previous completion
search_text: search text in buffer
delete_previous_char: delete previous char
delete_next_char: delete next char
delete_previous_word: delete previous word
delete_next_word: delete next word
delete_beginning_of_line: delete from beginning of line until cursor
delete_end_of_line: delete from cursor until end of line
delete_line: delete entire line
clipboard_paste: paste from clipboard
transpose_chars: transpose two chars
undo: undo last command line action
redo: redo last command line action
move_beginning_of_line: move cursor to beginning of line
move_end_of_line: move cursor to end of line
move_previous_char: move cursor to previous char
move_next_char: move cursor to next char
move_previous_word: move cursor to previous word
move_next_word: move cursor to next word
history_previous: recall previous command in current buffer history
history_next: recall next command in current buffer history
history_global_previous: recall previous command in global history
history_global_next: recall next command in global history
jump_smart: jump to next buffer with activity
jump_last_buffer: jump to last buffer
jump_previously_visited_buffer: jump to previously visited buffer
jump_next_visited_buffer: jump to next visited buffer
hotlist_clear: clear hotlist
grab_key: grab a key
grab_key_command: grab a key with its associated command
scroll_unread: scroll to unread marker
set_unread: set unread marker for all buffers
set_unread_current_buffer: set unread marker for current buffer
switch_active_buffer: switch to next merged buffer
switch_active_buffer_previous: switch to previous merged buffer
insert: insert text in command line
This command is used by key bindings or plugins.
........................................
[command]*`key`* bind/unbind keys::
........................................
/key list|listdefault|listdiff
bind <key> [<command> [<args>]]
unbind <key>
reset <key>
resetall -yes
missing
list: list all current keys (without argument, this list is displayed)
listdefault: list default keys
listdiff: list differences between current and default keys (keys added, redefined or deleted)
bind: bind a command to a key or display command bound to key
unbind: remove a key binding
reset: reset a key to default binding
resetall: restore bindings to the default values and delete ALL personal bindings (use carefully!)
missing: add missing keys (using default bindings), useful after installing new WeeChat version
When binding a command to a key, it is recommended to use key alt+k (or Esc then k), and then press the key to bind: this will insert key code in command line.
Examples:
key alt-x to toggle nicklist bar:
/key bind meta-x /bar toggle nicklist
key alt-r to jump to #weechat IRC channel:
/key bind meta-r /buffer #weechat
restore default binding for key alt-r:
/key reset meta-r
........................................
[command]*`layout`* save/apply/reset layout for buffers and windows::
........................................
/layout save [buffers|windows]
apply [buffers|windows]
reset [buffers|windows]
save: save current layout
apply: apply saved layout
reset: remove saved layout
buffers: save/apply only buffers (order of buffers)
windows: save/apply only windows (buffer displayed by each window)
Without argument, this command displays saved layout.
........................................
[command]*`mute`* execute a command silently::
........................................
/mute [-current | -buffer <name> | -all] command
-current: no output on curent buffer
-buffer: no output on specified buffer
name: full buffer name (examples: "irc.server.freenode", "irc.freenode.#weechat")
-all: no output on ALL buffers
command: command to execute silently (a '/' is automatically added if not found at beginning of command)
If no target is specified (-current, -buffer or -all), then default is to mute WeeChat core buffer only.
Note: command is executed on buffer where /wait was executed (if buffer is not found (for example if it has been closed before execution of command), then command is executed on WeeChat core buffer).
For splith and splitv, pct is a percentage 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
