summaryrefslogtreecommitdiff
path: root/doc/en/autogen/user/script_commands.txt
blob: 4455af8b9b19ac233152c216f4d34d55d3eb9dce (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
[[command_script_script]]
[command]*`script`* WeeChat scripts manager::
........................................
/script  list [-o|-i]
         search <text>
         show <script>
         load|unload|reload <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
           -i: copy list of loaded scripts in command line (for sending to buffer)
       search: search scripts by tags or text and display result on scripts buffer
         show: show detailed info about a script
         load: load script(s)
       unload: unload script(s)
       reload: reload script(s)
      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

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+h  (un)hold script
  alt+v  view script

Input allowed on script buffer:
  i/r/l/L/u/h  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 iset.pl buffers.pl
  /script remove iset.pl
  /script hold urlserver.py
  /script reload urlserver
  /script upgrade
........................................