qvwm(1x) · carta

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.

IconHorizontalSpacing (43): Sets the horizontal spacing between short cut icons.

IconSize (32): Sets the icon size.

IconStringColor (white): Sets the icon string color.

IconVerticalSpacing (43): Sets the vertical spacing between short cut icons.

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]
QVWM_TOGGLE_FOCUS          toggle switch of a focus attribute [win]
QVWM_TOGGLE_BORDER         toggle switch of a border [win]
QVWM_TOGGLE_BORDER_EDGE    toggle switch of a border edge [win]
QVWM_TOGGLE_BUTTON1        toggle switch of a minimize button [win]
QVWM_TOGGLE_BUTTON2        toggle switch of a restore button [win]
QVWM_TOGGLE_BUTTON3        toggle switch of a close button [win]
QVWM_TOGGLE_CTRLBTN        toggle switch of a control button [win]
QVWM_TOGGLE_TBUTTON        toggle switch of a taskbar button [win]
QVWM_TOGGLE_TITLE          toggle switch of a title bar [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

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

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 '0. 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 ([email protected])