Preferences

Amanda by Agnieszka Czajkowska

Back to Index

WPrefs.app

WPrefs.app is the heart of the configuration process in Window Maker.

Upon installing Window Maker and running it for the first time, the WPrefs icon is already docked. By default, it's the one with the GNUstep logo in the background and a few tools in the foreground (although your distibution may use the plain GNUstep icon or something enitrely different). Normally Linux distributions position WPrefs as the second or third icon in the Dock column by default, just above or below the terminal icon.

GNUstep Logo with ToolsGNUstep Logo

Double-clicking on this icon opens the WPrefs.app window. Across the top of the window there is a row of icons, each one corresponding to a group of settings options. There is a checkbox for balloon help on the bottom left of the WPrefs.app window. Most of the following is taken directly from the content of the ballon help dialogs.

Available preference settings

Window handling

WPrefs.app window handling preferences

Clicking the second icon allows you to select the window handling options. Clicking on this icon opens a panel allowing you to define the default placement and properties of windows in the workspace.

Window focus

WPrefs.app window focus controls

The first icon from the left-hand side controls the way windows get their focus (how they are activated).

Menu

WPrefs.app menu preferences

This panel allows you to set menu scrolling speed and submenu alignment with the parent menu. In addition, two checkboxes are provided:

Icon

WPrefs.app icon preferences


Set icon or miniwindow handling options.

Ergonomy

WPrefs.app ergonomic settings

Various types of information are defined in this panel.

Search Path

WPrefs.app icon and pixmap search path settings

This panel is used to add or delete directory paths to search for icons and pixmaps. These paths are used in the settings dialogs for dockapps and docked application icons, so having a good, complete set of defined paths is important.  This may require some manual intervention, especially upon initial setup, since some default paths will not be present on your system, while others not predefined will be present.  Use the add and remove dialogs to configure according to what is actually available.

Workspace

WPrefs.app workspace preference settings

This panel defines navigation features within the workspace.

Other

WPrefs.app other workspace configuration settings


This panel sets icon slide speed, shade animation speed, smooth scaling and titlebar control (button) style. Animations and sound are also defined here.

Applications menu

WPrefs.app application menu configuration


In this panel the applications menu and the commands to launch each application can be defined. This panel has been changed in version 0.63.and later. It now displays the actual menu thus allowing direct editing. This can be done only if the menu is in property list format. Menus in plain text format can't be edited in WPrefs. Check the README file in the Window Maker directory on how to use one or the other.

Keyboard shortcut

WPrefs.app keyboard shortcut settings

Many actions in Window Maker have predefined keyboard shortcuts. These actions mainly concern windows and workspaces. Modifying, adding or removing shortcuts can be done in this panel. Defining a shortcut can be done interactively, capturing the key combination.

Mouse

WPrefs.app mouse configuration

This panel sets the mouse speed and double-click delay. Mouse button bindings can be defined and can be disabled or enabled.

The default setting binds the right mouse button to the applications menu, middle button to the window list menu and left button to window selection (focus). Of course, with a two button mouse, the middle button binding will not work. However, on some OSes pressing both buttons at once gives the same result as the one obtained with middle button.

Starting from version 0.65 on, the mouse wheel can be used to switch workspaces. This is not default behavior and must be enabled here.

The mouse grab modifier represents the keyboard shortcut to use for actions like dragging windows with the mouse or clicking inside the window. Mod1 (Alt) is the default.

Appearance

WPrefs.app appearance settings

In this panel, everything related to the appearance of the GUI (except the background color or image) can be configured. Windows, menus and icons can have their own background "texture," meaning color gradients of various types can be configured here. Texture, color, menu style, and title alignment can be fully customized.

Expert user

WPrefs.app expert user settings

Using this panel implies some knowledge. Many options are available. Among these are:

Font configuration

Wprefs.app font configuration options

This panel allows you to configure fonts for the window and menu titlebars, for the menu body text, and for the icon and clip text.  In addition, a font may be defined for desktop messages.

Editing the configuration file

If needed, the defaults configuration file found in $(HOME)/GNUstep/Defaults/WindowMaker can be edited by hand. This file is a database with a property list syntax. When selecting an option in WPrefs.app, it's written down into this file. When modifying this defaults file, it's very important to follow the syntax.

Back to Index