QVWM(1)

NAME
qvwm - Windows 95/98 like window manager for X11

SYNPSIS
qvwm [ options ]

DESCRIPTION
Qvwm is a Windows 95/98 like window manager for X11. It is written in C++ from scratch without depending on twm or fvwm. The end is that it draws near the look-and-feel of Windows 95/98 as far as possible, and it provides the functions of a taskbar and shortcuts. Also, it supports virtual screen and a pager to be convenient to use it as a window manager. Furthermore, it deals with any languages because it is considered with internationalization.

OPTIONS
Qvwm has the following options.

--clientid client_id
    Specifies the client Id from the previous session. It is equivalent to -id or -clientId.

--config
    Displays compile options. It is equivalent to -cfg.

--display display_name
    Specifies the display name that qvwm uses by display_name. If you don't specify this option, qvwm uses the environment variable $DISPLAY. It is equivalent to -d or -display.

--help
    Displays simple description of qvwm command line options.

--noparse
    Starts qvwm without reading any configuration files. It is equivalent to -n.

--rcfile rcfile_name
    Specifies the configuration file that qvwm reads on startup by rcfile_name. By default, $HOME/.qvwmrc is read; if it doesn't exist, <QVWMDIR>/system.qvwmrc. It is equivalent to -f.

--restart
    Starts qvwm without executing a [Startup] section in a configuration file. It is equivalent to -r.

--synch
    Executes qvwm on synchronization mode. Although qvwm with this option works slowly, qvwm may work stably. It is equivalent to -s or -synch.

--version
    Displays the version and copyright of qvwm. It is equivalent to -v.

VARIABLE CONFIGURATION
The following are variables you specifies in configuration file. The value in parentheses is default.

AllowRemoteCmd (False)
    Sets whether qvwm allows other processes of the user that starts qvwm to send internal commands to it.

AutoRaise (False)
    Sets whether the active window raises on top automatically when ClickToFocus is False.

AutoRaiseDelay (500)
    Sets the delay time taken to raise the active window automatically by the millisecond. (more than 0)

ButtonColor (qvgray)
    Sets the button color.

ButtonStringColor (black)
    Sets the button string color.

CascadeMenuFont (null)
    Sets the font for the cascade memu, that is, child menus of the start menu. If this variable is not specified, DefaultFont is used.

ClickToFocus (True)
    If True, qvwm activates the window you click. Otherwise, the active window changes according to the movement of mouse cursor.

ClickingRaises (True)
    If True, a window is raised even if you click the client area. When ClickToFocus is True, ClickingRaises is always True.

ClockFormat ("%R")
    Sets the format of the taskbar clock. The format follows strftime(3).

ClockLocaleName ("")
    Sets the locale of taskbar clock. (see /usr/X11R6/lib/X11/locale/locale.alias)

ClockMessageFormat ("%A, %B %e, %Y")
    Sets the format of the message of the taskbar clock tooltip. The format follows strftime(3).

ClockStringColor (black)
    Sets the taskbar clock string color.

CloseButtonMessage ("Close")
    Sets the message of the close button tooltip.

CloseSound (NULL)
    Sets the sound file played back when a window is closed.

CtrlMenuFont (null)
    Sets the font for the control memu. If this variable is not specified, DefaultFont is used.

CtrlMoveRatio (1.0)
    Sets the ratio to the normal movement (13 dots) when you move a window using the keyboard pressing a control key.

CursorColor (white)
    Sets the cursor color.

DefaultFont ("-*-*-medium-r-normal-*-14-*")
    Sets the default font.

DefaultIcon (null)
    Sets the default image of an icon used in titlebars and taskbar buttons. The size must be 16x16. If this variable is not specified, the built-in Windows logo is used.

DefaultLargeIcon (null)
    Sets the default image of an icon used in the task switcher. The size must be 32x32. If this variable is not specified, the built-in Windows logo is used.

DefaultShortcutIcon (null)
    Sets the default image of a shortcut icon. The size must be 32x32. If this variable is not specified, the built-in image is used.

DesktopActiveColor (qvblue)
    Sets the desktop active color for the selected shortcut icon.

DesktopColor (qvroyalblue)
    Sets the desktop color. If you set WallPaper to Windows2000, the desktop is filled with this color.

