summaryrefslogtreecommitdiff
path: root/doc/it/includes/autogen_user_commands.it.adoc
diff options
context:
space:
mode:
Diffstat (limited to 'doc/it/includes/autogen_user_commands.it.adoc')
-rw-r--r--doc/it/includes/autogen_user_commands.it.adoc3308
1 files changed, 0 insertions, 3308 deletions
diff --git a/doc/it/includes/autogen_user_commands.it.adoc b/doc/it/includes/autogen_user_commands.it.adoc
deleted file mode 100644
index 47de910bd..000000000
--- a/doc/it/includes/autogen_user_commands.it.adoc
+++ /dev/null
@@ -1,3308 +0,0 @@
-//
-// This file is auto-generated by script docgen.py.
-// DO NOT EDIT BY HAND!
-//
-
-// tag::alias_commands[]
-[[command_alias_alias]]
-* `+alias+`: list, add or remove command aliases
-
-----
-/alias list [<alias>]
- add <alias> [<command>[;<command>...]]
- addcompletion <completion> <alias> [<command>[;<command>...]]
- del <alias> [<alias>...]
- rename <alias> <new_alias>
-
- list: list aliases (without argument, this list is displayed)
- add: add an alias
-addcompletion: add an alias with a custom completion
- del: delete an alias
- rename: rename an alias
- completion: completion for alias: by default completion is done with target command
- note: you can use %%command to use completion of an existing command
- alias: name of alias
- command: command name with arguments (many commands can be separated by semicolons)
-
-Note: in command, special variables are replaced:
- $n: argument 'n' (between 1 and 9)
- $-m: arguments from 1 to 'm'
- $n-: arguments from 'n' to last
- $n-m: arguments from 'n' to 'm'
- $*: all arguments
- $~: last argument
- $var: where "var" is a local variable of buffer (see /buffer listvar)
- examples: $nick, $channel, $server, $plugin, $name
-
-Examples:
- alias /split to split window horizontally:
- /alias add split /window splith
- alias /hello to say "hello" on all channels but not on #weechat:
- /alias add hello /allchan -exclude=#weechat hello
- rename alias "hello" to "Hello":
- /alias rename hello Hello
- alias /forcejoin to send IRC command "forcejoin" with completion of /sajoin:
- /alias addcompletion %%sajoin forcejoin /quote forcejoin
-----
-// end::alias_commands[]
-
-// tag::buflist_commands[]
-[[command_buflist_buflist]]
-* `+buflist+`: bar item with list of buffers
-
-----
-/buflist enable|disable|toggle
- bar
- refresh
-
- enable: enable buflist
-disable: disable buflist
- toggle: toggle buflist
- bar: add the "buflist" bar
-refresh: force the refresh of the bar items (buflist, buflist2 and buflist3)
-
-The lines with buffers are displayed using string evaluation (see /help eval for the format), with these options:
- - buflist.look.display_conditions: conditions to display a buffer in the list
- - buflist.format.buffer: format for a buffer which is not current buffer
- - buflist.format.buffer_current: format for the current buffer
-
-The following variables can be used in these options:
- - bar item data (see hdata "bar_item" in API doc for a complete list), for example:
- - ${bar_item.name}
- - window data, where the bar item is displayed (there's no window in root bars, see hdata "window" in API doc for a complete list), for example:
- - ${window.number}
- - ${window.buffer.full_name}
- - buffer data (see hdata "buffer" in API doc for a complete list), for example:
- - ${buffer.number}
- - ${buffer.name}
- - ${buffer.full_name}
- - ${buffer.short_name}
- - ${buffer.nicklist_nicks_count}
- - irc_server: IRC server data, defined only on an IRC buffer (see hdata "irc_server" in API doc)
- - irc_channel: IRC channel data, defined only on an IRC channel buffer (see hdata "irc_channel" in API doc)
- - extra variables added by buflist for convenience:
- - ${format_buffer}: the evaluated value of option buflist.format.buffer; this can be used in option buflist.format.buffer_current to just change the background color for example
- - ${current_buffer}: a boolean ("0" or "1"), "1" if this is the current buffer; it can be used in a condition: ${if:${current_buffer}?...:...}
- - ${merged}: a boolean ("0" or "1"), "1" if the buffer is merged with at least another buffer; it can be used in a condition: ${if:${merged}?...:...}
- - ${format_number}: indented number with separator (evaluation of option buflist.format.number)
- - ${number}: indented number, for example " 1" if there are between 10 and 99 buffers; for merged buffers, this variable is set with number for the first buffer and spaces for the next buffers with same number
- - ${number2}: indented number, for example " 1" if there are between 10 and 99 buffers
- - ${number_displayed}: "1" if the number is displayed, otherwise "0"
- - ${indent}: indentation for name (channel and private buffers are indented) (evaluation of option buflist.format.indent)
- - ${format_nick_prefix}: colored nick prefix for a channel (evaluation of option buflist.format.nick_prefix)
- - ${color_nick_prefix}: color of nick prefix for a channel (set only if the option buflist.look.nick_prefix is enabled)
- - ${nick_prefix}: nick prefix for a channel (set only if the option buflist.look.nick_prefix is enabled)
- - ${format_name}: formatted name (evaluation of option buflist.format.name)
- - ${name}: the short name (if set), with a fallback on the name
- - ${color_hotlist}: the color depending on the highest hotlist level for the buffer (evaluation of option buflist.format.hotlist_xxx where xxx is the level)
- - ${format_hotlist}: the formatted hotlist (evaluation of option buflist.format.hotlist)
- - ${hotlist}: the raw hotlist
- - ${hotlist_priority}: "none", "low", "message", "private" or "highlight"
- - ${hotlist_priority_number}: -1 = none, 0 = low, 1 = message, 2 = private, 3 = highlight
- - ${format_lag}: the lag for an IRC server buffer, empty if there's no lag (evaluation of option buflist.format.lag)
- - ${format_tls_version}: indicator of TLS version for a server buffer, empty for channels (evaluation of option buflist.format.tls_version)
-----
-// end::buflist_commands[]
-
-// tag::charset_commands[]
-[[command_charset_charset]]
-* `+charset+`: modifica il set di caratteri per il buffer corrente
-
-----
-/charset decode|encode <set_caratteri>
- reset
-
- decode: modifica il set di caratteri per la decodifica
- encode: modifica il set di caratteri per la codifica
-set_caratteri: nuovo set di caratteri per il buffer corrente
- reset: resetta il set di caratteri per il buffer corrente
-----
-// end::charset_commands[]
-
-// tag::exec_commands[]
-[[command_exec_exec]]
-* `+exec+`: execute external commands
-
-----
-/exec -list
- [-sh|-nosh] [-bg|-nobg] [-stdin|-nostdin] [-buffer <name>] [-l|-o|-oc|-n|-nf] [-oerr] [-cl|-nocl] [-sw|-nosw] [-ln|-noln] [-flush|-noflush] [-color ansi|auto|irc|weechat|strip] [-rc|-norc] [-timeout <timeout>] [-name <name>] [-pipe <command>] [-hsignal <name>] <command>
- -in <id> <text>
- -inclose <id> [<text>]
- -signal <id> <signal>
- -kill <id>
- -killall
- -set <id> <property> <value>
- -del <id>|-all [<id>...]
-
- -list: list commands
- -sh: use the shell to execute the command, many commands can be piped (WARNING: use this option ONLY if all arguments are safe, see option -nosh)
- -nosh: do not use the shell to execute the command (required if the command has some unsafe data, for example the content of a message from another user) (default)
- -bg: run process in background: do not display process output neither return code (not compatible with options -o/-oc/-n/-nf/-pipe/-hsignal)
- -nobg: catch process output and display return code (default)
- -stdin: create a pipe for sending data to the process (with /exec -in/-inclose)
--nostdin: do not create a pipe for stdin (default)
- -buffer: display/send output of command on this buffer (if the buffer is not found, a new buffer with name "exec.exec.xxx" is created)
- -l: display locally output of command on buffer (default)
- -o: send output of command to the buffer without executing commands (not compatible with options -bg/-pipe/-hsignal)
- -oc: send output of command to the buffer and execute commands (lines starting with "/" or another custom command char) (not compatible with options -bg/-pipe/-hsignal)
- -n: display output of command in a new buffer (not compatible with options -bg/-pipe/-hsignal)
- -nf: display output of command in a new buffer with free content (no word-wrap, no limit on number of lines) (not compatible with options -bg/-pipe/-hsignal)
- -oerr: also send stderr (error output) to the buffer (can be used only with options -o and -oc)
- -cl: clear the new buffer before displaying output
- -nocl: append to the new buffer without clear (default)
- -sw: switch to the output buffer (default)
- -nosw: don't switch to the output buffer
- -ln: display line numbers (default in new buffer only)
- -noln: don't display line numbers
- -flush: display output of command in real time (default)
--noflush: display output of command after its end
- -color: action on ANSI colors in output:
- ansi: keep ANSI codes as-is
- auto: convert ANSI colors to WeeChat/IRC (default)
- irc: convert ANSI colors to IRC colors
- weechat: convert ANSI colors to WeeChat colors
- strip: remove ANSI colors
- -rc: display return code (default)
- -norc: don't display return code
--timeout: set a timeout for the command (in seconds)
- -name: set a name for the command (to name it later with /exec)
- -pipe: send the output to a WeeChat/plugin command (line by line); if there are spaces in command/arguments, enclose them with double quotes; variable $line is replaced by the line (by default the line is added after the command, separated by a space) (not compatible with options -bg/-o/-oc/-n/-nf)
--hsignal: send the output as a hsignal (to be used for example in a trigger) (not compatible with options -bg/-o/-oc/-n/-nf)
- command: the command to execute; if beginning with "url:", the shell is disabled and the content of URL is downloaded and sent as output
- id: command identifier: either its number or name (if set with "-name xxx")
- -in: send text on standard input of process
--inclose: same as -in, but stdin is closed after (and text is optional: without text, the stdin is just closed)
- -signal: send a signal to the process; the signal can be an integer or one of these names: hup, int, quit, kill, term, usr1, usr2
- -kill: alias of "-signal <id> kill"
--killall: kill all running processes
- -set: set a hook property (see function hook_set in plugin API reference)
-property: hook property
- value: new value for hook property
- -del: delete a terminated command
- -all: delete all terminated commands
-
-Default options can be set in the option exec.command.default_options.
-
-Examples:
- /exec -n ls -l /tmp
- /exec -sh -n ps xu | grep weechat
- /exec -n -norc url:https://pastebin.com/raw.php?i=xxxxxxxx
- /exec -nf -noln links -dump https://weechat.org/files/doc/devel/weechat_user.en.html
- /exec -o uptime
- /exec -pipe "/print Machine uptime:" uptime
- /exec -n tail -f /var/log/messages
- /exec -kill 0
-----
-// end::exec_commands[]
-
-// tag::fifo_commands[]
-[[command_fifo_fifo]]
-* `+fifo+`: fifo plugin configuration
-
-----
-/fifo enable|disable|toggle
-
- enable: enable FIFO pipe
-disable: disable FIFO pipe
- toggle: toggle FIFO pipe
-
-FIFO pipe is used as remote control of WeeChat: you can send commands or text to the FIFO pipe from your shell.
-By default the FIFO pipe is called weechat_fifo_xxx (where xxx is the WeeChat process id) and located in the WeeChat runtime directory (see /debug dirs).
-
-The expected format is one of:
- plugin.buffer *text or command here
- *text or command here
-
-For example to change your libera nick:
- echo 'irc.server.libera */nick newnick' >/run/user/1000/weechat/weechat_fifo_12345
-
-Please read the user's guide for more info and examples.
-
-Examples:
- /fifo toggle
-----
-// end::fifo_commands[]
-
-// tag::fset_commands[]
-[[command_fset_fset]]
-* `+fset+`: fast set WeeChat and plugins options
-
-----
-/fset -bar
- -refresh
- -up|-down [<number>]
- -left|-right [<percent>]
- -go <line>|end
- -toggle
- -add [<value>]
- -reset
- -unset
- -set
- -setnew
- -append
- -mark
- -format
- -export [-help|-nohelp] <filename>
- <filter>
-
- -bar: add the help bar
- -refresh: refresh list of options, then whole screen (command: /window refresh)
- -up: move the selected line up by "number" lines
- -down: move the selected line down by "number" lines
- -left: scroll the fset buffer by "percent" of width on the left
- -right: scroll the fset buffer by "percent" of width on the right
- -go: select a line by number, first line number is 0 ("end" to select the last line)
- -toggle: toggle the boolean value
- -add: add "value" (which can be a negative number) for integers and colors, set/append to value for other types (set for a negative value, append for a positive value)
- -reset: reset the value of option
- -unset: unset the option
- -set: add the /set command in input to edit the value of option (move the cursor at the beginning of value)
- -setnew: add the /set command in input to edit a new value for the option
- -append: add the /set command to append something in the value of option (move the cursor at the end of value)
- -mark: toggle mark
- -format: switch to the next available format
- -export: export the options and values displayed in a file (each line has format: "/set name value" or "/unset name")
- -help: force writing of help on options in exported file (see /help fset.look.export_help_default)
- -nohelp: do not write help on options in exported file (see /help fset.look.export_help_default)
- filter: set a new filter to see only matching options (this filter can be used as input in fset buffer as well); allowed formats are:
- * show all options (no filter)
- xxx show only options with "xxx" in name
- f:xxx show only configuration file "xxx"
- t:xxx show only type "xxx" (bool/int/str/col)
- d show only changed options
- d:xxx show only changed options with "xxx" in name
- d=xxx show only changed options with "xxx" in value
- d==xxx show only changed options with exact value "xxx"
- h=xxx show only options with "xxx" in description (translated)
- he=xxx show only options with "xxx" in description (in English)
- =xxx show only options with "xxx" in value
- ==xxx show only options with exact value "xxx"
- c:xxx show only options matching the evaluated condition "xxx", using following variables: file, section, option, name, parent_name, type, type_en, type_short (bool/int/str/col), type_tiny (b/i/s/c), default_value, default_value_undef, value, quoted_value, value_undef, value_changed, parent_value, min, max, description, description2, description_en, description_en2, string_values
-
-The lines with options are displayed using string evaluation (see /help eval for the format), with these options:
- - fset.format.option1: first format for an option
- - fset.format.option2: second format for an option
-
-The following variables can be used in these options:
- - option data, with color and padded by spaces on the right:
- - ${file}: configuration file (for example "weechat" or "irc")
- - ${section}: section
- - ${option}: option name
- - ${name}: full option name (file.section.option)
- - ${parent_name}: parent option name
- - ${type}: option type (translated)
- - ${type_en}: option type (in English)
- - ${type_short}: short option type (bool/int/str/col)
- - ${type_tiny}: tiny option type (b/i/s/c)
- - ${default_value}: option default value
- - ${default_value_undef}: "1" if default value is null, otherwise "0"
- - ${value}: option value
- - ${value_undef}: "1" if value is null, otherwise "0"
- - ${value_changed}: "1" if value is different from default value, otherwise "0"
- - ${value2}: option value, with inherited value if null
- - ${parent_value}: parent option value
- - ${min}: min value
- - ${max}: max value
- - ${description}: option description (translated)
- - ${description2}: option description (translated), "(no description)" (translated) if there's no description
- - ${description_en}: option description (in English)
- - ${description_en2}: option description (in English), "(no description)" if there's no description
- - ${string_values}: string values allowed for set of an integer option using strings
- - ${marked}: "1" if option is marked, otherwise "0"
- - ${index}: index of option in list
- - option data, with color but no spaces:
- - same names prefixed by underscore, for example: ${_name}, ${_type}, ...
- - option data, raw format (no colors/spaces):
- - same names prefixed by two underscores, for example: ${__name}, ${__type}, ...
- - option data, only spaces:
- - same names prefixed with "empty_", for example: ${empty_name}, ${empty_type}
- - other data:
- - ${selected_line}: "1" if the line is selected, otherwise "0"
- - ${newline}: insert a new line at point, so the option is displayed on multiple lines
-
-Keys and input to move in on fset buffer:
- up move one line up
- down move one line down
- pgup move one page up
- pgdn move one page down
- alt-home << move to first line
- alt-end >> move to last line
- F11 < scroll horizontally on the left
- F12 > scroll horizontally on the right
-
-Keys and input to set options on fset buffer:
- alt+space t toggle boolean value
- alt+'-' - subtract 1 from value for integer/color, set value for other types
- alt+'+' + add 1 to value for integer/color, append to value for other types
- alt+f, alt+r r reset value
- alt+f, alt+u u unset value
- alt+enter s set value
- alt+f, alt+n n set new value
- alt+f, alt+a a append to value
- alt+',' , mark/unmark option
- shift+up move one line up and mark/unmark option
- shift+down mark/unmark option and move one line down
- m:xxx mark options displayed that are matching filter "xxx" (any filter on option or value is allowed, see filters above)
- u:xxx unmark options displayed that are matching filter "xxx" (any filter on option or value is allowed, see filters above)
-
-Other keys and input on fset buffer:
- ctrl+l refresh options and whole screen (command: /fset -refresh)
- $ refresh options (keep marked options)
- $$ refresh options (unmark all options)
- alt+p p toggle plugin description options (plugins.desc.*)
- alt+v v toggle help bar
- s:x,y sort options by fields x,y (see /help fset.look.sort)
- s: reset sort to its default value (see /help fset.look.sort)
- w:xxx export options in file "xxx"
- w-:xxx export options in file "xxx" without help
- w+:xxx export options in file "xxx" with help
- ctrl+x x switch the format used to display options
- q close fset buffer
-
-Mouse actions on fset buffer:
- wheel up/down move line up/down
- left button move line here
- right button toggle boolean (on/off) or edit the option value
- right button + drag left/right increase/decrease value for integer/color, set/append to value for other types
- right button + drag up/down mark/unmark multiple options
-
-Note: if input has one or more leading spaces, the following text is interpreted as a filter, without the spaces. For example " q" searches all options with "q" inside name while "q" closes the fset buffer.
-
-Examples:
- show IRC options changed:
- /fset d:irc.*
- show all options with "nicklist" in name:
- /fset nicklist
- show all values which contain "red":
- /fset =red
- show all values which are exactly "red":
- /fset ==red
- show all integer options in irc plugin:
- /fset c:${file} == irc && ${type_en} == integer
-----
-// end::fset_commands[]
-
-// tag::guile_commands[]
-[[command_guile_guile]]
-* `+guile+`: elenca/carica/scarica script
-
-----
-/guile list|listfull [<name>]
- load [-q] <filename>
- autoload
- reload|unload [-q] [<name>]
- eval [-o|-oc] <code>
- version
-
- list: list loaded scripts
-listfull: list loaded scripts (verbose)
- load: load a script
-autoload: load all scripts in "autoload" directory
- reload: reload a script (if no name given, unload all scripts, then load all scripts in "autoload" directory)
- unload: unload a script (if no name given, unload all scripts)
-filename: script (file) to load
- -q: quiet mode: do not display messages
- name: a script name (name used in call to "register" function)
- eval: evaluate source code and display result on current buffer
- -o: send evaluation result to the buffer without executing commands
- -oc: send evaluation result to the buffer and execute commands
- code: source code to evaluate
- version: display the version of interpreter used
-
-Without argument, this command lists all loaded scripts.
-----
-// end::guile_commands[]
-
-// tag::irc_commands[]
-[[command_irc_admin]]
-* `+admin+`: trova informazioni sull'amministratore del server
-
-----
-/admin [<destinazione>]
-
-destinazione: nome server
-----
-
-[[command_irc_allchan]]
-* `+allchan+`: esegue un comando su tutti i canali di tutti i server connessi
-
-----
-/allchan [-current] [-parted] [-exclude=<channel>[,<channel>...]] <command>
- [-current] [-parted] -include=<channel>[,<channel>...] <command>
-
- -current: execute command for channels of current server only
- -parted: execute on parted channels only
- -exclude: exclude some channels (wildcard "*" is allowed)
- -include: include only some channels (wildcard "*" is allowed)
- command: command to execute (or text to send to buffer if command does not start with '/')
-
-Command and arguments are evaluated (see /help eval), the following variables are replaced:
- $server server name
- $channel channel name
- $nick nick on server
- ${irc_server.xxx} variable xxx in server
- ${irc_channel.xxx} variable xxx in channel
-
-Examples:
- execute '/me is testing' on all channels:
- /allchan /me is testing
- say 'hello' everywhere but not on #weechat:
- /allchan -exclude=#weechat hello
- say 'hello' everywhere but not on #weechat and channels beginning with #linux:
- /allchan -exclude=#weechat,#linux* hello
- say 'hello' on all channels beginning with #linux:
- /allchan -include=#linux* hello
- close all buffers with parted channels:
- /allchan -parted /close
-----
-
-[[command_irc_allpv]]
-* `+allpv+`: execute a command on all private buffers of all connected servers
-
-----
-/allpv [-current] [-exclude=<nick>[,<nick>...]] <command>
- [-current] -include=<nick>[,<nick>...] <command>
-
- -current: execute command for private buffers of current server only
- -exclude: exclude some nicks (wildcard "*" is allowed)
- -include: include only some nicks (wildcard "*" is allowed)
- command: command to execute (or text to send to buffer if command does not start with '/')
-
-Command and arguments are evaluated (see /help eval), the following variables are replaced:
- $server server name
- $channel channel name
- $nick nick on server
- ${irc_server.xxx} variable xxx in server
- ${irc_channel.xxx} variable xxx in channel
-
-Examples:
- execute '/me is testing' on all private buffers:
- /allpv /me is testing
- say 'hello' everywhere but not for nick foo:
- /allpv -exclude=foo hello
- say 'hello' everywhere but not for nick foo and nicks beginning with bar:
- /allpv -exclude=foo,bar* hello
- say 'hello' for all nicks beginning with bar:
- /allpv -include=bar* hello
- close all private buffers:
- /allpv /close
-----
-
-[[command_irc_allserv]]
-* `+allserv+`: esegue un comando su tutti i server connessi
-
-----
-/allserv [-exclude=<server>[,<server>...]] <command>
- -include=<server>[,<server>...] <command>
-
- -exclude: exclude some servers (wildcard "*" is allowed)
- -include: include only some servers (wildcard "*" is allowed)
- command: command to execute (or text to send to buffer if command does not start with '/')
-
-Command and arguments are evaluated (see /help eval), the following variables are replaced:
- $server server name
- $nick nick on server
- ${irc_server.xxx} variable xxx in server
-
-Examples:
- change nick on all servers:
- /allserv /nick newnick
- set away on all servers:
- /allserv /away I'm away
- do a whois on my nick on all servers:
- /allserv /whois $nick
-----
-
-[[command_irc_auth]]
-* `+auth+`: authenticate with SASL
-
-----
-/auth [<username> <password>]
-
-username: SASL username (content is evaluated, see /help eval; server options are evaluated with ${irc_server.xxx} and ${server} is replaced by the server name)
-password: SASL password or path to file with private key (content is evaluated, see /help eval; server options are evaluated with ${irc_server.xxx} and ${server} is replaced by the server name)
-
-If username and password are not provided, the values from server options "sasl_username" and "sasl_password" (or "sasl_key") are used.
-
-Examples:
- authenticate with username/password defined in the server:
- /auth
- authenticate as a different user:
- /auth user2 password2
- authenticate as a different user with mechanism ecdsa-nist256p-challenge:
- /auth user2 ${weechat_config_dir}/ecdsa2.pem
-----
-
-[[command_irc_autojoin]]
-* `+autojoin+`: configure the "autojoin" server option
-
-----
-/autojoin add [<channel1> [<channel2>...]]
- addraw <channel1>[,<channel2>...] [<key1>[,<key2>...]]
- del [<channel1> [<channel2>...]]
- apply
- join
- sort
-
- add: add current channel or a list of channels (with optional keys) to the autojoin option; if you are on the channel and the key is not provided, the key is read in the channel
- addraw: use the IRC raw format (same as /join command): all channels separated by commas, optional keys separated by commas
- del: delete current channel or a list of channels from the autojoin option
-channel: channel name
- key: key for the channel
- apply: set currently joined channels in the autojoin option
- join: join the channels in the autojoin option
- sort: sort alphabetically channels in the autojoin option
-
-Examples:
- /autojoin add
- /autojoin add #test
- /autojoin add #chan1 #chan2
- /allchan /autojoin add
- /autojoin addraw #chan1,#chan2,#chan3 key1,key2
- /autojoin del
- /autojoin del #chan1
- /autojoin apply
- /autojoin join
- /autojoin sort
-----
-
-[[command_irc_ban]]
-* `+ban+`: banna nick oppure host
-
-----
-/ban [<canale>] [<nick> [<nick>...]]
-
-channel: channel name
- nick: nick or host
-
-Without argument, this command displays the ban list for current channel.
-----
-
-[[command_irc_cap]]
-* `+cap+`: client capability negotiation
-
-----
-/cap ls
- list
- req|ack [<capability> [<capability>...]]
- end
-
- ls: list the capabilities supported by the server
- list: list the capabilities currently enabled
- req: request a new capability or remove a capability (if starting with "-", for example: "-multi-prefix")
- ack: acknowledge capabilities which require client-side acknowledgement
- end: end the capability negotiation
-
-Without argument, "ls" and "list" are sent.
-
-Capabilities supported by WeeChat are: account-notify, away-notify, cap-notify, chghost, extended-join, invite-notify, message-tags, multi-prefix, server-time, setname, userhost-in-names.
-
-The capabilities to automatically enable on servers can be set in option irc.server_default.capabilities (or by server in option irc.server.xxx.capabilities).
-
-Examples:
- display supported and enabled capabilities:
- /cap
- request capabilities multi-prefix and away-notify:
- /cap req multi-prefix away-notify
- request capability extended-join, remove capability multi-prefix:
- /cap req extended-join -multi-prefix
- remove capability away-notify:
- /cap req -away-notify
-----
-
-[[command_irc_connect]]
-* `+connect+`: connette ad uno o più server IRC
-
-----
-/connect [<server> [<server>...]] [-<option>[=<value>]] [-no<option>] [-nojoin] [-switch]
- -all|-auto|-open [-nojoin] [-switch]
-
- server: server name, which can be:
- - internal server name (added by /server add, recommended usage)
- - hostname/port or IP/port, port is 6667 by default
- - URL with format: irc[6][s]://[nickname[:password]@]irc.example.org[:port][/#channel1][,#channel2[...]]
- Note: for an address/IP/URL, a temporary server is added (NOT SAVED), see /help irc.look.temporary_servers
- option: set option for server (for boolean option, value can be omitted)
- nooption: set boolean option to 'off' (for example: -nossl)
- -all: connect to all servers defined in configuration
- -auto: connect to servers with autoconnect enabled
- -open: connect to all opened servers that are not currently connected
- -nojoin: do not join any channel (even if autojoin is enabled on server)
- -switch: switch to next server address
-
-To disconnect from a server or stop any connection attempt, use command /disconnect.
-
-Examples:
- /connect libera
- /connect irc.oftc.net/6667
- /connect irc6.oftc.net/6667 -ipv6
- /connect irc6.oftc.net/6697 -ipv6 -ssl
- /connect my.server.org/6697 -ssl -password=test
- /connect irc://nick@irc.oftc.net/#channel
- /connect -switch
-----
-
-[[command_irc_ctcp]]
-* `+ctcp+`: invia un messaggio CTCP (Protocollo Client-A-Client)
-
-----
-/ctcp [-server <server>] <target>[,<target>...] <type> [<arguments>]
-
- server: send to this server (internal name)
- target: nick or channel ('*' = current channel)
- type: CTCP type (examples: "version", "ping", etc.)
-arguments: arguments for CTCP
-
-Examples:
- /ctcp toto time
- /ctcp toto version
- /ctcp * version
-----
-
-[[command_irc_cycle]]
-* `+cycle+`: esce e rienta in un canale
-
-----
-/cycle [<canale>[,<canale>...]] [<messaggio>]
-
-channel: channel name
-message: part message (displayed to other users)
-----
-
-[[command_irc_dcc]]
-* `+dcc+`: avvia una DCC (trasferimento file o chat diretta)
-
-----
-/dcc chat <nick>
- send <nick> <file>
-
-nick: nick
-file: filename (on local host)
-
-Examples:
- chat with nick "toto":
- /dcc chat toto
- send file "/home/foo/bar.txt" to nick "toto":
- /dcc send toto /home/foo/bar.txt
-----
-
-[[command_irc_dehalfop]]
-* `+dehalfop+`: revoca lo stato di half-op del canale da uno o più nick
-
-----
-/dehalfop <nick> [<nick>...]
- * -yes
-
-nick: nick or mask (wildcard "*" is allowed)
- *: remove channel half-operator status from everybody on channel except yourself
-----
-
-[[command_irc_deop]]
-* `+deop+`: revoca lo stato di operatore del canale da uno o più nick
-
-----
-/deop <nick> [<nick>...]
- * -yes
-
-nick: nick or mask (wildcard "*" is allowed)
- *: remove channel operator status from everybody on channel except yourself
-----
-
-[[command_irc_devoice]]
-* `+devoice+`: revoca il voice da uno o più nick
-
-----
-/devoice <nick> [<nick>...]
- * -yes
-
-nick: nick or mask (wildcard "*" is allowed)
- *: remove voice from everybody on channel
-----
-
-[[command_irc_die]]
-* `+die+`: arresta il server
-
-----
-/die [<destinazione>]
-
-destinazione: nome server
-----
-
-[[command_irc_disconnect]]
-* `+disconnect+`: disconnette da uno o tutti i server IRC
-
-----
-/disconnect [<server>|-all|-pending [<motivo>]]
-
- server: internal server name
- -all: disconnect from all servers
--pending: cancel auto-reconnection on servers currently reconnecting
- reason: reason for the "quit"
-----
-
-[[command_irc_halfop]]
-* `+halfop+`: concede lo stato di half-op del canale ad uno o più nick
-
-----
-/halfop <nick> [<nick>...]
- * -yes
-
-nick: nick or mask (wildcard "*" is allowed)
- *: give channel half-operator status to everybody on channel
-----
-
-[[command_irc_ignore]]
-* `+ignore+`: ignora nick/host dai server o dai canali
-
-----
-/ignore list
- add [re:]<nick> [<server> [<canale>]]
- del <numero>|-all
-
- list: list all ignores
- add: add an ignore
- nick: nick or hostname (can be a POSIX extended regular expression if "re:" is given or a mask using "*" to replace zero or more chars)
- del: delete an ignore
- number: number of ignore to delete (look at list to find it)
- -all: delete all ignores
- server: internal server name where ignore is working
- channel: channel name where ignore is working
-
-Note: the regular expression can start with "(?-i)" to become case sensitive.
-
-Examples:
- ignore nick "toto" everywhere:
- /ignore add toto
- ignore host "toto@domain.com" on libera server:
- /ignore add toto@domain.com libera
- ignore host "toto*@*.domain.com" on libera/#weechat:
- /ignore add toto*@*.domain.com libera #weechat
-----
-
-[[command_irc_info]]
-* `+info+`: ottieni informazioni sul server
-
-----
-/info [<destinazione>]
-
-destinazione: nome server
-----
-
-[[command_irc_invite]]
-* `+invite+`: invita un nick su un canale
-
-----
-/invite <nick> [<nick>...] [<canale>]
-
- nick: nick
-canale: nome del canale
-----
-
-[[command_irc_ison]]
-* `+ison+`: verifica se un nick è collegato IRC
-
-----
-/ison <nick> [<nick>...]
-
-nick: nick
-----
-
-[[command_irc_join]]
-* `+join+`: entra in un canale
-
-----
-/join [-noswitch] [-server <server>] [<canale1>[,<canale2>...]] [<chiave1>[,<chiave2>...]]
-
--noswitch: do not switch to new buffer
- server: send to this server (internal name)
- channel: channel name to join
- key: key to join the channel (channels with a key must be the first in list)
-
-Examples:
- /join #weechat
- /join #protectedchan,#weechat key
- /join -server libera #weechat
- /join -noswitch #weechat
-----
-
-[[command_irc_kick]]
-* `+kick+`: kick a user out of a channel
-
-----
-/kick [<canale>] <nick> [<motivo>]
-
-channel: channel name
- nick: nick
- reason: reason (evaluated, see /help eval; special variables ${nick} (self nick), ${target} (target nick), ${channel} and ${server} are replaced by their values)
-----
-
-[[command_irc_kickban]]
-* `+kickban+`: kick a user out of a channel and ban the host
-
-----
-/kickban [<canale>] <nick> [<motivo>]
-
-channel: channel name
- nick: nick
- reason: reason (evaluated, see /help eval; special variables ${nick} (self nick), ${target} (target nick), ${channel} and ${server} are replaced by their values)
-
-It is possible to kick/ban with a mask, nick will be extracted from mask and replaced by "*".
-
-Example:
- ban "*!*@host.com" and then kick "toto":
- /kickban toto!*@host.com
-----
-
-[[command_irc_kill]]
-* `+kill+`: chiude connessione client-server
-
-----
-/kill <nick> [<reason>]
-
- nick: nick
-motivo: motivo
-----
-
-[[command_irc_knock]]
-* `+knock+`: send a notice to an invitation-only channel, requesting an invite
-
-----
-/knock <channel> [<message>]
-
-channel: channel name
-message: message to send
-----
-
-[[command_irc_links]]
-* `+links+`: list all server names which are known by the server answering the query
-
-----
-/links [[<target>] <server_mask>]
-
- target: this remote server should answer the query
-server_mask: list of servers must match this mask
-----
-
-[[command_irc_list]]
-* `+list+`: list channels and their topics
-
-----
-/list [-server <server>] [-re <regex>] [<channel>[,<channel>...]] [<target>]
-
- server: send to this server (internal name)
- regex: POSIX extended regular expression used to filter results (case insensitive, can start by "(?-i)" to become case sensitive)
-channel: channel to list
- target: server name
-
-Examples:
- list all channels on server (can be very slow on large networks):
- /list
- list channel #weechat:
- /list #weechat
- list all channels beginning with "#weechat" (can be very slow on large networks):
- /list -re #weechat.*
-----
-
-[[command_irc_lusers]]
-* `+lusers+`: ottiene statistiche sulla dimensione del network IRC
-
-----
-/lusers [<mask> [<destinazione>]]
-
- mask: server corrispondenti alla mask
-destinazione: server per redirigere la richiesta
-----
-
-[[command_irc_map]]
-* `+map+`: mostra una mappa grafica della rete IRC
-
-----
-----
-
-[[command_irc_me]]
-* `+me+`: invia un'azione CTCP al canale corrente
-
-----
-/me <messaggio>
-
-messaggio: messaggio da inviare
-----
-
-[[command_irc_mode]]
-* `+mode+`: cambia modalità canale o utente
-
-----
-/mode [<canale>] [+|-]o|p|s|i|t|n|m|l|b|e|v|k [<arguments>]
- <nick> [+|-]i|s|w|o
-
-modalità canale:
- canale: nome canale da modificare (quello attivo è il predefinito)
- o: concede/revoca i privilegi di operatore del canale
- p: flag: canale privato
- s: flag: canale segreto
- i: flag: canale a solo invito
- t: flag: argomento modificabile solo dall'operatore del canale
- n: nessun messaggio al canale da client esterni
- m: canale moderato
- l: imposta il limite massimo di utenti sul canale
- b: imposta un mask ban per tenere alla larga agli utenti
- e: imposta mask di eccezione
- v: concede/nega la possibilità di parlare su un canale moderato
- k: imposta una chiave per il canale (password)
-modalità utente:
- nick: nick da modificare
- i: marca un utente come invisibile
- s: marca un utente per la ricezione dei messaggi dal server
- w: l'utente riceve wallops
- o: flag: operatore
-
-L'elenco delle modalità non è completa, è necessario leggere la documentazione del server per tutte le modalità disponibili.
-
-Esempi:
- protegge l'argomento sul canale #weechat:
- /mode #weechat +t
- diventa invisibile sul server:
- /mode nick +i
-----
-
-[[command_irc_motd]]
-* `+motd+`: riceve il "Messaggio Del Giorno"
-
-----
-/motd [<destinazione>]
-
-destinazione: nome server
-----
-
-[[command_irc_msg]]
-* `+msg+`: invia un messaggio ad un nick o a un canale
-
-----
-/msg [-server <server>] <destinazione>[,<destinazione>...] <testo>
-
- server: invia a questo server (nome interno)
-destinazione: nick o canale (può essere una mask, '*' = canale corrente)
- testo: testo da inviare
-----
-
-[[command_irc_names]]
-* `+names+`: elenca i nick sul canale
-
-----
-/names [<canale>[,<canale>...]]
-
-canale: nome canale
-----
-
-[[command_irc_nick]]
-* `+nick+`: cambia il nick corrente
-
-----
-/nick [-all] <nick>
-
--all: imposta nuovo nick per tutti i server connessi
-nick: nuovo nick
-----
-
-[[command_irc_notice]]
-* `+notice+`: invia messaggio di notifica all'utente
-
-----
-/notice [-server <server>] <destinazione> <testo>
-
-server: send to this server (internal name)
-target: nick or channel name
- text: text to send
-----
-
-[[command_irc_notify]]
-* `+notify+`: aggiunge una notifica per lo stato di presenza o assenza dei nick sui server
-
-----
-/notify add <nick> [<server> [-away]]
- del <nick>|-all [<server>]
-
- add: add a notification
- nick: nick
-server: internal server name (by default current server)
- -away: notify when away message is changed (by doing whois on nick)
- del: delete a notification
- -all: delete all notifications
-
-Without argument, this command displays notifications for current server (or all servers if command is issued on core buffer).
-
-Examples:
- notify when "toto" joins/quits current server:
- /notify add toto
- notify when "toto" joins/quits libera server:
- /notify add toto libera
- notify when "toto" is away or back on libera server:
- /notify add toto libera -away
-----
-
-[[command_irc_op]]
-* `+op+`: concede lo stato di operatore del canale ad uno o più nick
-
-----
-/op <nick> [<nick>...]
- * -yes
-
-nick: nick or mask (wildcard "*" is allowed)
- *: give channel operator status to everybody on channel
-----
-
-[[command_irc_oper]]
-* `+oper+`: ottiene i privilegi di operatore
-
-----
-/oper <utente> <password>
-
- user: utente
-password: password
-----
-
-[[command_irc_part]]
-* `+part+`: esce da un canale
-
-----
-/part [<canale>[,<canale>...]] [<messaggio>]
-
- canale: nome del canale da lasciare
-messaggio: messaggio di uscita (mostrato agli altri utenti)
-----
-
-[[command_irc_ping]]
-* `+ping+`: invia un ping al server
-
-----
-/ping <target1> [<target2>]
-
-target1: server
-target2: forward ping to this server
-----
-
-[[command_irc_pong]]
-* `+pong+`: risponde ad un messaggio ping
-
-----
-/pong <demone> [<demone2>]
-
- demone: demone che ha risposto al messaggio di Ping
-demone2: reindirizza messaggio a questo demone
-----
-
-[[command_irc_query]]
-* `+query+`: invia un messaggio privato ad un nick
-
-----
-/query [-noswitch] [-server <server>] <nick>[,<nick>...] [<text>]
-
--noswitch: do not switch to new buffer
- server: send to this server (internal name)
- nick: nick
- text: text to send
-----
-
-[[command_irc_quiet]]
-* `+quiet+`: fa tacere nick o host
-
-----
-/quiet [<canale>] [<nick> [<nick>...]]
-
-channel: channel name
- nick: nick or host
-
-Without argument, this command displays the quiet list for current channel.
-----
-
-[[command_irc_quote]]
-* `+quote+`: invia dati grezzi al server senza analisi
-
-----
-/quote [-server <server>] <dati>
-
-server: invia a questo server (nome interno)
- dati: dati raw da inviare
-----
-
-[[command_irc_reconnect]]
-* `+reconnect+`: riconnette a uno o più server
-
-----
-/reconnect <server> [<server>...] [-nojoin] [-switch]
- -all [-nojoin] [-switch]
-
- server: server to reconnect (internal name)
- -all: reconnect to all servers
--nojoin: do not join any channel (even if autojoin is enabled on server)
--switch: switch to next server address
-----
-
-[[command_irc_rehash]]
-* `+rehash+`: chiede al server di ricaricare il proprio file di configurazione
-
-----
-/rehash [<opzione>]
-
-opzione: opzione extra, per alcuni server
-----
-
-[[command_irc_remove]]
-* `+remove+`: force a user to leave a channel
-
-----
-/remove [<canale>] <nick> [<motivo>]
-
-channel: channel name
- nick: nick
- reason: reason (special variables $nick, $channel and $server are replaced by their values)
-----
-
-[[command_irc_restart]]
-* `+restart+`: chiede al server di riavviarsi
-
-----
-/restart [<destinazione>]
-
-destinazione: nome server
-----
-
-[[command_irc_rules]]
-* `+rules+`: request the server rules
-
-----
-----
-
-[[command_irc_sajoin]]
-* `+sajoin+`: forza un utente ad entrare su uno o più canali
-
-----
-/sajoin <nick> <canale>[,<canale>...]
-
- nick: nick
-canale: nome del canale
-----
-
-[[command_irc_samode]]
-* `+samode+`: cambia modalità sul canale, senza avere lo status di operatore
-
-----
-/samode [<channel>] <mode>
-
- canale: nome del canale
-modalità: modalità per il canale
-----
-
-[[command_irc_sanick]]
-* `+sanick+`: forza un utente ad usare un altro nick
-
-----
-/sanick <nick> <nuovo_nick>
-
- nick: nick
-nuovo_nick: nuovo nick
-----
-
-[[command_irc_sapart]]
-* `+sapart+`: forza un utente a lasciare uno o più canali
-
-----
-/sapart <nick> <canale>[,<canale>...]
-
- nick: nick
-canale: nome del canale
-----
-
-[[command_irc_saquit]]
-* `+saquit+`: forza un utente ad abbandonare il server con un motivo
-
-----
-/saquit <nick> <motivo>
-
- nick: nick
-motivo: motivo
-----
-
-[[command_irc_server]]
-* `+server+`: elenca, aggiunge o rimuove server IRC
-
-----
-/server list|listfull [<name>]
- add <name> <hostname>[/<port>] [-temp] [-<option>[=<value>]] [-no<option>]
- copy|rename <name> <new_name>
- reorder <name> [<name>...]
- open <name>|-all [<name>...]
- del|keep <name>
- deloutq|jump
- raw [<filter>]
-
- list: list servers (without argument, this list is displayed)
-listfull: list servers with detailed info for each server
- add: add a new server
- name: server name, for internal and display use; this name is used to connect to the server (/connect name) and to set server options: irc.server.name.xxx
-hostname: name or IP address of server, with optional port (default: 6667), many addresses can be separated by a comma
- -temp: add a temporary server (not saved)
- option: set option for server (for boolean option, value can be omitted)
-nooption: set boolean option to 'off' (for example: -nossl)
- copy: duplicate a server
- rename: rename a server
- reorder: reorder list of servers
- open: open the server buffer without connecting
- 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)
- jump: jump to server buffer
- raw: open buffer with raw IRC data
- filter: set a new filter to see only matching messages (this filter can be used as input in raw IRC data buffer as well); allowed formats are:
- * show all messages (no filter)
- xxx show only messages containing "xxx"
- s:xxx show only messages for server "xxx"
- f:xxx show only messages with a flag: recv (message received), sent (message sent), modified (message modified by a modifier), redirected (message redirected)
- m:xxx show only IRC command "xxx"
- c:xxx show only messages matching the evaluated condition "xxx", using following variables: output of function irc_message_parse (like nick, command, channel, text, etc., see function info_get_hashtable in plugin API reference for the list of all variables), date (format: "yyyy-mm-dd hh:mm:ss"), server, recv, sent, modified, redirected
-
-Examples:
- /server listfull
- /server add libera irc.libera.chat
- /server add libera irc.libera.chat/6697 -ssl -autoconnect
- /server add chatspike irc.chatspike.net/6667,irc.duckspike.net/6667
- /server copy libera libera-test
- /server rename libera-test libera2
- /server reorder libera2 libera
- /server del libera
- /server deloutq
- /server raw
- /server raw s:libera
- /server raw c:${recv} && ${command}==PRIVMSG && ${nick}==foo
-----
-
-[[command_irc_service]]
-* `+service+`: registra un nuovo servizio
-
-----
-/service <nick> <riservato> <distribuzione> <tipo> <riservato> <info>
-
-distrubuzione: visibilità del servizio
- tipo: riservato per un uso futuro
-----
-
-[[command_irc_servlist]]
-* `+servlist+`: elenca servizi attualmente connessi al network
-
-----
-/servlist [<mask> [<tipo>]]
-
-mask: elenca solo i servizi che corrispondono a questa mask
-tipo: elenca solo i servizi di questo tipo
-----
-
-[[command_irc_setname]]
-* `+setname+`: set real name
-
-----
-/setname <realname>
-
-realname: new real name
-----
-
-[[command_irc_squery]]
-* `+squery+`: invia un messaggio ad un servizio
-
-----
-/squery <servizio> <testo>
-
-servizio: nome del servizio
- testo: testo da inviare
-----
-
-[[command_irc_squit]]
-* `+squit+`: disconnette collegamenti al server
-
-----
-/squit <target> <comment>
-
- target: server name
-comment: comment
-----
-
-[[command_irc_stats]]
-* `+stats+`: richiede statistiche sul server
-
-----
-/stats [<query> [<target>]]
-
- query: c/h/i/k/l/m/o/y/u (see RFC1459)
-target: server name
-----
-
-[[command_irc_summon]]
-* `+summon+`: invia agli utenti connessi ad un host con un server IRC in esecuzione un messaggio per invitarli ad entrare su IRC
-
-----
-/summon <utente> [<destinazione> [<canale>]]
-
- utente: nome utente
-destinazione: nome server
- canale: nome canale
-----
-
-[[command_irc_time]]
-* `+time+`: richiede l'ora locale dal server
-
-----
-/time [<destinazione>]
-
-destinazione: richiede l'ora dal server specificato
-----
-
-[[command_irc_topic]]
-* `+topic+`: legge/modifica argomento del canale
-
-----
-/topic <[canale>] [<argomento>|delete]
-
-channel: channel name
- topic: new topic
--delete: delete channel topic
-----
-
-[[command_irc_trace]]
-* `+trace+`: trova il path del server specifico
-
-----
-/trace [<destinazione>]
-
-destinazione: nome server
-----
-
-[[command_irc_unban]]
-* `+unban+`: rimuove il ban da nick o host
-
-----
-/unban [<channel>] <nick>|<number> [<nick>|<number>...]
-
-channel: channel name
- nick: nick or host
- number: ban number (as displayed by command /ban)
-----
-
-[[command_irc_unquiet]]
-* `+unquiet+`: unquiet nicks or hosts
-
-----
-/unquiet [<channel>] <nick>|<number> [<nick>|<number>...]
-
-channel: channel name
- nick: nick or host
- number: quiet number (as displayed by command /quiet)
-----
-
-[[command_irc_userhost]]
-* `+userhost+`: restituisce un elenco di informazioni sui nick
-
-----
-/userhost <nick> [<nick>...]
-
-nick: nick
-----
-
-[[command_irc_users]]
-* `+users+`: lista di utenti autenticati sul server
-
-----
-/users [<destinazione>]
-
-destinazione: nome server
-----
-
-[[command_irc_version]]
-* `+version+`: riceve informazioni di versione del nick o del server (corrente o specificato)
-
-----
-/version [<target>|<nick>]
-
-target: server name
- nick: nick
-----
-
-[[command_irc_voice]]
-* `+voice+`: concede il voice ad uno o più utenti
-
-----
-/voice <nick> [<nick>...]
- * -yes
-
-nick: nick or mask (wildcard "*" is allowed)
- *: give voice to everybody on channel
-----
-
-[[command_irc_wallchops]]
-* `+wallchops+`: invia una notifica agli operatori del canale
-
-----
-/wallchops [<canale>] <testo>
-
-canale: nome del canale
- testo: testo da inviare
-----
-
-[[command_irc_wallops]]
-* `+wallops+`: invia un messaggio a tutti gli utenti attualmente connessi che hanno impostato la modalità 'w'
-
-----
-/wallops <testo>
-
-testo: testo da inviare
-----
-
-[[command_irc_who]]
-* `+who+`: genera una richiesta per ottenere una lista di informazioni
-
-----
-/who [<mask> [o]]
-
-mask: solo l'informazione corrispondente al mask
- o: vengono restituiti solo gli operatori in base alla mask fornita
-----
-
-[[command_irc_whois]]
-* `+whois+`: richiedi informazioni su uno o più utenti
-
-----
-/whois [<target>] [<nick>[,<nick>...]]
-
-target: server name
- nick: nick (may be a mask)
-
-Without argument, this command will do a whois on:
-- your own nick if buffer is a server/channel
-- remote nick if buffer is a private.
-
-If option irc.network.whois_double_nick is enabled, two nicks are sent (if only one nick is given), to get idle time in answer.
-----
-
-[[command_irc_whowas]]
-* `+whowas+`: richiede informazioni su un nick non più esistente
-
-----
-/whowas <nick>[,<nick>...] [<count> [<destinazione>]]
-
- nick: nick
- count: number of replies to return (full search if negative number)
-target: reply should match this mask
-----
-// end::irc_commands[]
-
-// tag::javascript_commands[]
-[[command_javascript_javascript]]
-* `+javascript+`: elenca/carica/scarica script
-
-----
-/javascript list|listfull [<name>]
- load [-q] <filename>
- autoload
- reload|unload [-q] [<name>]
- eval [-o|-oc] <code>
- version
-
- list: list loaded scripts
-listfull: list loaded scripts (verbose)
- load: load a script
-autoload: load all scripts in "autoload" directory
- reload: reload a script (if no name given, unload all scripts, then load all scripts in "autoload" directory)
- unload: unload a script (if no name given, unload all scripts)
-filename: script (file) to load
- -q: quiet mode: do not display messages
- name: a script name (name used in call to "register" function)
- eval: evaluate source code and display result on current buffer
- -o: send evaluation result to the buffer without executing commands
- -oc: send evaluation result to the buffer and execute commands
- code: source code to evaluate
- version: display the version of interpreter used
-
-Without argument, this command lists all loaded scripts.
-----
-// end::javascript_commands[]
-
-// tag::logger_commands[]
-[[command_logger_logger]]
-* `+logger+`: configurazione del plugin logger
-
-----
-/logger list
- set <livello>
- flush
- disable
-
- list: show logging status for opened buffers
- set: set logging level on current buffer
- level: level for messages to be logged (0 = logging disabled, 1 = a few messages (most important) .. 9 = all messages)
- flush: write all log files now
-disable: disable logging on current buffer (set level to 0)
-
-Options "logger.level.*" and "logger.mask.*" can be used to set level or mask for a buffer, or buffers beginning with name.
-
-Log levels used by IRC plugin:
- 1: user message (channel and private), notice (server and channel)
- 2: nick change
- 3: server message
- 4: join/part/quit
- 9: all other messages
-
-Examples:
- set level to 5 for current buffer:
- /logger set 5
- disable logging for current buffer:
- /logger disable
- set level to 3 for all IRC buffers:
- /set logger.level.irc 3
- disable logging for main WeeChat buffer:
- /set logger.level.core.weechat 0
- use a directory per IRC server and a file per channel inside:
- /set logger.mask.irc "$server/$channel.weechatlog"
-----
-// end::logger_commands[]
-
-// tag::lua_commands[]
-[[command_lua_lua]]
-* `+lua+`: elenca/carica/scarica script
-
-----
-/lua list|listfull [<name>]
- load [-q] <filename>
- autoload
- reload|unload [-q] [<name>]
- eval [-o|-oc] <code>
- version
-
- list: list loaded scripts
-listfull: list loaded scripts (verbose)
- load: load a script
-autoload: load all scripts in "autoload" directory
- reload: reload a script (if no name given, unload all scripts, then load all scripts in "autoload" directory)
- unload: unload a script (if no name given, unload all scripts)
-filename: script (file) to load
- -q: quiet mode: do not display messages
- name: a script name (name used in call to "register" function)
- eval: evaluate source code and display result on current buffer
- -o: send evaluation result to the buffer without executing commands
- -oc: send evaluation result to the buffer and execute commands
- code: source code to evaluate
- version: display the version of interpreter used
-
-Without argument, this command lists all loaded scripts.
-----
-// end::lua_commands[]
-
-// tag::perl_commands[]
-[[command_perl_perl]]
-* `+perl+`: elenca/carica/scarica script
-
-----
-/perl list|listfull [<name>]
- load [-q] <filename>
- autoload
- reload|unload [-q] [<name>]
- eval [-o|-oc] <code>
- version
-
- list: list loaded scripts
-listfull: list loaded scripts (verbose)
- load: load a script
-autoload: load all scripts in "autoload" directory
- reload: reload a script (if no name given, unload all scripts, then load all scripts in "autoload" directory)
- unload: unload a script (if no name given, unload all scripts)
-filename: script (file) to load
- -q: quiet mode: do not display messages
- name: a script name (name used in call to "register" function)
- eval: evaluate source code and display result on current buffer
- -o: send evaluation result to the buffer without executing commands
- -oc: send evaluation result to the buffer and execute commands
- code: source code to evaluate
- version: display the version of interpreter used
-
-Without argument, this command lists all loaded scripts.
-----
-// end::perl_commands[]
-
-// tag::php_commands[]
-[[command_php_php]]
-* `+php+`: elenca/carica/scarica script
-
-----
-/php list|listfull [<name>]
- load [-q] <filename>
- autoload
- reload|unload [-q] [<name>]
- eval [-o|-oc] <code>
- version
-
- list: list loaded scripts
-listfull: list loaded scripts (verbose)
- load: load a script
-autoload: load all scripts in "autoload" directory
- reload: reload a script (if no name given, unload all scripts, then load all scripts in "autoload" directory)
- unload: unload a script (if no name given, unload all scripts)
-filename: script (file) to load
- -q: quiet mode: do not display messages
- name: a script name (name used in call to "register" function)
- eval: evaluate source code and display result on current buffer
- -o: send evaluation result to the buffer without executing commands
- -oc: send evaluation result to the buffer and execute commands
- code: source code to evaluate
- version: display the version of interpreter used
-
-Without argument, this command lists all loaded scripts.
-----
-// end::php_commands[]
-
-// tag::python_commands[]
-[[command_python_python]]
-* `+python+`: elenca/carica/scarica script
-
-----
-/python list|listfull [<name>]
- load [-q] <filename>
- autoload
- reload|unload [-q] [<name>]
- eval [-o|-oc] <code>
- version
-
- list: list loaded scripts
-listfull: list loaded scripts (verbose)
- load: load a script
-autoload: load all scripts in "autoload" directory
- reload: reload a script (if no name given, unload all scripts, then load all scripts in "autoload" directory)
- unload: unload a script (if no name given, unload all scripts)
-filename: script (file) to load
- -q: quiet mode: do not display messages
- name: a script name (name used in call to "register" function)
- eval: evaluate source code and display result on current buffer
- -o: send evaluation result to the buffer without executing commands
- -oc: send evaluation result to the buffer and execute commands
- code: source code to evaluate
- version: display the version of interpreter used
-
-Without argument, this command lists all loaded scripts.
-----
-// end::python_commands[]
-
-// tag::relay_commands[]
-[[command_relay_relay]]
-* `+relay+`: controllo relay
-
-----
-/relay list|listfull|listrelay
- add <name> <port>|<path>
- del|start|restart|stop <name>
- raw
- sslcertkey
-
- list: list relay clients (only active relays)
- listfull: list relay clients (verbose, all relays)
- listrelay: list relays (name and port)
- add: add a relay (listen on a port/path)
- del: remove a relay (clients remain connected)
- start: listen on port
- restart: close the server socket and listen again on port (clients remain connected)
- stop: close the server socket (clients remain connected)
- name: relay name (see format below)
- port: port used for relay
- path: path used for relay (for UNIX domain socket only); path is evaluated (see function string_eval_path_home in plugin API reference)
- raw: open buffer with raw Relay data
- sslcertkey: set SSL certificate/key using path in option relay.network.ssl_cert_key
-
-Relay name is: [ipv4.][ipv6.][ssl.]<protocol.name> or unix.[ssl.]<protocol.name>
- ipv4: force use of IPv4
- ipv6: force use of IPv6
- ssl: enable SSL
- unix: use UNIX domain socket
-protocol.name: protocol and name to relay:
- - protocol "irc": name is the server to share (optional, if not given, the server name must be sent by client in command "PASS", with format: "PASS server:password")
- - protocol "weechat" (name is not used)
-
-The "irc" protocol allows any IRC client (including WeeChat itself) to connect on the port.
-The "weechat" protocol allows a remote interface to connect on the port, see the list here: https://weechat.org/about/interfaces/
-
-Without argument, this command opens buffer with list of relay clients.
-
-Examples:
- irc proxy, for server "libera":
- /relay add irc.libera 8000
- irc proxy, for server "libera", with SSL:
- /relay add ssl.irc.libera 8001
- irc proxy, for all servers (client will choose), with SSL:
- /relay add ssl.irc 8002
- weechat protocol:
- /relay add weechat 9000
- weechat protocol with SSL:
- /relay add ssl.weechat 9001
- weechat protocol with SSL, using only IPv4:
- /relay add ipv4.ssl.weechat 9001
- weechat protocol with SSL, using only IPv6:
- /relay add ipv6.ssl.weechat 9001
- weechat protocol with SSL, using IPv4 + IPv6:
- /relay add ipv4.ipv6.ssl.weechat 9001
- weechat protocol over UNIX domain socket:
- /relay add unix.weechat ${weechat_runtime_dir}/relay_socket
-----
-// end::relay_commands[]
-
-// tag::ruby_commands[]
-[[command_ruby_ruby]]
-* `+ruby+`: elenca/carica/scarica script
-
-----
-/ruby list|listfull [<name>]
- load [-q] <filename>
- autoload
- reload|unload [-q] [<name>]
- eval [-o|-oc] <code>
- version
-
- list: list loaded scripts
-listfull: list loaded scripts (verbose)
- load: load a script
-autoload: load all scripts in "autoload" directory
- reload: reload a script (if no name given, unload all scripts, then load all scripts in "autoload" directory)
- unload: unload a script (if no name given, unload all scripts)
-filename: script (file) to load
- -q: quiet mode: do not display messages
- name: a script name (name used in call to "register" function)
- eval: evaluate source code and display result on current buffer
- -o: send evaluation result to the buffer without executing commands
- -oc: send evaluation result to the buffer and execute commands
- code: source code to evaluate
- version: display the version of interpreter used
-
-Without argument, this command lists all loaded scripts.
-----
-// end::ruby_commands[]
-
-// tag::script_commands[]
-[[command_script_script]]
-* `+script+`: WeeChat script manager
-
-----
-/script list [-o|-ol|-i|-il]
- search <text>
- show <script>
- load|unload|reload <script> [<script>...]
- autoload|noautoload|toggleautoload <script> [<script>...]
- install|remove|installremove|hold [-q] <script> [<script>...]
- upgrade
- update
-
- list: list loaded scripts (all languages)
- -o: send list of loaded scripts to buffer (string in English)
- -ol: send list of loaded scripts to buffer (translated string)
- -i: copy list of loaded scripts in command line (for sending to buffer) (string in English)
- -il: copy list of loaded scripts in command line (for sending to buffer) (translated string)
- search: search scripts by tags, language (python, perl, ...), filename extension (py, pl, ...) or text; result is displayed on scripts buffer
- show: show detailed info about a script
- load: load script(s)
- unload: unload script(s)
- reload: reload script(s)
- autoload: autoload the script
- noautoload: do not autoload the script
-toggleautoload: toggle autoload
- install: install/upgrade script(s)
- remove: remove script(s)
- installremove: install or remove script(s), depending on current state
- hold: hold/unhold script(s) (a script held will not be upgraded any more and cannot be removed)
- -q: quiet mode: do not display messages
- upgrade: upgrade all installed scripts which are obsolete (new version available)
- update: update local scripts cache
-
-Without argument, this command opens a buffer with list of scripts.
-
-On script buffer, the possible status for each script are:
- * i a H r N
- | | | | | |
- | | | | | obsolete (new version available)
- | | | | running (loaded)
- | | | held
- | | autoloaded
- | installed
- popular script
-
-In output of /script list, the possible status for each script are:
- * ? i a H N
- | | | | | |
- | | | | | obsolete (new version available)
- | | | | held
- | | | autoloaded
- | | installed
- | unknown script (can not be downloaded/updated)
- popular script
-
-Keys on script buffer:
- alt+i install script
- alt+r remove script
- alt+l load script
- alt+L reload script
- alt+u unload script
- alt+A autoload script
- alt+h (un)hold script
- alt+v view script
-
-Input allowed on script buffer:
- i/r/l/L/u/A/h/v action on script (same as keys above)
- q close buffer
- $ refresh buffer
- s:x,y sort buffer using keys x and y (see /help script.look.sort)
- s: reset sort (use default sort)
- word(s) filter scripts: search word(s) in scripts (description, tags, ...)
- * remove filter
-
-Mouse actions on script buffer:
- wheel scroll list
- left button select script
- right button install/remove script
-
-Examples:
- /script search url
- /script install go.py urlserver.py
- /script remove go.py
- /script hold urlserver.py
- /script reload urlserver
- /script upgrade
-----
-// end::script_commands[]
-
-// tag::spell_commands[]
-[[command_spell_spell]]
-* `+spell+`: spell plugin configuration
-
-----
-/spell enable|disable|toggle
- listdict
- setdict -|<dict>[,<dict>...]
- deldict
- addword [<dict>] <word>
-
- enable: enable spell checker
- disable: disable spell checker
- toggle: toggle spell checker
-listdict: show installed dictionaries
- setdict: set dictionary for current buffer (multiple dictionaries can be separated by a comma, the special value "-" disables spell checking on current buffer)
- deldict: delete dictionary used on current buffer
- addword: add a word in personal dictionary
-
-Input line beginning with a '/' is not checked, except for some commands (see /set spell.check.commands).
-
-To enable spell checker on all buffers, use option "default_dict", then enable spell checker, for example:
- /set spell.check.default_dict "en"
- /spell enable
-
-To display a list of suggestions in a bar, use item "spell_suggest".
-
-Default key to toggle spell checker is alt-s.
-----
-// end::spell_commands[]
-
-// tag::tcl_commands[]
-[[command_tcl_tcl]]
-* `+tcl+`: elenca/carica/scarica script
-
-----
-/tcl list|listfull [<name>]
- load [-q] <filename>
- autoload
- reload|unload [-q] [<name>]
- eval [-o|-oc] <code>
- version
-
- list: list loaded scripts
-listfull: list loaded scripts (verbose)
- load: load a script
-autoload: load all scripts in "autoload" directory
- reload: reload a script (if no name given, unload all scripts, then load all scripts in "autoload" directory)
- unload: unload a script (if no name given, unload all scripts)
-filename: script (file) to load
- -q: quiet mode: do not display messages
- name: a script name (name used in call to "register" function)
- eval: evaluate source code and display result on current buffer
- -o: send evaluation result to the buffer without executing commands
- -oc: send evaluation result to the buffer and execute commands
- code: source code to evaluate
- version: display the version of interpreter used
-
-Without argument, this command lists all loaded scripts.
-----
-// end::tcl_commands[]
-
-// tag::trigger_commands[]
-[[command_trigger_trigger]]
-* `+trigger+`: manage triggers, the Swiss Army knife for WeeChat
-
-----
-/trigger list|listfull|listdefault
- add|addoff|addreplace <name> <hook> ["<arguments>" ["<conditions>" ["<regex>" ["<command>" ["<return_code>" ["<post_action>"]]]]]]
- addinput [<hook>]
- input|output|recreate <name>
- set <name> <option> <value>
- rename|copy <name> <new_name>
- enable|disable|toggle [<name>|-all [<name>...]]
- restart <name>|-all [<name>...]
- show <name>
- del <name>|-all [<name>...]
- restore <name> [<name>...]
- default -yes
- monitor [<filter>]
-
- list: list triggers (without argument, this list is displayed)
- listfull: list triggers with detailed info for each trigger
-listdefault: list default triggers
- add: add a trigger
- addoff: add a trigger (disabled)
- addreplace: add or replace an existing trigger
- name: name of trigger
- hook: signal, hsignal, modifier, line, print, command, command_run, timer, config, focus, info, info_hashtable
- arguments: arguments for the hook, depending on hook (separated by semicolons):
- signal: name(s) of signal (required)
- hsignal: name(s) of hsignal (required)
- modifier: name(s) of modifier (required)
- line: buffer type ("formatted", "free" or "*"), list of buffer masks, tags
- print: buffer, tags, message, strip colors
- command: command (required), description, arguments, description of arguments, completion (all arguments except command are evaluated, "${tg_trigger_name}" is replaced by the trigger name, see /help eval)
- command_run: command(s) (required)
- timer: interval (required), align on second, max calls
- config: name(s) of option (required)
- focus: name(s) of area (required)
- info: name(s) of info (required)
- info_hashtable: name(s) of info (required)
- conditions: evaluated conditions for the trigger
- regex: one or more regular expressions to replace strings in variables
- command: command to execute (many commands can be separated by ";")
-return_code: return code in callback (ok (default), ok_eat, error)
-post_action: action to take after execution (none (default), disable, delete)
- addinput: set input with default arguments to create a trigger
- input: set input with the command used to create the trigger
- output: send the command to create the trigger on the buffer
- recreate: same as "input", with option "addreplace" instead of "add"
- set: set an option in a trigger
- option: name of option: name, hook, arguments, conditions, regex, command, return_code
- (for help on option, you can type: /help trigger.trigger.<name>.<option>)
- value: new value for the option
- rename: rename a trigger
- copy: copy a trigger
- enable: enable trigger(s) (without arguments: enable triggers globally)
- disable: disable trigger(s) (without arguments: disable triggers globally)
- toggle: toggle trigger(s) (without arguments: toggle triggers globally)
- restart: restart trigger(s) (recreate the hooks)
- show: show detailed info on a trigger (with some stats)
- del: delete a trigger
- -all: do action on all triggers
- restore: restore trigger(s) with the default values (works only for default triggers)
- default: delete all triggers and restore default ones
- monitor: open the trigger monitor buffer, with optional filter:
- filter: filter hooks/triggers to display (a hook must start with "@", for example "@signal"), many filters can be separated by commas; wildcard "*" is allowed in each trigger name
-
-When a trigger callback is called, following actions are performed, in this order:
- 1. check conditions; if false, exit
- 2. replace text using POSIX extended regular expression(s) (if defined in trigger)
- 3. execute command(s) (if defined in trigger)
- 4. exit with a return code (except for modifier, line, focus, info and info_hashtable)
- 5. perform post action
-
-Examples (you can also look at default triggers with /trigger listdefault):
- add text attributes *bold*, _underline_ and /italic/ (only in user messages):
- /trigger add effects modifier weechat_print "${tg_tag_nick}" "==\*([^ ]+)\*==*${color:bold}${re:1}${color:-bold}*== ==_([^ ]+)_==_${color:underline}${re:1}${color:-underline}_== ==/([^ ]+)/==/${color:italic}${re:1}${color:-italic}/"
- hide nicklist bar on small terminals:
- /trigger add resize_small signal signal_sigwinch "${info:term_width} < 100" "" "/bar hide nicklist"
- /trigger add resize_big signal signal_sigwinch "${info:term_width} >= 100" "" "/bar show nicklist"
- silently save config each hour:
- /trigger add cfgsave timer 3600000;0;0 "" "" "/mute /save"
- silently save WeeChat session at midnight (see /help upgrade):
- /trigger add session_save signal day_changed "" "" "/mute /upgrade -save"
- open trigger monitor and show only modifiers and triggers whose name starts with "resize":
- /trigger monitor @modifier,resize*
-----
-// end::trigger_commands[]
-
-// tag::weechat_commands[]
-[[command_weechat_allbuf]]
-* `+allbuf+`: execute a command on all buffers
-
-----
-/allbuf <command>
-
-command: command to execute (or text to send to buffer if command does not start with '/')
-
-Examples:
- set unread marker on all buffers:
- /allbuf /buffer set unread
-----
-
-[[command_weechat_away]]
-* `+away+`: imposta o elimina lo stato di assenza
-
-----
-/away [-all] [<messaggio>]
-
- -all: imposta o elimina lo stato di assenza su tutti i server connessi
-messaggio: messaggio di assenza (se non specificato, lo stato di assenza viene rimosso)
-----
-
-[[command_weechat_bar]]
-* `+bar+`: gestione delle barre
-
-----
-/bar list|listfull|listitems
- add <name> <type>[,<conditions>] <position> <size> <separator> <item1>[,<item2>...]
- default [input|title|status|nicklist]
- rename <name> <new_name>
- del <name>|-all
- set <name> <option> <value>
- hide|show|toggle <name>
- scroll <name> <window> <scroll_value>
-
- list: list all bars
- listfull: list all bars (verbose)
- listitems: list all bar items
- add: add a new bar
- name: name of bar (must be unique)
- type: root: outside windows,
- window: inside windows, with optional conditions (see below)
- conditions: the conditions to display the bar:
- active: on active window
- inactive: on inactive windows
- nicklist: on windows with nicklist
- other condition: see /help weechat.bar.xxx.conditions and /help eval
- without conditions, the 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 a default bar (all default bars if no bar name is given)
- rename: rename a bar
- 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
- window: window number (use '*' for current window or for root bars)
- scroll_value: value for scroll: 'x' or 'y' (optional), 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:
- /bar add mybar root bottom 1 0 [time],buffer_number+:+buffer_name,completion
- hide a bar:
- /bar hide mybar
- scroll nicklist 10 lines down on current buffer:
- /bar scroll nicklist * y+10
- scroll to end of nicklist on current buffer:
- /bar scroll nicklist * ye
-----
-
-[[command_weechat_buffer]]
-* `+buffer+`: gestione dei buffer
-
-----
-/buffer list
- add [-free] [-switch] <name>
- clear [<number>|<name>|-merged|-all [<number>|<name>...]]
- move <number>|-|+
- swap <number1>|<name1> [<number2>|<name2>]
- cycle <number>|<name> [<number>|<name>...]
- merge <number>|<name>
- unmerge [<number>|-all]
- hide [<number>|<name>|-all [<number>|<name>...]]
- unhide [<number>|<name>|-all [<number>|<name>...]]
- switch [-previous]
- zoom
- renumber [<number1> [<number2> [<start>]]]
- close [<n1>[-<n2>]|<name>...]
- notify [<level>]
- listvar [<number>|<name>]
- setvar <name> [<value>]
- delvar <name>
- set <property> [<value>]
- get <property>
- jump smart|last_displayed|prev_visited|next_visited
- <number>|-|+|<name>
-
- list: list buffers (without argument, this list is displayed)
- add: add a new buffer (it can be closed with "/buffer close" or input "q")
- clear: clear buffer content (number for a buffer, -merged for merged buffers, -all for all buffers, or nothing for current buffer)
- move: move buffer in the list (may be relative, for example -1); "-" = move to first buffer number, "+" = move to last buffer number + 1
- swap: swap two buffers (swap with current buffer if only one number/name given)
- cycle: jump loop between a list of buffers
- merge: merge current buffer to another buffer (chat area will be mix of both buffers)
- (by default ctrl-x switches between merged buffers)
- unmerge: unmerge buffer from other buffers which have same number
- hide: hide the buffer
- unhide: unhide the buffer
- switch: switch to next merged buffer (or to previous buffer with "-previous")
- zoom: zoom on merged buffer
-renumber: renumber buffers (works only if option weechat.look.buffer_auto_renumber is off)
- close: close buffer (number/range or name is optional)
- notify: display or set notify level for current buffer: this level determines whether buffer will be added to hotlist or not:
- none: never
- highlight: for highlights only
- message: for messages from users + highlights
- all: all messages
- reset: reset to default value (all)
- listvar: display local variables in a buffer
- setvar: set a local variable in the current buffer
- delvar: delete a local variable from the current buffer
- set: set a property in the current buffer
- get: display a property of current buffer
- jump: jump to another buffer:
- smart: next buffer with activity
- last_displayed: last buffer displayed (before last jump to a buffer)
- prev_visited: previously visited buffer
- next_visited: jump to next visited buffer
- number: jump to buffer by number, possible prefix:
- '+': relative jump, add number to current
- '-': relative jump, sub number to current
- '*': jump to number, using option "weechat.look.jump_current_to_previous_buffer"
- -: jump to first buffer number
- +: jump to last buffer number
- name: jump to buffer by (partial) name
-
-Examples:
- clear current buffer:
- /buffer clear
- move buffer to number 5:
- /buffer move 5
- swap buffer 1 with 3:
- /buffer swap 1 3
- swap buffer #weechat with current buffer:
- /buffer swap #weechat
- jump on #chan1, #chan2, #chan3 and loop:
- /buffer cycle #chan1 #chan2 #chan3
- merge with core buffer:
- /buffer merge 1
- merge with #weechat buffer:
- /buffer merge #weechat
- unmerge buffer:
- /buffer unmerge
- close current buffer:
- /buffer close
- close buffers 5 to 7:
- /buffer close 5-7
- jump to #weechat:
- /buffer #weechat
- jump to next buffer:
- /buffer +1
- jump to last buffer number:
- /buffer +
-----
-
-[[command_weechat_color]]
-* `+color+`: definisce gli alias dei colori e visualizza la tavolozza dei colori
-
-----
-/color alias <color> <name>
- unalias <color>
- reset
- term2rgb <color>
- rgb2term <rgb> [<limit>]
- -o
-
- alias: add an alias for a color
- unalias: delete an alias
- color: color number (greater than or equal to 0, max depends on terminal, commonly 63 or 255)
- name: alias name for color (for example: "orange")
- reset: reset all color pairs (required when no more color pairs are available if automatic reset is disabled, see option "weechat.look.color_pairs_auto_reset")
-term2rgb: convert a terminal color (0-255) to RGB color
-rgb2term: convert a RGB color to terminal color (0-255)
- limit: number of colors to use in terminal table (starting from 0); default is 256
- -o: send terminal/colors info to current buffer as input
-
-Without argument, this command displays colors in a new buffer.
-
-Examples:
- add alias "orange" for color 214:
- /color alias 214 orange
- delete color 214:
- /color unalias 214
-----
-
-[[command_weechat_command]]
-* `+command+`: esegui comando o plugin di WeeChat esplicito
-
-----
-/command [-buffer <name>] <plugin> <command>
-
--buffer: execute the command on this buffer
- plugin: execute the command from this plugin; 'core' for a WeeChat command, '*' for automatic plugin (it depends on the buffer where the command is executed)
-command: command to execute (a '/' is automatically added if not found at beginning of command)
-----
-
-[[command_weechat_cursor]]
-* `+cursor+`: movimento libero del cursore sullo schermo per eseguire azioni su aree specifiche dello schermo
-
-----
-/cursor go chat|<barra>|<x>,<y>
- move up|down|left|right|area_up|area_down|area_left|area_right
- stop
-
- go: move cursor to chat area, a bar (using bar name) or coordinates "x,y"
-move: move cursor with direction
-stop: stop cursor mode
-
-Without argument, this command toggles cursor mode.
-
-When mouse is enabled (see /help mouse), by default a middle click will start cursor mode at this point.
-
-Default keys in cursor mode on chat messages:
- m quote message
- q quote prefix + message
- Q quote time + prefix + message
-
-Default keys in cursor mode on nicklist:
- b ban nick (/ban)
- k kick nick (/kick)
- K kick and ban nick (/kickban)
- q open query with nick (/query)
- w query information about user (/whois)
-
-Other default keys in cursor mode:
- arrow move cursor
- alt+arrow move cursor to the next area
- enter exit cursor mode
-
-Examples:
- go to nicklist:
- /cursor go nicklist
- go to coordinates x=10, y=5:
- /cursor go 10,5
-----
-
-[[command_weechat_debug]]
-* `+debug+`: debug functions
-
-----
-/debug list
- set <plugin> <level>
- dump|hooks [<plugin>]
- buffer|certs|color|dirs|infolists|libs|memory|tags|term|windows
- mouse|cursor [verbose]
- hdata [free]
- time <command>
- unicode <string>
-
- list: list plugins with debug levels
- set: set debug level for plugin
- plugin: name of plugin ("core" for WeeChat core)
- level: debug level for plugin (0 = disable debug)
- dump: save memory dump in WeeChat log file (same dump is written when WeeChat crashes)
- hooks: display infos about hooks (with a plugin: display detailed info about hooks created by the plugin)
- buffer: dump buffer content with hexadecimal values in log file
- certs: display number of loaded trusted certificate authorities
- color: display infos about current color pairs
- cursor: toggle debug for cursor mode
- dirs: display directories
- hdata: display infos about hdata (with free: remove all hdata in memory)
-infolists: display infos about infolists
- key: enable keyboard and mouse debug: display raw codes, expanded key name and associated command ('q' to quit this mode)
- libs: display infos about external libraries used
- memory: display infos about memory usage
- mouse: toggle debug for mouse
- tags: display tags for lines
- term: display infos about terminal
- windows: display windows tree
- time: measure time to execute a command or to send text to the current buffer
- unicode: display information about string and unicode chars (evaluated, see /help eval)
-
-Examples:
- /debug set irc 1
- /debug mouse verbose
- /debug time /filter toggle
- /debug unicode ${chars:${\u26C0}-${\u26CF}}
-----
-
-[[command_weechat_eval]]
-* `+eval+`: evaluate expression
-
-----
-/eval [-n|-s] [-d] <expression>
- [-n] [-d [-d]] -c <expression1> <operator> <expression2>
-
- -n: display result without sending it to buffer (debug mode)
- -s: split expression before evaluating it (many commands can be separated by semicolons)
- -d: display debug output after evaluation (with two -d: more verbose debug)
- -c: evaluate as condition: use operators and parentheses, return a boolean value ("0" or "1")
-expression: expression to evaluate, variables with format ${variable} are replaced (see below); many commands can be separated by semicolons
- operator: a logical or comparison operator:
- - logical operators:
- && boolean "and"
- || boolean "or"
- - comparison operators:
- == equal
- != not equal
- <= less or equal
- < less
- >= greater or equal
- > greater
- =~ is matching POSIX extended regex
- !~ is NOT matching POSIX extended regex
- ==* is matching mask, case sensitive (wildcard "*" is allowed)
- !!* is NOT matching mask, case sensitive (wildcard "*" is allowed)
- =* is matching mask, case insensitive (wildcard "*" is allowed)
- !* is NOT matching mask, case insensitive (wildcard "*" is allowed)
- ==- is included, case sensitive
- !!- is NOT included, case sensitive
- =- is included, case insensitive
- !- is NOT included, case insensitive
-
-An expression is considered as "true" if it is not NULL, not empty, and different from "0".
-The comparison is made using floating point numbers if the two expressions are valid numbers, with one of the following formats:
- - integer (examples: 5, -7)
- - floating point number (examples: 5.2, -7.5, 2.83e-2)
- - hexadecimal number (examples: 0xA3, -0xA3)
-To force a string comparison, you can add double quotes around each expression, for example:
- 50 > 100 ==> 0
- "50" > "100" ==> 1
-
-Some variables are replaced in expression, using the format ${variable}, variable can be, by order of priority:
- - the string itself without evaluation (format: "raw:xxx")
- - a user-defined variable (format: "name")
- - an evaluated sub-string (format: "eval:xxx")
- - an evaluated condition (format: "eval_cond:xxx")
- - a string with escaped chars (format: "esc:xxx" or "\xxx")
- - a string with a range of chars (format: "chars:xxx" or "chars:c1-c2" where "xxx" is one of: "digit", "xdigit", "lower", "upper", "alpha", "alnum")
- - a string converted to lower case (format: "lower:xxx")
- - a string converted to upper case (format: "upper:xxx")
- - a string with chars to hide (format: "hide:char,string")
- - a string with max chars (format: "cut:max,suffix,string" or "cut:+max,suffix,string")
- or max chars displayed on screen (format: "cutscr:max,suffix,string" or "cutscr:+max,suffix,string")
- - a reversed string (format: "rev:xxx" or "revscr:xxx")
- - a repeated string (format: "repeat:count,string")
- - length of a string (format: "length:xxx" or "lengthscr:xxx")
- - split of a string (format: "split:number,separators,flags,xxx")
- - split of shell argmuents (format: "split_shell:number,xxx")
- - a color (format: "color:xxx", see "Plugin API reference", function "color")
- - a modifier (format: "modifier:name,data,string")
- - an info (format: "info:name,arguments", arguments are optional)
- - a base 16/32/64 encoded/decoded string (format: "base_encode:base,xxx" or "base_decode:base,xxx")
- - current date/time (format: "date" or "date:format")
- - an environment variable (format: "env:XXX")
- - a ternary operator (format: "if:condition?value_if_true:value_if_false")
- - result of an expression with parentheses and operators + - * / // % ** (format: "calc:xxx")
- - a random integer number (format: "random:min,max")
- - a translated string (format: "translate:xxx")
- - define a user variable (format: "define:name,value")
- - an option (format: "file.section.option")
- - a local variable in buffer
- - a hdata name/variable (the value is automatically converted to string), by default "window" and "buffer" point to current window/buffer.
-Format for hdata can be one of following:
- hdata.var1.var2...: start with a hdata (pointer must be known), and ask variables one after one (other hdata can be followed)
- hdata[list].var1.var2...: start with a hdata using a list/pointer/pointer name, for example:
- ${buffer[gui_buffers].full_name}: full name of first buffer in linked list of buffers
- ${plugin[weechat_plugins].name}: name of first plugin in linked list of plugins
- hdata[pointer].var1.var2...: start with a hdata using a pointer, for example:
- ${buffer[0x1234abcd].full_name}: full name of the buffer with this pointer (can be used in triggers)
- ${buffer[my_pointer].full_name}: full name of the buffer with this pointer name (can be used in triggers)
- hdata[pointer].var1.method(): when var1 is a hashtable, methods "keys()", "values()", "keys_sorted()", "keys_values()" and "keys_values_sorted()" can be called
-For name of hdata and variables, please look at "Plugin API reference", function "weechat_hdata_get".
-
-Examples (simple strings):
- /eval -n ${raw:${info:version}} ==> ${info:version}
- /eval -n ${eval_cond:${window.win_width}>100} ==> 1
- /eval -n ${info:version} ==> 0.4.3
- /eval -n ${env:HOME} ==> /home/user
- /eval -n ${weechat.look.scroll_amount} ==> 3
- /eval -n ${sec.data.password} ==> secret
- /eval -n ${window} ==> 0x2549aa0
- /eval -n ${window.buffer} ==> 0x2549320
- /eval -n ${window.buffer.full_name} ==> core.weechat
- /eval -n ${window.buffer.number} ==> 1
- /eval -n ${buffer.local_variables.keys_values()} ==> plugin:core,name:weechat
- /eval -n ${buffer.local_variables.plugin} ==> core
- /eval -n ${\t} ==> <tab>
- /eval -n ${chars:digit} ==> 0123456789
- /eval -n ${chars:J-T} ==> JKLMNOPQRST
- /eval -n ${lower:TEST} ==> test
- /eval -n ${upper:test} ==> TEST
- /eval -n ${hide:-,${relay.network.password}} ==> --------
- /eval -n ${cut:3,+,test} ==> tes+
- /eval -n ${cut:+3,+,test} ==> te+
- /eval -n ${date:%H:%M:%S} ==> 07:46:40
- /eval -n ${if:${info:term_width}>80?big:small} ==> big
- /eval -n ${rev:Hello} ==> olleH
- /eval -n ${repeat:5,-} ==> -----
- /eval -n ${length:test} ==> 4
- /eval -n ${split:1,,,abc,def,ghi} ==> abc
- /eval -n ${split:-1,,,abc,def,ghi} ==> ghi
- /eval -n ${split:count,,,abc,def,ghi} ==> 3
- /eval -n ${split:random,,,abc,def,ghi} ==> def
- /eval -n ${split_shell:1,"arg 1" arg2} ==> arg 1
- /eval -n ${split_shell:-1,"arg 1" arg2} ==> arg2
- /eval -n ${split_shell:count,"arg 1" arg2} ==> 2
- /eval -n ${split_shell:random,"arg 1" arg2} ==> arg2
- /eval -n ${calc:(5+2)*3} ==> 21
- /eval -n ${random:0,10} ==> 3
- /eval -n ${base_encode:64,test} ==> dGVzdA==
- /eval -n ${base_decode:64,dGVzdA==} ==> test
- /eval -n ${translate:Plugin} ==> Extension
- /eval -n ${define:len,${calc:5+3}}${len}x${len} ==> 8x8
-
-Examples (conditions):
- /eval -n -c ${window.buffer.number} > 2 ==> 0
- /eval -n -c ${window.win_width} > 100 ==> 1
- /eval -n -c (8 > 12) || (5 > 2) ==> 1
- /eval -n -c (8 > 12) && (5 > 2) ==> 0
- /eval -n -c abcd =~ ^ABC ==> 1
- /eval -n -c abcd =~ (?-i)^ABC ==> 0
- /eval -n -c abcd =~ (?-i)^abc ==> 1
- /eval -n -c abcd !~ abc ==> 0
- /eval -n -c abcd =* a*d ==> 1
- /eval -n -c abcd =- bc ==> 1
-----
-
-[[command_weechat_filter]]
-* `+filter+`: filtra messaggi nei buffer, per nascondere/mostrare in base a tag o regexp
-
-----
-/filter list
- enable|disable|toggle [<name>|@]
- add|addreplace <name> <buffer>[,<buffer>...] <tags> <regex>
- rename <name> <new_name>
- recreate <name>
- del <name>|-all [<name>...]
-
- list: list all filters
- enable: enable filters (filters are enabled by default)
- disable: disable filters
- toggle: toggle filters
- name: filter name ("@" = enable/disable all filters in current buffer)
- add: add a filter
-addreplace: add or replace an existing filter
- rename: rename a filter
- recreate: set input with the command used to edit the filter
- del: delete a filter
- -all: delete all filters
- buffer: comma separated list of buffers where filter is active:
- - this is full name including plugin (example: "irc.libera.#weechat" or "irc.server.libera")
- - "*" means all buffers
- - a name starting with '!' is excluded
- - wildcard "*" is allowed
- tags: comma separated list of tags, for example "irc_join,irc_part,irc_quit"
- - logical "and": use "+" between tags (for example: "nick_toto+irc_action")
- - wildcard "*" is allowed
- - if tag starts with '!', then it is excluded and must NOT be in message
- regex: POSIX extended regular expression to search in line
- - use '\t' to separate prefix from message, special chars like '|' must be escaped: '\|'
- - if regex starts with '!', then matching result is reversed (use '\!' to start with '!')
- - two regular expressions are created: one for prefix and one for message
- - regex are case insensitive, they can start by "(?-i)" to become case sensitive
-
-The default key alt+'=' toggles filtering on/off globally and alt+'-' toggles filtering on/off in the current buffer.
-
-Tags most commonly used:
- no_filter, no_highlight, no_log, log0..log9 (log level),
- notify_none, notify_message, notify_private, notify_highlight,
- self_msg, nick_xxx (xxx is nick in message), prefix_nick_ccc (ccc is color of nick),
- host_xxx (xxx is username + host in message),
- irc_xxx (xxx is command name or number, see /server raw or /debug tags),
- irc_numeric, irc_error, irc_action, irc_ctcp, irc_ctcp_reply, irc_smart_filter, away_info.
-To see tags for lines in buffers: /debug tags
-
-Examples:
- use IRC smart filter on all buffers:
- /filter add irc_smart * irc_smart_filter *
- use IRC smart filter on all buffers except those with "#weechat" in name:
- /filter add irc_smart *,!*#weechat* irc_smart_filter *
- filter all IRC join/part/quit messages:
- /filter add joinquit * irc_join,irc_part,irc_quit *
- filter nicks displayed when joining channels or with /names:
- /filter add nicks * irc_366 *
- filter nick "toto" on IRC channel #weechat:
- /filter add toto irc.libera.#weechat nick_toto *
- filter IRC join/action messages from nick "toto":
- /filter add toto * nick_toto+irc_join,nick_toto+irc_action *
- filter lines containing "weechat sucks" on IRC channel #weechat:
- /filter add sucks irc.libera.#weechat * weechat sucks
- filter lines that are strictly equal to "WeeChat sucks" on all buffers:
- /filter add sucks2 * * (?-i)^WeeChat sucks$
-----
-
-[[command_weechat_help]]
-* `+help+`: visualizza l'aiuto su comandi e opzioni
-
-----
-/help -list|-listfull [<plugin> [<plugin>...]]
- <comando>
- <opzione>
-
- -list: elenca i comandi, per plugin (senza argomento, viene mostrata questa lista)
--listfull: elenca i comandi con la relativa descrizione, per plugin
- plugin: elenca i comandi per questo plugin
- comando: nome di un comando
- opzione: nome di un'opzione (usare /set per consultare la lista)
-----
-
-[[command_weechat_history]]
-* `+history+`: mostra la cronologia dei comandi del buffer
-
-----
-/history <clear
- valore>
-
- clear: pulisci cronologia
-valore: numero delle voci nella cronologia da mostrare
-----
-
-[[command_weechat_hotlist]]
-* `+hotlist+`: manage hotlist
-
-----
-/hotlist add [low|message|private|highlight]
- clear [<level>]
- remove
- restore [-all]
-
- add: add current buffer in hotlist (default level: "low", conditions defined in option weechat.look.hotlist_add_conditions are NOT checked)
- clear: clear hotlist
- level: "lowest" to clear only lowest level in hotlist, highest" to clear only highest level in hotlist, or level mask: integer which is a combination of 1=join/part, 2=message, 4=private, 8=highlight)
- remove: remove current buffer from hotlist
-restore: restore latest hotlist removed in the current buffer (or all buffers with -all)
-----
-
-[[command_weechat_input]]
-* `+input+`: funzioni per la riga di comando
-
-----
-/input <azioni> [<argomenti>]
-
-list of actions:
- return: simulate key "enter"
- complete_next: complete word with next completion
- complete_previous: complete word with previous completion
- search_text_here: search text in buffer at current position
- search_text: search text in buffer
- search_switch_case: switch exact case for search
- search_switch_regex: switch search type: string/regular expression
- search_switch_where: switch search in messages/prefixes
- search_previous: search previous line
- search_next: search next line
- search_stop_here: stop search at current position
- search_stop: stop search
- delete_previous_char: delete previous char
- delete_next_char: delete next char
- delete_previous_word: delete previous word
- delete_previous_word_whitespace: delete previous word (until whitespace)
- delete_next_word: delete next word
- delete_beginning_of_line: delete from beginning of line until cursor
- delete_beginning_of_input: delete from beginning of input until cursor
- delete_end_of_line: delete from cursor until end of line
- delete_end_of_input: delete from cursor until end of input
- delete_line: delete current line
- delete_input: delete entire input
- clipboard_paste: paste from the internal 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_beginning_of_input: move cursor to beginning of input
- move_end_of_line: move cursor to end of line
- move_end_of_input: move cursor to end of input
- 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
- move_previous_line: move cursor to previous line
- move_next_line: move cursor to next line
- 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
- grab_key: grab a key (optional argument: delay for end of grab, default is 500 milliseconds)
- grab_key_command: grab a key with its associated command (optional argument: delay for end of grab, default is 500 milliseconds)
- grab_mouse: grab mouse event code
- grab_mouse_area: grab mouse event code with area
- insert: insert text in command line (escaped chars are allowed, see /help print)
- send: send text to the buffer
-
-This command is used by key bindings or plugins.
-----
-
-[[command_weechat_item]]
-* `+item+`: manage custom bar items
-
-----
-/item list
- add|addreplace <name> "<conditions>" "<content>"
- rename <name> <new_name>
- refresh <name> [<name>...]
- recreate <name>
- del <name>|-all
-
- list: list all custom bar items
- add: add a custom bar item
-addreplace: add or replace an existing custom bar item
- name: custom bar item name
-conditions: evaluated conditions to display the bar item (for example to display the bar item only in specific buffers)
- content: content (evaluated, see /help eval)
- rename: rename a custom bar item
- refresh: update content of item in all bars where the item is displayed; any item can be refreshed: default/plugin/custom bar items
- recreate: set input with the command used to edit the custom bar item
- del: delete a custom bar item
- -all: delete all custom bar items
-
-Examples:
- add item with terminal size, displayed only in buffers with number = 1:
- /item add terminfo "${buffer.number} == 1" "term:${info:term_width}x${info:term_height}"
- add item with buffer info:
- /item add bufinfo "" "${buffer.number}:${buffer.name}${if:${buffer.zoomed}?(Z)}"
- add item with date/time using format "Dec 25, 12:34 +0100", refreshed every minute:
- /item add datetime "" "${date:%b %d, %H:%M %z}"
- /trigger add datetime_refresh timer "60000;60" "" "" "/item refresh datetime"
- add item with number of lines in buffer (displayed/total), refreshed each time a new line is displayed or if filtered lines have changed:
- /item add lines_count "" "${calc:${buffer.lines.lines_count}-${buffer.lines.lines_hidden}}/${buffer.lines.lines_count} lines"
- /trigger add lines_count_refresh_print print "" "" "" "/item refresh lines_count"
- /trigger add lines_count_refresh_signal signal "window_switch;buffer_switch;buffer_lines_hidden;filters_*" "" "" "/item refresh lines_count"
- force refresh of item "lines_count":
- /item refresh lines_count
- recreate item "lines_count" with different conditions or content:
- /item recreate lines_count
- delete item "lines_count":
- /item del lines_count
-----
-
-[[command_weechat_key]]
-* `+key+`: associa/disassocia tasti
-
-----
-/key [list|listdefault|listdiff] [<context>]
- bind <key> [<command> [<args>]]
- bindctxt <context> <key> [<command> [<args>]]
- unbind <key>
- unbindctxt <context> <key>
- reset <key>
- resetctxt <context> <key>
- resetall -yes [<context>]
- missing [<context>]
- legacy <key> [<key>...]
-
- list: list all current keys
-listdefault: list default keys
- listdiff: list differences between current and default keys (keys added, redefined or deleted)
- context: name of context ("default" or "search")
- bind: bind a command to a key or display command bound to key (for context "default")
- bindctxt: bind a command to a key or display command bound to key, for given context
- command: command (many commands can be separated by semicolons)
- unbind: remove a key binding (for context "default")
- unbindctxt: remove a key binding for given context
- reset: reset a key to default binding (for context "default")
- resetctxt: reset a key to default binding, for given context
- 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
- legacy: display new name for legacy keys
-
-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 name in command line.
-
-Modifiers allowed (in this order when multiple are used):
- meta- (alt key)
- ctrl- (control key)
- shift- (shift key, can only be used with key names below)
-
-Key names allowed: f0 to f20, home, insert, delete, end, backspace, pgup, pgdn, up, down, right, left, tab, return, comma, space.
-
-Combo of keys must be separated by a comma.
-
-For context "mouse" (possible in context "cursor" too), key has format: "@area:key" or "@area1>area2:key" where area can be:
- *: any area on screen
- chat: chat area (any buffer)
- chat(xxx): chat area for buffer with name "xxx" (full name including plugin)
- bar(*): any bar
- bar(xxx): bar "xxx"
- item(*): any bar item
- item(xxx): bar item "xxx"
-Wildcard "*" is allowed in key to match many mouse events.
-A special value for command with format "hsignal:name" can be used for context mouse, this will send the hsignal "name" with the focus hashtable as argument.
-Another special value "-" can be used to disable key (it will be ignored when looking for keys).
-
-Examples:
- 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
- key meta-v then f1 to run /help:
- /key bind meta-v,f1 /help
- key "tab" to stop search in buffer:
- /key bindctxt search tab /input search_stop
- middle button of mouse on a nick to retrieve info on nick:
- /key bindctxt mouse @item(buffer_nicklist):button3 /msg nickserv info ${nick}
-----
-
-[[command_weechat_layout]]
-* `+layout+`: manage buffers/windows layouts
-
-----
-/layout store [<name>] [buffers|windows]
- apply [<name>] [buffers|windows]
- leave
- del [<name>] [buffers|windows]
- rename <name> <new_name>
-
- store: store current buffers/windows in a layout
- apply: apply stored layout
- leave: leave current layout (does not update any layout)
- del: delete buffers and/or windows in a stored layout
- (if neither "buffers" nor "windows" is given after the name, the layout is deleted)
- rename: rename a layout
- name: name for stored layout (default is "default")
-buffers: store/apply only buffers (order of buffers)
-windows: store/apply only windows (buffer displayed by each window)
-
-Without argument, this command displays stored layouts.
-
-The current layout can be saved on /quit command with the option "weechat.look.save_layout_on_exit".
-
-Note: the layout only remembers windows split and buffers numbers. It does not open buffers. That means for example you must still auto-join IRC channels to open the buffers, the saved layout only applies once the buffers are opened.
-----
-
-[[command_weechat_mouse]]
-* `+mouse+`: controllo mouse
-
-----
-/mouse enable|disable|toggle [<ritardo>]
-
- enable: abilita mouse
-disable: disabilita mouse
- toggle: abilita/disabilita mouse
-ritardo: ritardo (in secondi) dopo il quale viene ripristinato lo stato iniziale del mouse (utile per disattivarlo temporaneamente)
-
-Lo stato del mouse viene salvato nell'opzione "weechat.look.mouse".
-
-Esempi:
- abilita mouse:
- /mouse enable
- abilita/disabilita mouse per 5 secondi:
- /mouse toggle 5
-----
-
-[[command_weechat_mute]]
-* `+mute+`: esegue un comando in silenzio
-
-----
-/mute [-core | -current | -buffer <name>] <command>
-
- -core: no output on WeeChat core buffer
--current: no output on current buffer
- -buffer: no output on specified buffer
- name: full buffer name (examples: "irc.server.libera", "irc.libera.#weechat")
- command: command to execute silently (a '/' is automatically added if not found at beginning of command)
-
-If no target is specified (-core, -current or -buffer), then default is to mute all buffers.
-
-Examples:
- config save:
- /mute save
- message to current IRC channel:
- /mute -current msg * hi!
- message to #weechat channel:
- /mute -buffer irc.libera.#weechat msg #weechat hi!
-----
-
-[[command_weechat_plugin]]
-* `+plugin+`: elenca/carica/scarica plugin
-
-----
-/plugin list [-o|-ol|-i|-il|<name>]
- listfull [<name>]
- load <filename> [<arguments>]
- autoload [<arguments>]
- reload [<name>|* [<arguments>]]
- unload [<name>]
-
- list: list loaded plugins
- -o: send list of loaded plugins to buffer (string in English)
- -ol: send list of loaded plugins to buffer (translated string)
- -i: copy list of loaded plugins in command line (for sending to buffer) (string in English)
- -il: copy list of loaded plugins in command line (for sending to buffer) (translated string)
- name: a plugin name
- listfull: list loaded plugins (verbose)
- load: load a plugin
- filename: plugin (file) to load
-arguments: arguments given to plugin on load
- autoload: autoload plugins in system or user directory
- reload: reload a plugin (if no name given, unload all plugins, then autoload plugins)
- unload: unload a plugin (if no name given, unload all plugins)
-
-Without argument, this command lists loaded plugins.
-----
-
-[[command_weechat_print]]
-* `+print+`: display text on a buffer
-
-----
-/print [-buffer <number>|<name>] [-newbuffer <name>] [-free] [-switch] [-core|-current] [-y <line>] [-escape] [-date <date>] [-tags <tags>] [-action|-error|-join|-network|-quit] [<text>]
- -stdout|-stderr [<text>]
- -beep
-
- -buffer: display text in this buffer (default: buffer where command is executed)
--newbuffer: create a new buffer and display text in this buffer
- -free: create a buffer with free content (with -newbuffer only)
- -switch: switch to the buffer
- -core: alias of "-buffer core.weechat"
- -current: display text on current buffer
- -y: display on a custom line (for buffer with free content only)
- line: line number for buffer with free content (first line is 0, a negative number displays after last line: -1 = after last line, -2 = two lines after last line, etc.)
- -escape: interpret escaped chars (for example \a, \07, \x07)
- -date: message date, format can be:
- -n: 'n' seconds before now
- +n: 'n' seconds in the future
- n: 'n' seconds since the Epoch (see man time)
- date/time (ISO 8601): yyyy-mm-ddThh:mm:ss, example: 2014-01-19T04:32:55
- time: hh:mm:ss (example: 04:32:55)
- -tags: comma-separated list of tags (see /help filter for a list of tags most commonly used)
- text: text to display (prefix and message must be separated by "\t", if text starts with "-", then add a "\" before)
- -stdout: display text on stdout (escaped chars are interpreted)
- -stderr: display text on stderr (escaped chars are interpreted)
- -beep: alias of "-stderr \a"
-
-The options -action ... -quit use the prefix defined in options "weechat.look.prefix_*".
-
-Following escaped chars are supported:
- \" \\ \a \b \e \f \n \r \t \v \0ooo \xhh \uhhhh \Uhhhhhhhh
-
-Examples:
- display a reminder on core buffer with a highlight:
- /print -core -tags notify_highlight Reminder: buy milk
- display an error on core buffer:
- /print -core -error Some error here
- display message on core buffer with prefix "abc":
- /print -core abc\tThe message
- display a message on channel #weechat:
- /print -buffer irc.libera.#weechat Message on #weechat
- display a snowman (U+2603):
- /print -escape \u2603
- send alert (BEL):
- /print -beep
-----
-
-[[command_weechat_proxy]]
-* `+proxy+`: gestione dei proxy
-
-----
-/proxy list
- add <nome> <tipo> <indirizzo> <porta> [<nomeutente> [<password>]]
- del <nome>|-all
- set <nome> <opzione> <valore>
-
- list: list all proxies
- add: add a new proxy
- name: name of proxy (must be unique)
- type: http, socks4 or socks5
- address: IP or hostname
- port: port
-username: username (optional)
-password: password (optional)
- del: delete a proxy (or all proxies with -all)
- set: set a value for a proxy property
- option: option to change (for options list, look at /set weechat.proxy.<proxyname>.*)
- value: new value for option
-
-Examples:
- add a http proxy, running on local host, port 8888:
- /proxy add local http 127.0.0.1 8888
- add a http proxy using IPv6 protocol:
- /proxy add local http ::1 8888
- /proxy set local ipv6 on
- add a socks5 proxy with username/password:
- /proxy add myproxy socks5 sample.host.org 3128 myuser mypass
- delete a proxy:
- /proxy del myproxy
-----
-
-[[command_weechat_quit]]
-* `+quit+`: esce da WeeChat
-
-----
-/quit [-yes] [<argomenti>]
-
- -yes: required if option "weechat.look.confirm_quit" is enabled
-arguments: text sent with signal "quit"
- (for example irc plugin uses this text to send quit message to server)
-
-By default when quitting the configuration files are saved (see option "weechat.look.save_config_on_exit") and the current layout can be saved (see option "weechat.look.save_layout_on_exit").
-----
-
-[[command_weechat_reload]]
-* `+reload+`: ricarica i file di configurazione da disco
-
-----
-/reload [<file> [<file....>]]
-
-file: file di configurazione da ricaricare (senza estensione ".conf")
-
-Senza argomento, vengono ricaricati tutti i file (WeeChat e plugin).
-----
-
-[[command_weechat_repeat]]
-* `+repeat+`: esegue un comando più volte
-
-----
-/repeat [-interval <delay>[<unit>]] <count> <command>
-
- delay: delay between execution of commands
- unit: optional, values are:
- ms: milliseconds
- s: seconds (default)
- m: minutes
- h: hours
- count: number of times to execute command
-command: command to execute (or text to send to buffer if command does not start with '/')
-
-Note: the command is executed on buffer where /repeat was executed (if the buffer does not exist any more, the command is not executed).
-
-Example:
- scroll 2 pages up:
- /repeat 2 /window page_up
-----
-
-[[command_weechat_reset]]
-* `+reset+`: reset config options
-
-----
-/reset <option>
- -mask <option>
-
-option: name of an option
- -mask: use a mask in option (wildcard "*" is allowed to mass-reset options, use carefully!)
-
-Examples:
- reset one option:
- /reset weechat.look.item_time_format
- reset all color options:
- /reset -mask weechat.color.*
-----
-
-[[command_weechat_save]]
-* `+save+`: salva i file di configurazione su disco
-
-----
-/save [<file> [<file....>]]
-
-file: configuration file to save (without extension ".conf")
-
-Without argument, all files (WeeChat and plugins) are saved.
-
-By default all configuration files are saved to disk on /quit command (see option "weechat.look.save_config_on_exit").
-----
-
-[[command_weechat_secure]]
-* `+secure+`: gestione dei dati sensibili (password o file privati cifrati nel file sec.conf)
-
-----
-/secure passphrase <chiave di cifratura>|-delete
- decrypt <chiave di cifratura|-discard
- set <nome> <valore>
- del <nome>
-
-passphrase: change the passphrase (without passphrase, data is stored as plain text in file sec.conf)
- -delete: delete passphrase
- decrypt: decrypt data still encrypted (it happens only if passphrase was not given on startup)
- -discard: discard all data still encrypted
- set: add or change secured data
- del: delete secured data
-
-Without argument, this command displays secured data in a new buffer.
-
-Keys on secure buffer:
- alt+v toggle values
-
-When a passphrase is used (data encrypted), it is asked by WeeChat on startup.
-It is possible to set environment variable "WEECHAT_PASSPHRASE" to prevent the prompt (this same variable is used by WeeChat on /upgrade), or to set option sec.crypt.passphrase_command to read the passphrase from the output of an external command like a password manager (see /help sec.crypt.passphrase_command).
-
-Secured data with format ${sec.data.xxx} can be used in:
- - command /eval
- - command line argument "--run-command"
- - options weechat.startup.command_{before|after}_plugins
- - other options that may contain a password or sensitive data (for example proxy, irc server and relay); see /help on the options to check if they are evaluated.
-
-Examples:
- set a passphrase:
- /secure passphrase this is my passphrase
- use program "pass" to read the passphrase on startup:
- /set sec.crypt.passphrase_command "/usr/bin/pass show weechat/passphrase"
- encrypt libera SASL password:
- /secure set libera mypassword
- /set irc.server.libera.sasl_password "${sec.data.libera}"
- encrypt oftc password for nickserv:
- /secure set oftc mypassword
- /set irc.server.oftc.command "/msg nickserv identify ${sec.data.oftc}"
- alias to ghost the nick "mynick":
- /alias add ghost /eval /msg -server libera nickserv ghost mynick ${sec.data.libera}
-----
-
-[[command_weechat_set]]
-* `+set+`: set config options and environment variables
-
-----
-/set [<option> [<value>]]
- diff [<option> [<option>...]]
- env [<variable> [<value>]]
-
-option: name of an option (wildcard "*" is allowed to list options, if no value is specified)
- value: new value for option, according to type:
- boolean: on, off or toggle
- integer: number, ++number or --number
- string: any string ("" for empty string)
- color: color name, ++number or --number
- Note: for all types, you can use null to remove option value (undefined value). This works only for some special plugin variables.
- diff: display only changed options
- env: display or set an environment variable (use value "" to unset a variable)
-
-Examples:
- display options about highlight:
- /set *highlight*
- add a word to highlight:
- /set weechat.look.highlight "word"
- display changed options:
- /set diff
- display changed options in irc plugin:
- /set diff irc.*
- display value of environment variable LANG:
- /set env LANG
- set environment variable LANG and use it:
- /set env LANG fr_FR.UTF-8
- /upgrade
- unset environment variable ABC:
- /set env ABC ""
-----
-
-[[command_weechat_toggle]]
-* `+toggle+`: toggle value of a config option
-
-----
-/toggle <option> [<value> [<value>...]]
-
-option: name of an option
- value: possible values for the option (values are split like the shell command arguments: quotes can be used to preserve spaces at the beginning/end of values)
-
-Behavior:
- - only an option of type boolean or string can be toggled without a value:
- - boolean: toggle between on/off according to current value
- - string: toggle between empty string and default value (works only if empty string is allowed for the option)
- - with a single value given, toggle between this value and the default value of option
- - with multiple values given, toggle between these values: the value used is the one following the current value of option; if the current value of option is not in list, the first value in the list is used
- - the special value "null" can be given, but only as first value in the list and without quotes around.
-
-Examples:
- toggle display of time in chat area (without displaying the new value used):
- /mute /toggle weechat.look.buffer_time_format
- switch format of time in chat area (with seconds, without seconds, disabled):
- /toggle weechat.look.buffer_time_format "%H:%M:%S" "%H:%M" ""
- toggle autojoin of #weechat channel on libera server:
- /toggle irc.server.libera.autojoin null #weechat
-----
-
-[[command_weechat_unset]]
-* `+unset+`: annulla/ripristina opzione
-
-----
-/unset <option>
- -mask <option>
-
-option: name of an option
- -mask: use a mask in option (wildcard "*" is allowed to mass-reset options, use carefully!)
-
-According to option, it's reset (for standard options) or removed (for optional settings, like server values).
-
-Examples:
- reset one option:
- /unset weechat.look.item_time_format
- reset all color options:
- /unset -mask weechat.color.*
-----
-
-[[command_weechat_upgrade]]
-* `+upgrade+`: save WeeChat session and reload the WeeChat binary without disconnecting from servers
-
-----
-/upgrade [-yes] [<path_to_binary>|-save|-quit]
-
- -yes: required if option "weechat.look.confirm_upgrade" is enabled
-path_to_binary: path to WeeChat binary (default is current binary)
- -dummy: do nothing (option used to prevent accidental completion with "-quit")
- -save: only save the session, do not quit nor reload WeeChat; the configuration files are not saved (if needed you can use /save before this command)
- -quit: close *ALL* connections, save session and quit WeeChat, which makes possible a delayed restoration (see below)
-
-This command upgrades and reloads a running WeeChat session. The new WeeChat binary must have been compiled or installed with a package manager before running this command.
-
-Note: SSL connections are lost during upgrade (except with -save), because the reload of SSL sessions is currently not possible with GnuTLS. There is automatic reconnection after upgrade.
-
-Important: use of option -save can be dangerous, it is recommended to use only /upgrade (or with -quit) for a standard upgrade and a restart; the option -save can be used to save the session regularly and restore it in case of after abnormal exit (power outage, crash, etc.)
-
-Upgrade process has 4 steps:
- 1. save session into files for core and plugins (buffers, history, ..)
- 2. unload all plugins (configuration files (*.conf) are written on disk)
- 3. save WeeChat configuration (weechat.conf)
- 4. execute new WeeChat binary and reload session.
-
-With option "-quit", the process is:
- 1. close *ALL* connections (irc, xfer, relay, ...)
- 2. save session into files (*.upgrade)
- 3. unload all plugins
- 4. save WeeChat configuration
- 5. quit WeeChat
-
-With option "-save", the process is:
- 1. save session into files (*.upgrade) with a disconnected state for IRC servers and Relay clients (but no disconnection is made)
-
-With -quit or -save, you can restore the session later with this command: weechat --upgrade
-IMPORTANT: you must restore the session with exactly same configuration (files *.conf) and if possible the same WeeChat version (or a more recent one).
-It is possible to restore WeeChat session on another machine if you copy the content of WeeChat home directories (see /debug dirs).
-----
-
-[[command_weechat_uptime]]
-* `+uptime+`: mostra l'uptime di WeeChat
-
-----
-/uptime [-o|-ol]
-
- -o: invia l'uptime al buffer corrente come input (stringa in inglese)
--ol: invia l'uptime al buffer corrente come input (stringa tradotta)
-----
-
-[[command_weechat_version]]
-* `+version+`: mostra la versione e la data di compilazione di WeeChat
-
-----
-/version [-o|-ol]
-
- -o: send version to current buffer as input (English string)
--ol: send version to current buffer as input (translated string)
-
-The default alias /v can be used to execute this command on all buffers (otherwise the irc command /version is used on irc buffers).
-----
-
-[[command_weechat_wait]]
-* `+wait+`: pianifica l'esecuzione di un comando
-
-----
-/wait <numero>[<unità>] <comando>
-
- number: amount of time to wait (integer number)
- unit: optional, values are:
- ms: milliseconds
- s: seconds (default)
- m: minutes
- h: hours
-command: command to execute (or text to send to buffer if command does not start with '/')
-
-Note: the command is executed on buffer where /wait was executed (if the buffer does not exist any more, the command is not executed).
-
-Examples:
- join channel in 10 seconds:
- /wait 10 /join #test
- set away in 15 minutes:
- /wait 15m /away -all I'm away
- say 'hello' in 2 minutes:
- /wait 2m hello
-----
-
-[[command_weechat_window]]
-* `+window+`: gestione delle finestre
-
-----
-/window list
- -1|+1|b#|up|down|left|right [-window <number>]
- <number>
- splith|splitv [-window <number>] [<pct>]
- resize [-window <number>] [h|v][+|-]<pct>
- balance
- merge [-window <number>] [all]
- close [-window <number>]
- page_up|page_down [-window <number>]
- refresh
- scroll [-window <number>] [+|-]<value>[s|m|h|d|M|y]
- scroll_horiz [-window <number>] [+|-]<value>[%]
- scroll_up|scroll_down|scroll_top|scroll_bottom|scroll_beyond_end|scroll_previous_highlight|scroll_next_highlight|scroll_unread [-window <number>]
- swap [-window <number>] [up|down|left|right]
- zoom [-window <number>]
- bare [<delay>]
-
- list: list opened windows (without argument, this list is displayed)
- -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
- number: window number (see /window list)
- splith: split current window horizontally (to undo: /window merge)
- splitv: split current window vertically (to undo: /window merge)
- resize: resize window size, new size is <pct> percentage of parent window
- if "h" or "v" is specified, the resize affects the nearest parent window with a split of this type (horizontal/vertical)
- balance: balance the sizes of all windows
- merge: merge window with another (all = keep only one window)
- close: close window
- page_up: scroll one page up
- page_down: scroll one page down
- refresh: refresh screen
- scroll: scroll a number of lines (+/-N) or with time: s=seconds, m=minutes, h=hours, d=days, M=months, y=years
- scroll_horiz: scroll horizontally a number of columns (+/-N) or percentage of window size (this scrolling is possible only on buffers with free content)
- 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_beyond_end: scroll beyond the end of buffer
-scroll_previous_highlight: scroll to previous highlight
-scroll_next_highlight: scroll to next highlight
-scroll_unread: scroll to unread marker
- swap: swap buffers of two windows (with optional direction for target window)
- zoom: zoom on window
- bare: toggle bare display (with optional delay in seconds for automatic return to standard display mode)
-
-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
-
-Examples:
- jump to window displaying buffer #1:
- /window b1
- scroll 2 lines up:
- /window scroll -2
- scroll 2 days up:
- /window scroll -2d
- scroll to beginning of current day:
- /window scroll -d
- zoom on window #2:
- /window zoom -window 2
- split window horizontally using 30% of space for the window on top:
- /window splith 30
- resize window to 75% of the parent window size:
- /window resize 75
- resize vertical split, add 10% in size:
- /window resize v+10
- remove the split, keep the current window:
- /window merge
- close the current window:
- /window close
- enable bare display for 2 seconds:
- /window bare 2
-----
-// end::weechat_commands[]
-
-// tag::xfer_commands[]
-[[command_xfer_me]]
-* `+me+`: invia un'azione CTCP all'host remoto
-
-----
-/me <messaggio>
-
-messaggio: messaggio da inviare
-----
-
-[[command_xfer_xfer]]
-* `+xfer+`: controllo xfer
-
-----
-/xfer [list|listfull]
-
- list: lista xfer
-listfull: lista xfer (dettagliata)
-
-Senza argomenti, il comando apre il buffer con la lista xfer.
-----
-// end::xfer_commands[]