QLWM(1)

NAME
qlwm - X11 window manager

SYNOPSIS
qlwm [ -toolkitoption ... ] [ -c configdir ] [ --version ]

DESCRIPTION
qlwm is yet another window manager for the X11 system. Because it makes heavy use of Qt it can be kept 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>