DialogColor (qvgray)
    Sets the exit dialog color.

DialogFont (null)
    Sets the font for the exit dialog. If this variable is not specified, DefaultFont is used.

DialogImage ("")
    Sets the exit dialog background image.

DialogStringColor (black)
    Sets the exit dialog string color.

DisableDesktopChange (False)
    Sets whether the user cannot move or resize the taskbar, the pager, and icons.

DoubleClickRange (5)
    Sets the max distance between two clicks for double click by the dot. (more than 1)

DoubleClickTime (400)
    Sets the max interval between two clicks for double click by the millisecond. (more than 1)

EdgeResistance (0)
    Sets the resistance needed for moving the frame of a window over the edges of the screen.

EnableAlsa (True)
    Sets whether you enable ALSA (Advanced Linux Sound Architecture) if OS supports it.

EnableEsd (True)
    Sets whether you enable EsounD if installed.

EnableSound (True)
    Sets whether you enable the sound facility.

ExpandSound (NULL)
    Sets the sound file played back when a window is expanded by QVWM_EXPAND_?? functions.

FocusOnMap (False)
    Sets whether a newly mapped window is activated automatically when ClickToFocus is False.

FrameActiveColor (qvgray)
    Sets the window frame active color.

FrameActiveImage ("")
    Sets the window frame active background image.

FrameColor (qvgray)
    Sets the window frame inactive color.

FrameImage ("")
    Sets the window frame inactive background image.

FrameBorderWidth (2)
    Sets the border width of a window frame, excluding shade width.

FrameTitleHeight (18)
    Sets the titlebar height of a window frame.

FullOpaque (True)
    Sets whether the contents of a window are redrawn on resizing.

GradMenuMap (False)
    Sets whether a menu is shown gradually.

GradMenuMapSpeed (15)
    Sets the speed at which a menu is shown gradually. The speed is faster if this value is smaller. (more than 1)

GradTaskbarMotion (True)
    Sets whether the taskbar hides gradually when TaskbarAutoHide is True.

GradTaskbarMotionSpeed (20)
    Sets the speed of the taskbar on automatically hiding or raising. The speed is faster if this value is smaller. (more than 1)

GradTitlebar (False)
    Sets whether the titlebar color is graded from left to right.

GradTitlebarColors (40)
    Sets the number of colors used for the graded titlebar effect. The more colors, the smoother the gradation. (more than 1)

GradWindowMapSpeed (50)
    Sets the speed when windows are mapped and unmapped gradually. The speed is faster if this value is smaller. (more than 1)

GradWindowMapStyle (Normal)
    Sets the style for mapping and unmapping windows. Select one of Normal, TopToBottom, LeftToRight, CenterToTopBottom, CenterToLeftRight, and CenterToAll.

HourGlassTime (1000)
    Sets the time (msec) during which an hourglass is displayed when the external commands are executed.

IconBackColor (white)
    Sets the background color for icon bitmap of application by the color name or the format #RGB/#RRGGBB/#RRRGGGBBB/#RRRRGGGGBBBB.

IconFont (null)
    Sets the font for the shortcut icon. If this variable is not specified, DefaultFont is used.

IconForeColor (black)
    Sets the foreground color for icon bitmap of application by the color name or the format #RGB, etc.

IconSize (32)
    Sets the icon size.

IconStringColor (white)
    Sets the icon string color.

ImageAnimation (True)
    Sets whether qvwm makes images like shortcut icons animate.

IndicatorSize (16)
    Sets the indicator size. This value should be smaller than TaskbarButtonHeight-6.

LocaleName ("")
    Sets locale name of configuration file. By default, the environment variable $LANG is used. (see /usr/X11R6/lib/X11/locale/locale.alias)

LockDragState (False)
    Sets whether qvwm allows you to keep dragging even after releasing a mouse button until clicking it again.

MaximizeButtonMessage ("Maximize")
    Sets the message of the maximize button tooltip.

MaximizeSound (NULL)
    Sets the sound file played back when a window is maximized.

MenuActiveColor (qvblue)
    Sets the menu active color.

MenuActiveImage ("")
    Sets the menu active background image.

MenuColor (qvgray)
    Sets the menu color.

