implement view_workdirs plugin
[wmiirc-lua.git] / doc / bundled-plugins
blob0d56353f02601d4cfc4ff8ee8a1252f6963653a1
1 About
2 ======
3 wmiirc-lua bundles some plugins with the distribution and this document
4 briefly describes each.  The plugin files themselves are located in
5 ~/.wmii-3.5/plugins/ and are documented in more detail through comments.
7 browser
8 ========
9   This plugin adds two actions (alt-a):
11     - "browser" - passes argument or clipboard contents to browser.
12     - "google" - passes argument or clipboard contents to browser as a
13       search query.
15   This plugin currently requires that you have xclip utility installed.
17 clock
18 ======
19   Adds a widget named, 999_clock, which puts it at the right most
20   location.  Clock is driven by a timer which fires once a second by
21   default.  Both timer tick and clock format can be set in wmiirc.
23 loadavg
24 =======
25   Reads /proc/loadavg to display load average
27 messages
28 =========
29   Processes 'msg' events and sends them to the middle of the bar.  This
30   can be used by external tools to generate events for wmii.
32   Example:
34     tail -f /var/log/messages | xargs -n1 wmiir xwrite /event msg
36 view_workdirs
37 =============
38   Adds Mod1-apostrophe to open a terminal on the view's workdir.  The
39   module handles ShellChangeDir events generated by the sehll that 
40   update a table of working directories per view.  See plugin comments
41   for more info.
46 vim: set ts=8 et sw=8 tw=72