wmii.rc - window manager improved 2 rc system

wmii.rc is the POSIX sh compliant configuration system of wmii(1). For further details, see the source code in or alternatively in the directory of the source tarball.

Because of the high modularization of wmii, the rc script system is the integration of all wmi components to form and control the wmii environment.

To override any default settings from , whereas <file> can be any file of the default rc system, it is recommended to do the following:

$ touch $HOME/.wmii/<file>

And edit afterwards above file as follows:

. $WMII_CONFDIR/<file>

<your additions>

The rc script will export the WMII_CONFDIR environment variable, so that it is available for all child processes of wmii.

In the following the term <prefix> means either $WMII_CONFDIR, or, if you override the global defaults, $HOME/.wmii.

You can alternatively also refer to the directory of the source tarball.

The master rc script, which is executed by wmii(1) at start up and shutdown. The usage understood by this script looks as follows:

rc start|restart|stop

rc reload [file]

rc start starts all components of wmii(1), such as the filesystem, the bar, the shortcut grabber, and the menu, beside setting up style informations and the wallpaper.

rc stop stops all components.

rc restart performs 'rc stop' and 'rc start' in that order, it is just a convenience function.

rc reload reloads the current configuration, which means refreshing style informations, updating shortcut definitions etc.

rc reload [file] reloads the specific part of the overall configuration of one of following files.

This file contains all bar-specific customizations and is included by the master rc script, see above.

This file contains all menu-specific customizations and is included by the master rc script, see above.

This file contains all keys-specific customizations and is included by the master rc script, see above.

This file contains all wmii-specific customizations and is included by the master rc script.

This file contains various settings for user-customizations, ie style settings, IXP settings or basic shortcut settings. It is included by the master rc script.

This file is a sample script, which provides status information in the status bar.

Copyright © 2003 - 2005 by Anselm R. Garbe <garbeam (at) gmail (dot) com>,

wmii(1), wmibar(1), wmifs(1), wmimenu(1), wmikeys(1), wmiplumb(1), wmir(1), wmiwarp(1)