MenuCommandSound (NULL)
    Sets the sound file played back when a menu item is clicked.

MenuImage ("")
    Sets the menu inactive background image.

MenuStringActiveColor (white)
    Sets the menu string active color.

MenuStringColor (black)
    Sets the menu string inactive color.

MenuDelayTime (500)
    Sets the delay time between pointing a menu item and starting to show the menu by the millisecond. (more than 0)

MiniatureActiveColor (white)
    Sets the color for active miniature window in the pager.

MiniatureColor (black)
    Sets the color for non-active miniature window in the pager.

MinimizeButtonMessage ("Minimize")
    Sets the message of the minimize button tooltip.

MinimizeSound (NULL)
    Sets the sound file played back when a window is minimized.

NoDesktopFocus (False)
    Sets whether you allow a focus to move the desktop when ClickToFocus is False and you move the mouse pointer on the desktop.

NoFocusChangeMask (Shift)
    Sets the modifier key by which you can move a mouse cursor without changing focus to windows below temporarily when ClickToFocus is False. For this modifier key, you can specify Shift, Ctrl, Alt, Meta, Mod1-Mod5, or None.

NoResizeOverTaskbar (False)
    Sets whether qvwm allows you to resize a window over the taskbar.

NoSnappingMask (Alt)
    Sets the modifier key by which you can suppress snapping edge, snapping move, and edge resistance temporarily. For this modifier key, you can specify Shift, Ctrl, Alt, Meta, Mod1-Mod5, or None.

OnTopPager (False)
    Sets whether the pager keeps on top.

OnTopTaskbar (True)
    Sets whether the taskbar keeps on top.

OpaqueMove (True)
    Sets whether you move a window using full-drag style.

OpaqueResize (True)
    Sets whether you resize a window using full-drag style.

OpenSound (NULL)
    Sets the sound file played back when an application is started.

PagerActiveColor (qvdarkgray)
    Sets the pager active page color.

PagerColor (qvgray)
    Sets the pager color.

PagerGeometry (48x48+0+0)
    Sets the size and position of the pager by the following format.
        [<width>{xX}<height>][{+-}<xoffset>{+-}<yoffset>]

PagerImage ("")
    Sets the pager background image.

PagerSound (NULL)
    Sets the sound file played back when a virtual page is switched by clicking the pager.

PagingBeltSize (2)
    Sets the area of edges of the screen where the page switches if you move mouse cursor and wait for the time of PagingResistance. If this value is 0, switching page does not happen when you move mouse cursor to the edges of screen. (0 or more than 0)

PagingMovement (100)
    Sets the movement on switching a page by a percentage to the size of the screen. (0 or more than 0)

PagingResistance (200)
    The page switches to the next page if you wait for this time, when you move mouse cursor to edges of the screen. (0 or more than 0)

PagingSize (1x1)
    Sets the size of virtual screen by the page unit by the following format.
        <width>{xX}<height>

PagingSound (NULL)
    Sets the sound file played back when a virtual page is switched by moving the mouse cursor or executing a shortcut key.

PagingSpeed (1)
    Sets how smoothly qvwm moves a virtual page when paging. Bigger this value is, more smooth paging gets. (more than 1)

ImagePath ("")
    Sets the directories where you locate the image files, separated by ':'.

RestoreButtonMessage ("Restore")
    Sets the message of the restore button tooltip.

RestoreDownSound (NULL)
    Sets the sound file played back when a window is restored from the maximized state.

RestoreMinimize (False)
    Sets whether a window is minimized when the window is active and the corresponding taskbar button is pushed.

RestoreUpSound (NULL)
    Sets the sound file played back when a window is restored from the minimized state.

RestartOnFailure (True)
    Sets whether qvwm automatically restarts on segmentation fault or bus error.

ScreenSaver ("xlock")
    Sets your favorite screen saver program.

ScreenSaverDelay (600)
    Sets the delay time in which a screen saver is started after your system becomes idle. This delay time is specified by the second. If this value is 0, a screen saver is never started.

ShiftMoveRatio (1.0)
    Sets the ratio to the normal movement (13 dots) when you move a window using the keyboard pressing a shift key.

SmartPlacement (False)
    Sets whether qvwm locates a new window in free space automatically when screen has enough space.

