DragonFly On-Line Manual Pages
QLWM(1) DragonFly General Commands Manual QLWM(1)
NAME
qlwm - X11 window manager
SYNOPSIS
qlwm [ -toolkitoption ... ] [ -c configdir ] [ --version ]
DESCRIPTION
qlwm is yet another window manager for the X11 system. It is based on
Qt4 and designed to be small and easy to maintain.
One of the design rules was to get a non-intrusive environment that
does not bother the user with unnecessary details or features while
providing comfort and high functionality. qlwm does not make any
preferences for the toolkits that applications use.
WINDOW BUTTONS
Left button
Left mouse button is used to iconify the window. Middle mouse
button toggles screen tiling on/off. Right mouse button is used
to (un)maximize to the rim of the toolbar.
Window title
Left mouse button moves the window. Middle mouse button shows a
settings menu and window information. Right mouse button is used
to (un)maximize to full screen size.
Opening the settings window and pressing the permanent button
will modify the file appdefaults in your private configuration
directory and apply changes to all windows with the same
reference. The temporary button applies changes only to the
current window. Note that the appdefaults file must already
exists and must be writeable to use the permanent function.
Right button
Used for soft kill. For hanging windows use the kill window
function from the menu button.
TOOLBAR
Use the pager to flip between virtual desktops. The workspace is a
continuous geometry and the pager will show a miniature of the desktop
layout.
The winlist button can be used to show a list of all currently active
windows and allows direct access. The right mouse button will bring the
last fully obscured window into the foreground.
Icon handling:
qlwm uses autoscaling of server supplied icons. If no icon is present
it will utilize the additional space for text. There is no manual user
configuration required (and not possible).
To save space on the toolbar, the application buttons will appear if
the user iconifies a window. The buttons of mapped windows will
disappear automatically if new space is required.
DISPLAY MODES
In addition to floating windows, qlwm supports a fullscreen and a
tiling window management. Screenmode is mainly useful for text based
applications for which window frames are not necessary. The <ALT+F11>
key combination is used to toggle this on/off. In screenmode it is
possible to navigate between windows on a desktop with the <ALT+Tab>
and <ALT+Shift+Tab> key combinations or to add windows from other
desktops by using the winlist. Tiling mode can be toggled on/off for
the current desktop with the <ALT+F10> key combination. The purpose is
to have the best overview on a desktop and to automate window placement
with a good screen utilization. All tileable windows will be shown
without overlapping and a larger frame on the left side contains the
maximized window. The second maximize function (right click on the
window title) will swap the selected window with the maximized window
on the left frame. From the keyboard this can be accomplished by
selecting a window with the <ALT+Tab> and <ALT+Shift+Tab> key
combinations.
KEYBOARD
Key assignment is currently compile stuff and can be changed in
keyboard.h
<ALT+Shift+Tab>
Goto previous window on virtual desktop.
<ALT+Tab>
Goto next window on virtual desktop.
<Ctrl+Shift+Tab>
Goto previous virtual desktop.
<Ctrl+Tab>
Goto next virtual desktop.
<ALT+F12>
Bring the last window into foreground that is either fully
obscured by other windows or behind tiled windows.
<ALT+F11>
Toggle screenmode. In screenmode the windowmanager becomes
invisible. You can use the keyboard to navigate between windows
on the current desktop but always in fullscreen.
<ALT+F10>
Toggle tiling mode. This will show all tileable windows on a
desktop.
<ALT+F9>
Hide window (show it on the winlist but don't add a button).
<Ctrl+Esc>
Popup window list.
<Alt+Esc>
Popup menu.
CUSTOMIZATION
Three documented files are used: defaults for general startup settings,
appdefaults for application specific settings (including the toolbar
applets) and menuconfig for the menu button.
The files appear in the global directory <BASE>/files and, if present,
in the directory ~/.qlwm below the users home directory. Generally, all
files from the global directory can be copied into the local directory.
FILES
~/.qlwm User specific customization
AUTHOR
Alexander Linden <alinden@gmx.de>
QLWM(1)