Monitor - bakkeby/dusk GitHub Wiki

The Monitor topic is specifically about different displays / screens / monitors.

For a general definition of what a monitor is in the context of the window manager refer to the Concepts page.

Multi-monitor

The window manager is configured to use the Xinerama libraries in config.mk and can automatically detect configured screen outputs and their resolutions.

One of the easiest ways to configure screen outputs is via the RandR X server extension using the xrandr tool.

Without arguments it will list the current configuration of screen outputs.

$ xrandr

For each connected output the supported resolution modes will be printed.

Alternatively for a graphical tool to arrange monitors the arandr will produce xrandr commands.

The xrandr commands can later be put in shell scripts so that the multi-monitor layout can be restored when the computer starts. Refer to the autostart page for more information.

List of functions that are specific to multi-monitor setups.

Function Description
focusmon Changes which monitor has focus
clienttomon Move the selected window to an adjacent monitor
clientstomon Move all windows on the current workspace to an adjacent monitor

In a single monitor setup these functions are redundant.

In a dual monitor setup the direction is irrelevant as the monitors will wrap around.

In a 3+ monitor setup these may or may not work as you might expect.

In terms of arguments in principle a positive value is intended to select the monitor on the right and a negative argument is intended to select the monitor on the left.

It is worth noting that this works based on the monitor index.

That is, if the current monitor index is 1 then:

  • a negative value (going left) will bring you to monitor index 0 and
  • a positive value (going right) will bring you to monitor index 2

It is also worth noting that when using a Xinerama setup the order in which the screens are returned depends on a few things, but typically the monitor marked as being the primary will be returned first ending up as monitor 0. This also means that any subsequent monitors will end up as monitor 1 and 2.

If the direction is reversed for you then flipping the + and - signs for the keybindings may help.

Alternatively you should be able to influence the order in which the monitors are returned by Xinerama by making changes to the xrandr command that sets up the screens.

Another options would be to enable the SortScreens functionality which sorts the monitors left to right before assigning indexes. This has an impact on bar configuration and workspace rules, however, as monitor 0 will be the leftmost monitor rather than the primary.

Functions

Here is a list of functions relating to the monitor.

Function Description
clienttomon Move the selected window to an adjacent monitor
clientstomon Move all windows on the current workspace to an adjacent monitor
focusmon Changes which monitor has focus
togglebar Toggles the display of the bar on and off for the current monitor
togglepinnedws Used to pin or unpin the current workspace to / from the current monitor
viewallwsonmon View all workspaces assigned to the current monitor
viewalloccwsonmon View all workspaces assigned to the current monitor that have clients

Functionality

Here is a list of functionality that is related to the monitor.

Functionality Description
GreedyMonitor Disables swap of workspaces between monitors
RestrictFocusstackToMonitor Option to restrict focusstack to only operate within the monitor
SmartLayoutConvertion Automatically adjust layout based on monitor orientation when moving a workspace from one monitor to another
SortScreens Monitors are numbered from left to right

Flags

Here is a list of flags that related to the monitor.

Flag Description
ScratchpadStayOnMon Prevents the scratchpad from being moved to the active monitor when toggled

Back to Features.

⚠️ **GitHub.com Fallback** ⚠️