SnappingEdges (0)
    Sets the distance from the edges of the screen, where a window snaps them.

SnappingMove (0)
    Sets the distance from the other windows, where a window snaps them.

SoundPath ("")
    Sets the directories where you locate the sound files, separated by ':'.

StartButtonMessage ("Start with this button.")
    Sets the message of the start button tooltip.

StartButtonTitle ("Start")
    Sets the string of the start button.

StartMenuFont (null)
    Sets the font for the start memu. If this variable is not specified, DefaultFont is used.

StartMenuLogoColor (black)
    Sets the background color of the logo area in the start menu.

StartMenuLogoImage ("")
    Sets the logo image in the start menu.

SwitcherActiveColor (qvblue)
    Sets the task switcher active color.

SwitcherColor (qvgray)
    Sets the task switcher color.

SwitcherImage ("")
    Sets the task switcher background image.

SwitcherStringColor (black)
    Sets the task switcher string color.

SystemExitSound (NULL)
    Sets the sound file played back when qvwm terminates.

SystemRestartSound (NULL)
    Sets the sound file played back when qvwm restarts.

SystemStartSound (NULL)
    Sets the sound file played back when qvwm starts.

TaskbarAutoHide (False)
    Sets whether qvwm hides the taskbar automatically.

TaskbarBoldFont (null)
    Sets the bold font for the taskbar. If this variable is not specified, DefaultFont is used.

TaskbarButtonHeight (22)
    Sets the taskbar button height. This value affects the taskbar height, the start button height and the taskbar box height.

TaskbarButtonInScr (False)
    Sets whether the taskbar shows only the taskbar buttons for windows in the current screen.

TaskbarColor (qvgray)
    Sets the taskbar color.

TaskbarFont (null)
    Sets the font for the taskbar. If this variable is not specified, DefaultFont is used.

TaskbarHideDelay (500)
    Sets the delay time between pointing the taskbar and starting to hide it by the millisecond.

TaskbarImage ("")
    Sets the taskbar backgound image.

TaskbarPosition (Bottom)
    Sets the initial position (Bottom, Top, Left, Right) of the taskbar.

TaskbarRows (1)
    Sets initial rows of the taskbar when the taskbar locates on top or bottom. (more than 1)

TaskbarShowDelay (0)
    Sets the delay time between pointing the hidden taskbar and starting to show the taskbar by the millisecond.

TitleStringActiveColor (white)
    Sets the title string active color.

TitleStringColor (qvgray)
    Sets the title string inactive color.

TitleFont (null)
    Sets the font for the titlebar. If this variable is not specified, DefaultFont is used.

TitlebarActiveColor (qvblue)
    Sets the titlebar active color. (left-side color when gradation; see GradTitlebar)

TitlebarActiveColor2 (qvgreen)
    Sets the titlebar active color. (right-side color when gradation; see GradTitlebar)

TitlebarActiveImage ("")
    Sets the titlebar active background image.

TitlebarColor (qvdarkgray)
    Sets the titlebar inactive color. (left-side color when gradation; see GradTitlebar)

TitlebarColor2 (qvgray)
    Sets the titlebar inactive color. (right-side color when gradation; see GradTitlebar)

TitlebarImage ("")
    Sets the titlebar inactive background image.

TitlebarMotion (True)
    Sets whether you make the titlebar animate when maximizing and minimizing a window.

TitlebarMotionSpeed (100)
    Sets the speed of the titlebar when maximizing and minimizing a window. The speed is faster if this value is smaller. (more than 1)

TooltipDelayTime (500)
    Sets the delay time between pointing by mouse and raising a tooltip.(ms)

TooltipDisplayTime (6000)
    Sets the time during which tooltips keep displayed.(ms)

TooltipMotionSpeed (5)
    Sets the speed in which tooltips raise gradually.

TopLeftPage (+0+0)
    Sets the top-left page of virtual screen by the following format.
        {+-}<xoffset>{+-}<yoffset>
    The page you can see on startup of qvwm is (0, 0), and virtual screen is as follows if you set TopLeftPage to -1-1.
        +-----+-----+---
        |-1,-1| 0,-1|
        +-----+-----+---
        |-1, 0| 0, 0|
        +-----+-----+---
        |     |     |

