A WindowSpace whose tags are VirtualWorkspaces.

A WindowSpace whose tags are PhysicalWorkspaces.

Get a list of all the virtual workspace names.

Specify workspace names for each screen

Make all workspaces across the monitors bear the same names

Transform a function over physical workspaces into a function over virtual workspaces. This is useful as it allows you to write code without caring about the current screen, i.e. to say "switch to workspace 3" rather than saying "switch to workspace 3 on monitor 3".

This turns a pretty-printer into one that is aware of the independent screens. The converted pretty-printer first filters out physical workspaces on other screens, then converts all the physical workspaces on this screen to their virtual names. Note that ppSort still operates on physical (marshalled) workspace names, otherwise functions from XMonad.Util.WorkspaceCompare wouldn't work. If you need to sort on virtual names, see marshallSort.

For example, if you have have two bars on the left and right screens, respectively, and pp is a pretty-printer, you could apply marshallPP when creating a StatusBarConfig from XMonad.Hooks.StatusBar.

A sample config looks like this:

mySBL = statusBarProp "xmobar" $ pure (marshallPP (S 0) pp)
mySBR = statusBarProp "xmobar" $ pure (marshallPP (S 1) pp)
main = xmonad $ withEasySB (mySBL <> mySBR) defToggleStrutsKey def

Take a pretty-printer and turn it into one that only runs when the current workspace is one associated with the given screen. The way this works is a bit hacky, so beware: the ppOutput field of the input will not be invoked if either of the following conditions is met:

1. The ppSort of the input returns an empty list (when not given one).
2. The ppOrder of the input returns the exact string "\0".

For example, you can use this to create a pipe which tracks the title of the window currently focused on a given screen (even if the screen is not current) by doing something like this:

ppFocus s = whenCurrentOn s def
    { ppOrder  = \(_:_:title:_) -> [title]
    , ppOutput = appendFile ("focus" ++ show s) . (++ "\n")
    }

Sequence a few of these pretty-printers to get a log hook that keeps each screen's title up-to-date.

In case you don't know statically how many screens there will be, you can call this in main before starting xmonad. For example, part of my config reads

main = do
  nScreens <- countScreens
  xmonad $ def {
    ...
    workspaces = withScreens nScreens (workspaces def),
    ...
    }

Filter workspaces that are on a given screen.

Get the workspace currently active on a given screen

Focus a window, switching workspace on the correct Xinerama screen if neccessary.

Focus a given screen.

Get the nth virtual workspace

Generate WindowSet transformation by providing a given function with the workspace active on a given screen. This may for example be used to shift a window to another screen as follows:

windows $ withWspOnScreen 1 W.shift

Convert the tag of the WindowSpace from a VirtualWorkspace to a PhysicalWorkspace.

Convert the tag of the WindowSpace from a PhysicalWorkspace to a VirtualWorkspace.

vSort is a function that sorts VirtualWindowSpaces with virtual names. marshallSort s vSort is a function which sorts PhysicalWindowSpaces with virtual names, but keeps only the WindowSpace's on screen s.

NOTE: vSort operating on virtual names comes with some caveats, see this issue for more information. You can use marshallSort like in the following example:

Example

pp' :: ScreenId -> PP -> PP
pp' s pp = (marshallPP s pp) { ppSort = fmap (marshallSort s) (ppSort pp) }

mySBL = statusBarProp "xmobar" $ pure (pp' (S 0) pp)
mySBR = statusBarProp "xmobar" $ pure (pp' (S 1) pp)
main = xmonad $ withEasySB (mySBL <> mySBR) defToggleStrutsKey def