FlexWinTitle Module - bakkeby/dusk GitHub Wiki

The FlexWinTitle module shows window titles in the bar grouped by the area the window belongs to.

The groups include master, stack, secondary stack, floating and hidden. More so the groups are arranged to reflect the layout used, e.g. for a centered master layout the secondary stack would be listed first, the master client(s) next, and stack clients last.

The module is controlled by this entry in the barrules array in config.h.

{ -1, 0, 0, 5, 0, 0, BAR_ALIGN_NONE, size_flexwintitle, draw_flexwintitle, click_flexwintitle, "flexwintitle" },

Refer to the Bar Rules page for general information on rules configuration.

Clicks on the workspace module will result in a ClkWinTitle click type that can be filtered on in the button bindings.

Example bindings as per the default configuration:

{ ClkWinTitle, ..., focuswin,       {0} }, // focus on the given client
{ ClkWinTitle, ..., showhideclient, {0} }, // hide the currently selected client (or show if hidden)
{ ClkWinTitle, ..., zoom,           {0} }, // moves the currently focused window to/from the master area (for tiled layouts)

When the argument for the button bindings is {0} then the bar module will set the argument based on which of the window titles the user clicked on. If the argument is explicitly set then that argument takes precedence.

This means that functions handling clicks on the window title module must be able to handle client references.

Also see the Button Bindings page.

The size of window titles relative to other window titles are determined by the weight of the group a window belongs to.

The weights are determined by the flexwintitle settings defined in config.h:

static int flexwintitle_masterweight = 15; // master weight compared to hidden and floating window titles
static int flexwintitle_stackweight  = 4;  // stack weight compared to hidden and floating window titles
static int flexwintitle_hiddenweight = 0;  // hidden window title weight
static int flexwintitle_floatweight  = 0;  // floating window title weight, set to 0 to not show floating windows

As per the default configuration window titles for clients in the master area are nearly four times wider than window titles for clients in the stack area(s).

If the weight is 0, as in the case for hidden and floating windows, then the window titles are not drawn by the module. If the weight for floating windows were to be set to 1 for example, then the size of such a window title would be a quarter of stack window titles and one fifteenth of master window titles.

If all weights have the same value then the space is divided evenly between all drawn window titles.

Refer to the WinTitle Floating module and the WinTitle Hidden module for alternative display options for window titles of hidden and floating clients.

The size of the separator between window titles is determined by the flexwintitle_separator setting in config.h.

static int flexwintitle_separator = borderpx; // width of client separator

By default this is set to the same value as the border pixel size to match the size of the bar border.

The colour of the separator will be the same as that of the bar border which by default will be the same as that of the master area which again depends on the layout.

If the BarActiveGroupBorderColor functionality is enabled then the colour of the bar separator will be the same as that of the currently active area, which means that the colour may change when focus moves between master and stack areas.

If the BarMasterGroupBorderColor functionality is enabled then the colour of the bar separator will be the same as the master group of the current layout.

If both functionalities are disabled then the bar separator colour will be that of the SchemeTitleNorm colour scheme.

The indicator for floating windows can be controlled by the indicators settings in config.h:

	[IndicatorTiled] = INDICATOR_NONE,
	[IndicatorFloating] = INDICATOR_TOP_LEFT_LARGER_SQUARE,

By default tiled window titles have no special indicators.

There are also indicators specifically for windows where fake fullscreen has been enabled.

Refer to the Bar Indicators page for options.

Window titles are centered within their allocated space when the CenteredWindowName functionality is enabled and they will be left aligned if the functionality is disabled.

An window icon will be shown on the left of the window title if the application provides one.

The display of icons can be enabled via the WinTitleIcons functionality.

The size of the icon is determined by the iconsize variable in config.h.

static const int iconsize    = 16;  /* icon size */
static const int iconspacing = 5;   /* space between icon and title */

The spacing between the icon and the window title is determined by the iconspacing variable.

The colours for window titles generally depend on the state of a window.

For example a scratchpad window maybe presented using the SchemeScratchNorm and SchemeScratchSel colour schemes, while a marked window will be presented using the SchemeMarked colour scheme.

Likewise hidden or urgent windows will be presented with designated colour schemes.

When it comes to normal windows these will by default be presented using the SchemeTitleNorm and SchemeTitleSel colour schemes.

If the FlexWinBorders functionality, however, is enabled then the SchemeFlex* colour schemes will be used to present both window titles as well as the border colours of windows.

The way it works is that client windows will be represented by designated colour schemes for the particular arrangement they are subject to.

For example let's say that we have a master and a stack area where clients in the master area are tiled left to right (vertically) while the clients in the stack area are tiled top to bottom (horizontally).

Clients in the master area will then be drawn using SchemeFlexInaLTR and clients in the stack area will be drawn using SchemeFlexInaTTB.

Additionally if there are, say, three clients in the stack area and one of them is the selected client then the selected client will be drawn using SchemeFlexSelTTB. As focus is on the stack area the other two clients are then drawn using the SchemeFlexActTTB (as in the stack area is active). This allows for effects like having the master and stack areas light up when focus is moved between them.

Below is a breakdown of the many SchemeFlex* colour schemes that are available. These are not explicitly listed in the colors array in the default configuration, but they can be controlled using Xresource strings.

Also refer to the Xresources page.

Back to Bar > Bar Modules.