UseBoldFont (False)
    Sets whether you use bold font for bold characters used in the taskbar.

UseConfirmDialog (False)
    Sets whether you use dialog box for confirmation if exiting qvwm when all applications are not terminated.

UseDebugger (True)
    Sets whether qvwm starts a debugger(gdb) and makes a stack trace output when qvwm crashes.

UseExitDialog (True)
    Sets whether you use dialog box at exiting qvwm.

UseInfoDisplay (False)
    Sets whether qvwm displays information on the position and the size when you move and resize a window.

WallPaper (Windows98)
    Sets the image of wall paper by full path. Some strings have special meaning: Windows98 means the standard background (DesktopColor); "" means that background doesn't change.

INTERNAL COMMAND
The followings are internal commands available for menus and shortcuts. [menu], [win], [icon], and [shortcut] mean that the command is available in menus, the control menu of window, the menu of icon, and shortcut keys, respectively. Window Manager
    QVWM_EXIT                  exit qvwm
    QVWM_RESTART               restart qvwm
Window
    QVWM_MOVE                  move a window [win]
    QVWM_RESIZE                resize a window size [win]
    QVWM_MAXIMIZE              maximize a window [win]
    QVWM_MINIMIZE              minimize a window [win]
    QVWM_RESTORE               restore a window size [win]
    QVWM_EXPAND                expand a window to all directions [win]
    QVWM_EXPAND_LEFT           expand a window to a left direction [win]
    QVWM_EXPAND_RIGHT          expand a window to a right direction [win]
    QVWM_EXPAND_UP             expand a window to an up direction [win]
    QVWM_EXPAND_DOWN           expand a window to a down direction [win]
    QVWM_RAISE                 raise a window [win]
    QVWM_LOWER                 lower a window [win]
    QVWM_CLOSE                 close a window (recommend) [win]
    QVWM_KILL                  close a window forcely [win]
    QVWM_TOGGLE_ONTOP          toggle switch of an ONTOP attribute [win]
    QVWM_TOGGLE_STICKY         toggle switch of a STICKY attribute [win]
Window Focus
    QVWM_SWITCH_TASK           switch an active window [shortcut]
    QVWM_SWITCH_TASK_BACK      switch back an active window [shortcut]
    QVWM_CHANGE_WIN            change an active window
    QVWM_CHANGE_WIN_BACK       change back an active window
    QVWM_CHANGE_WIN_INSCR      change an active window within a screen
    QVWM_CHANGE_WIN_BACK_INSCR change back an active window in a screen
    QVWM_DESKTOP_FOCUS         make the desktop active
Window Rearrangement
    QVWM_OVERLAP               overlap all windows
    QVWM_OVERLAP_INSCR         overlap windows within the screen
    QVWM_TILE_HORZ             horizontally tile all windows
    QVWM_TILE_HORZ_INSCR       horizontally tile windows within the screen
    QVWM_TILE_VERT             vertically tile all windows
    QVWM_TILE_VERT_INSCR       vertically tile windows within the screen
    QVWM_MINIMIZE_ALL          minimize all windows
    QVWM_MINIMIZE_ALL_INSCR    minimize windows within the screen
    QVWM_RESTORE_ALL           restore all windows
    QVWM_RESTORE_ALL_INSCR     restore windows within the screen
    QVWM_CLOSE_ALL             close all windows
    QVWM_CLOSE_ALL_INSCR       close windows within the screen
Menu
    QVWM_POPUP_START_MENU      pop up the start menu
    QVWM_POPUP_DESKTOP_MENU    pop up the desktop menu
    QVWM_POPUP_MENU            pop up a window ctrl menu
    QVWM_POPDOWN_MENU          pop down a menu [menu]
    QVWM_POPDOWN_ALL_MENU      pop down all menus
Virtual Screen
    QVWM_UP_PAGING             switch to the up page
    QVWM_DOWN_PAGING           switch to the down page
    QVWM_LEFT_PAGING           switch to the left page
    QVWM_RIGHT_PAGING          switch to the right page
