qvwm - Windows 95/98 like window manager for X11

qvwm [ options ]

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.

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.

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.

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 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]

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.

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.

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

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.

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(3) displayed in task switcher. (e.g. LARGE_IMG="xterm.xpm")

SMALL_IMG

The small image(1) 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.

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.

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.

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.)

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.

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

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

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.

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 'n'. For example, if you send the QVWM_EXIT command, execute echo "QVWM_EXIT" > /tmp/qvwm-:0.0

$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

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.

Kenichi Kourai (kourai@qvwm.org)