diff options
Diffstat (limited to 'doc/it/includes/autogen_user_commands.it.adoc')
| -rw-r--r-- | doc/it/includes/autogen_user_commands.it.adoc | 3308 |
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[] |