Taskbar
    QVWM_BOTTOM                move the taskbar to bottom
    QVWM_TOP                   move the taskbar to top
    QVWM_LEFT                  move the taskbar to left
    QVWM_RIGHT                 move the taskbar to right
    QVWM_TOGGLE_AUTOHIDE       toggle switch of TaskbarAutoHide
    QVWM_ENABLE_AUTOHIDE       enable TaskbarAutoHide
    QVWM_DISABLE_AUTOHIDE      disable TaskbarAutoHide
    QVWM_TOGGLE_TASKBAR        toggle switch of the taskbar show/hide
    QVWM_ENABLE_TASKBAR        show the taskbar
    QVWM_DISABLE_TASKBAR       hide the taskbar
    QVWM_SHOW_TASKBAR          appear the taskbar when TaskbarAutoHide
    QVWM_HIDE_TASKBAR          disappear the taskbar when TaskbarAutoHide
Pager
    QVWM_TOGGLE_PAGER          toggle switch of the pager show/hide
    QVWM_ENABLE_PAGER          show the pager
    QVWM_DISABLE_PAGER         hide the pager
Icon
    QVWM_LINEUP_ICON           line up shortcut icons
    QVWM_EXEC_ICON             execute the icon [icon]
    QVWM_DELETE_ICON           delete the icon [icon]
Others
    QVWM_NONE                  no action
    QVWM_SEPARATOR             sepatator(no action) [menu]

EXTERNAL COMMAND
You can specify one of some prefixes before an external command.

EXEC
    Replace qvwm with the external command. Use to switch qvwm to another window manager.
        ex) "EXEC twm"

PAGE[<x>,<y>,<identifier>]
    Locate the window created by the external command in page(x, y). Specify the title name, resource name, or resource class of the window as identifier.
        ex) "PAGE[1, 1, XEyes] xeyes"

PAGECUR[<identifier>]
    Locate the window in the page where the external command was executed.

STARTUP
You can specify external commands when qvwm starts.
    [Startup]
    external command
External command is specified by enclosing it with "". As described in EXTERNAL COMMAND section, you can specify the page where the window created by the external command is located.

MENU CONFIGURATION
You can configure menus in the section beginning with [menu name] as follows:
    item   image   action
or
    item   image
    +
    	child menu
    -
item is specified by enclosing each item name with "". You can include " by writing \". A character following to \& is a shortcut key for the item and displayed with an underscore. image is specified by enclosing the image name of the left of menus with "". In the first format, action is specified by an external command or an internal command. If program is specified as action, enclose its name with "".

The second format is used when you want to expose child menu from the item. The part enclosed with + and - is the child menu.

You can specify the followings as menu name.

StartMenu
    The menu displayed when you click the start button

CtrlMenu
    The menu displayed when you click a control menu button with left mouse button or taskbar button with right mouse button

DesktopMenu
    The menu displayed when you click the desktop with right mouse button

IconMenu
    The menu displayed when you click an icon with right mouse button

TaskbarMenu
    The menu displayed when you click the taskbar with right mouse button

SHORTCUT CONFIGURATION
You can configure shortcuts as follows:
    [Shortcuts]
    name   image   action   [x][, y]
name is specified by enclosing the string below shortcut icon with "". image is specified by enclosing the image name for shortcut icon with "". The image must locate on IMGDIR directory which you specify in by an internal command or an external command executed on double-clicking shortcut icon. If either x or y is specified, qvwm locates the shortcut in the position. When you begin x or y with '!', instead of specifying x or y in absolute coordinates, qvwm locates the shortcut in the position of the multiple of an icon area. By default, shurtcuts are located in the order of description.

ATTRIBUTE CONFIGURATION
You can configure attributes of each application as follows:
    [Applications]
    application   attribute,...
Specify class name, instance name or title name enclosed with "" as application. Attributes are as follows:

NO_BORDER
    The window has no border.

NO_BORDER_EDGE
    The window has no inner shade of a window frame.

NO_BUTTON1
    The window has no minimize button.

NO_BUTTON2
    The window has no maximize/restore button.

NO_BUTTON3
    The window has no close button.

NO_CTRLBTN
    The window has no control button.

NO_FOCUS
    The window is never activated.

NO_TBUTTON
    The taskbar button of the window is not displayed.

NO_TITLE
    The window has no title.

STICKY
    The window is always displayed even if you switch to any pages.

LARGE_IMG
    The large image(32x32) displayed in task switcher. (e.g. LARGE_IMG="xterm.xpm")

