- 1 - Formatted: April 26, 2024
QVWM(1) Version 1.1.11 QVWM(1)
1 June 2001
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
- 1 - Formatted: April 26, 2024
QVWM(1) Version 1.1.11 QVWM(1)
1 June 2001
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)
- 2 - Formatted: April 26, 2024
QVWM(1) Version 1.1.11 QVWM(1)
1 June 2001
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.
- 3 - Formatted: April 26, 2024
QVWM(1) Version 1.1.11 QVWM(1)
1 June 2001
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.
- 4 - Formatted: April 26, 2024
QVWM(1) Version 1.1.11 QVWM(1)
1 June 2001
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.
- 5 - Formatted: April 26, 2024
QVWM(1) Version 1.1.11 QVWM(1)
1 June 2001
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.
- 6 - Formatted: April 26, 2024
QVWM(1) Version 1.1.11 QVWM(1)
1 June 2001
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.
- 7 - Formatted: April 26, 2024
QVWM(1) Version 1.1.11 QVWM(1)
1 June 2001
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
- 8 - Formatted: April 26, 2024
QVWM(1) Version 1.1.11 QVWM(1)
1 June 2001
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.
- 9 - Formatted: April 26, 2024
QVWM(1) Version 1.1.11 QVWM(1)
1 June 2001
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.
- 10 - Formatted: April 26, 2024
QVWM(1) Version 1.1.11 QVWM(1)
1 June 2001
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)
- 11 - Formatted: April 26, 2024
QVWM(1) Version 1.1.11 QVWM(1)
1 June 2001
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|
+-----+-----+---
| | |
- 12 - Formatted: April 26, 2024
QVWM(1) Version 1.1.11 QVWM(1)
1 June 2001
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]
- 13 - Formatted: April 26, 2024
QVWM(1) Version 1.1.11 QVWM(1)
1 June 2001
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
- 14 - Formatted: April 26, 2024
QVWM(1) Version 1.1.11 QVWM(1)
1 June 2001
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
- 15 - Formatted: April 26, 2024
QVWM(1) Version 1.1.11 QVWM(1)
1 June 2001
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 "".
- 16 - Formatted: April 26, 2024
QVWM(1) Version 1.1.11 QVWM(1)
1 June 2001
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:
- 17 - Formatted: April 26, 2024
QVWM(1) Version 1.1.11 QVWM(1)
1 June 2001
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
- 18 - Formatted: April 26, 2024
QVWM(1) Version 1.1.11 QVWM(1)
1 June 2001
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.)
- 19 - Formatted: April 26, 2024
QVWM(1) Version 1.1.11 QVWM(1)
1 June 2001
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.
- 20 - Formatted: April 26, 2024
QVWM(1) Version 1.1.11 QVWM(1)
1 June 2001
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 (kourai@qvwm.org)
- 21 - Formatted: April 26, 2024
