Bar applets in the standard plugin ================================== You can import them in wmiirc-config.rb with something like from "standard" do use_bar_applet "status" use_bar_applet "mpd", 10 # override position ... end status ====== Shows the current time, load info... (configurable) on_click actions ---------------- SCROLL_UP move to previous view SCROLL_DOWN move to next view BUTTON_LEFT perform associated action BUTTON_RIGHT " " BUTTON_MIDDLE " " configuration ------------- plugin_config["standard"]["x-terminal-emulator"] xterm program to use (default: 'xterm') plugin_config["standard:status"]["left_click_action"] action to perform on left-click (default: show output from tzwatch on new floating xterm) plugin_config["standard:status"]["middle_click_action"] action to perform on middle-click (default: run top in new floating xterm) plugin_config["standard:status"]["middle_click_action"] action to perform on middle-click (default: show output from ncal -y on new floating xterm) plugin_config["standard:status"]["text_proc"] Proc that must return a String with the text to display (default: lambda { "#{Time.new.strftime("%d/%m/%Y %X %Z")} #{currload}" } where currload is a local variable updated in a separate thread with the info given by uptime) plugin_config["standard:status"]["refresh_time"] time between updates in seconds (default: 1) *_action and text_proc can be set to an object responding to #call, typically a Proc created with lambda. volume ====== Displays the current volume. on_click actions ---------------- SCROLL_UP increase volume SCROLL_DOWN decrease bolume BUTTON_LEFT launch alsamixer on new xterm BUTTON_RIGHT (un)mute configuration ------------- plugin_config["standard:volume"]["mixer"] mixer(s) to use (default: 'Master') You can either set it to a String, or to an array of String objects with the names of the mixers to be controlled (the volume of the first one will be shown in the bar). plugin_config["standard"]["x-terminal-emulator"] xterm program to use (default: 'xterm') mode ==== Allows to switch between normal and raw input modes. Only one key combination is captured in raw mode (used to go back to normal mode). This allows you to define keybindings without worrying about conflicts with seldom used applications. configuration ------------- plugin_config["standard:mode"]["mode_toggle_keys"] keybinding used to toggle the input mode (default: 'MODKEY2-space') mpd === Allows to control the MPD (Music Playing Daemon). Requires mpd-rb http://raa.ruby-lang.org/project/mpd-rb/. on_click actions ---------------- BUTTON_LEFT pause/resume BUTTON_RIGHT run ncmpc in new floating xterm SCROLL_UP play previous song in playlist SCROLL_DOWN play next song in playlist configuration ------------- wmii.plugin_config["standard:mpd"]["title_maxlen"] truncate the title to the given length (default: -1 == full title) wmii.plugin_config["standard:mpd"]["author_maxlen"] truncate the author to the given length (default: -1 == full author) plugin_config["standard"]["x-terminal-emulator"] xterm program to use (default: 'xterm') battery-monitor =============== Gives information about the battery level and trends. configuration ------------- plugin_config["standard:battery-monitor"]["statefile"] status file (default: '/proc/acpi/battery/BAT0/state') plugin_config["standard:battery-monitor"]["infofile"] info file (default: '/proc/acpi/battery/BAT0/info') plugin_config["standard:battery-monitor"]["low"] level that triggers the low-action (default: 5) plugin_config["standard:battery-monitor"]["low-action"] action to execute when the level goes under the above level (default: 'echo "Low battery" | xmessage -center -buttons quit:0 -default quit -file -') plugin_config["standard:battery-monitor"]["critical"] level that triggers the critical action (default: 1) plugin_config["standard:battery-monitor"]["critical-action"] action to execute when the level goes under the above level (default: 'echo "Critical battery" | xmessage -center -buttons quit:0 -default quit -file -') Bookmark manager ================ Minimalistic yet very powerful bookmark manager; see the description at http://eigenclass.org/hiki.rb?ruby+wmii+bookmark+manager It can import bookmarks from del.icio.us in bulk using the del.icio.us-import internal action (MODKEY-a by default -> del.icio.us-import by default), and refresh the local bookmark list up-to-date automatically. configuration ------------- plugin_config["standard:bookmark"]["del.icio.us-user"] = "username" plugin_config["standard:bookmark"]["del.icio.us-password"] = "password" username/password used to import del.icio.us bookmarks. del.icio.us bookmark sync'ing will be disabled if they're left to nil (the default value). plugin_config["standard:bookmark"]["del.icio.us-mode"] = :bidirectional determines whether local bookmarks and modifications must be pushed to del.icio.us (:bidirectional) or not (:unidirectional) ## WORD OF CAUTION! ## Before setting the sync mode to :bidirectional, make sure ## that your bookmarks.txt file contains all the bookmarks you want to keep, ## because all the del.icio.us bookmarks not listed there will be deleted! ## You can import your del.icio.us bookmarks by setting it to ## :unidirectional and reloading wmiirc ("ALT-a wmiirc" by default). ## Allow some time for the bookmarks to be downloaded (wait until you see ## "Done importing bookmarks from del.icio.us." in ## $HOME/.wmii-3/wmiirc.log). You can then change the mode to :bidirectional ## and reload wmiirc. From that point on, the bookmark lists will be ## synchronized, so local modifications will be propagated to del.icio.us, ## and if you remove a bookmark locally it will also be deleted on ## del.icio.us. plugin_config["standard:bookmark"]["del.icio.us-shared"] = false whether bookmarks pushed to del.icio.us are shared or not (default: false) plugin_config["standard:bookmark"]["refresh_period"] period used to sync the del.icio.us bookmarks, in minutes (default: 30) plugin_config["standard:bookmark"]["multiple-open-limit"] maximum number of bookmarks to open at once with !o (default: 10) plugin_config["standard:bookmark"]["multiple-delete-limit"] maximum number of bookmarks to delete at once with !o in the delete menu (default: 10) bindings -------- Defines the following bindings: bookmark default: MODKEY-Shift-b take current X11 primary selection (with wmiipsel), ask for description (suggests the page title). You can append tags to the description: Page about foo :foo :ruby :bar tags the bookmark as :foo, :ruby and :bar, and sets the description to "Page about foo" bookmark-open default: MODKEY-b ask for a bookmark and open it on a new browser window The possible completions are shown as you type text from the description. You can refine the selection successively, entering a bit (e.g. a word) at a time (append a space if you don't want the first suggestion to be taken). You can also use any number of the following conditions (possible completions will only be shown after you press enter in that case): :tag only bookmarks tagged with :tag ~t regexp bookmarks whose description matches regexp ~u regexp bookmarks whose URL matches regexp ~d 2001 bookmarks defined/last used in 2001 ~d jan bookmarks defined/last used in January ~d >4d bookmarks defined/last used over 4 days ago ~d >4m 4 months ago ~d <4d bookmarks defined/last used less than 4 days ago ~d <4m 4 months ago ~d q1 bookmarks defined/last used in the first quarter (q1..q4) Example: eigen :ruby ~d <3m returns all bookmarks with "eigen" in the description or the URL, tagged as :ruby, used/defined in the last 3 months There are also some commands that apply to the current list (they will only be recognized as commands if you don't enter anything else on the same line): !o open all the bookmarks Usage example: :blog to select all the bookmarks tagged as :blog !o to open them all bookmark-delete default: MODKEY2-Control-d ask for bookmarks to be deleted. You can select the bookmarks as in the bookmark-open binding. !o means delete all bookmarks in current selection in this context. bookmark-edit default: MODKEY2-Control-e ask for a bookmark to be edited. You can select the bookmark as in the bookmark-open binding (!o is disabled, you can only edit one bookmark at a time). Temporary selection =================== Allows you to select clients from the active view to be retagged as +:tmp, so they also appear in the :tmp view. Useful if you want to see a small subset of the currently visible clients without retagging them manually. Use MODKEY-x (default) to select/unselect the focused client (SEL will be shown in the bar if it is selected). Use MODKEY-Shift-x (default) to destroy the temporary view (i.e. remove the corresponding tag from all clients). Works best with use_binding "namespace-move-prev" use_binding "namespace-move-next" which will allow you to switch between the main and the temporary view with MODKEY2-comma and MODKEY2-period (by default). Configuration ------------- plugin_config["standard:temporary-selection"]["select-keys"] key combination(s) used to select/unselect the current client Can be set to a single string or an array of strings. (default: "MODKEY-x") plugin_config["standard:temporary-selection"]["destroy-keys"] key combination(s) used to destroy the temporary view Can be set to a single string or an array of strings. (default: "MODKEY-Shift-x")