SMALL_IMG
    The small image(16x16) displayed in control menu of title bar or taskbar button. (e.g. SMALL_IMG="xterm_s.xpm")

CLOSE_SOON
    The window is not displayed but closed soon.

ONTOP
    The window is kept on top of the screen.

INIT_MAXIMIZE
    The window is maximized on initializating.

INIT_MINIMIZE
    The window is minimized on initializating.

FOCUS_ON_CLICK
    The window is activated only when clicked.

EXIT DIALOG CONFIGURATION
You can configure exit dialog as follows:
    [ExitDialog]
    part   string or image   action
You can specify the followings as part.
    CancelButton      string for cancel button
    HelpButton        string help button
    IconImage         image displayed on top-left
    OKButton          string for OK button
    RadioButton       radio button
    StaticText        string for discription
    Title             string of title bar
action is meaningful in case of radio button. Specify an internal command above or an external command as action. You can use \& for a shortcut key in a string after OKButton, CancelButton and HelpButton.

SHORTCUT KEY CONFIGURATION
You can configure shortcut keys as follows:
    [ShortCutKeys]
    key  modifier  action
key is the name of a key. Specify the string removed 'XK_' from symbols in /usr/include/X11/keysymdef.h. (You can know it with xev.) You can also use the key code for keys whose symbol is undefined. Specify the key code in the style of #xx. (xx is decimal) modifier is the name of a modifier key such as shift key, control key, alt key, etc. If you specify more than one modifier, use
    Shift       shift key
    Ctrl        control key
    Alt         alt key
    Meta        meta key
    Mod1-Mod5   no use (obsolete)
    None        no modifier
Specify an internal command or an extenal command as action.

INDICATOR CONFIGURATION
You can display a 16x16 window called indicator on the left of the clock of the taskbar. You can configure indicators as follows:
    [Indicators]
    identifier  external command
Specify the title name, resource name, or resource class of a window for an indicator as identifier. The window created by program becomes an indicator. (But the second or later window is shown as a normal window in the desktop.)

ACCESSORY CONFIGURATION
You can put accessories, your favorite images including animation files, on the desktop. You can configure accessories as follows:
    [Accessories]
    image   location   style
Specify the name of an image file whose format qvwm supports for image. location is Top, Bottom, Left, Right, TopLeft, TopRight, BottomLeft, BottomRight, Center, or geometry position (like +0+0). style is Background, OnTop, or Application. Background means that the image is put below all windows and shortcut icons. OnTop means that the image is put above all windows and shortcut icons. Application means that the image has a window frame and you can move it.

INCLUDE STATEMENT
You can read external files by using include statement in a configuration file.
    ex) include /home/kourai/.qvwmrc.local

PATH NAME
You can use ~ for your home directory, ~user for user's home directory, and environment variables following to $.
    ex) include $HOME/.qvwmrc.local
        IconPath = ~/lib/qvwm/pixmaps

SUPPORTED IMAGE FORMATS
Qvwm supports xpm format(extension .xpm). If you use Imlib, qvwm also supports formats that Imlib supports. Also, qvwm supports animation files for qvwm(extension .ani). Because the animation files contain some images as it is, an animation file is supported if qvwm supports all formats of the images in the file.

REMOTE COMMAND
The user can make qvwm execute internal commands by sending commands to /tmp/qvwm-display_name. This facility is valid only when qvwm is compiled with the remote command support and the AllowRemoteCmd variable is True. The users that can send commands are only the user that starts qvwm and the root user.

The command consists of strings of internal commands, which is devided by '. For example, if you send the QVWM_EXIT command, execute
    echo "QVWM_EXIT" > /tmp/qvwm-:0.0

FILE

$HOME/.qvwmrc
    user configuration file

$HOME/.qvwm-theme
    user theme configuration file (conventionally included in .qvwmrc)

<QVWMDIR>/system.qvwmrc
    system configuration file (<QVWMDIR> is the directory specified at compile.)

/tmp/qvwm-display_name
    FIFO for sending remote commands

WARNING
Though qvwm's official version has been released, it may be not stable enough in some environments. I am not responsible for any damages arising out of the use of qvwm.

AUTHOR
Kenichi Kourai (kourai@qvwm.org)