XMonad.Actions.WindowNavigation

This is a rewrite of XMonad.Layout.WindowNavigation. WindowNavigation lets you assign keys to move up/down/left/right, based on actual cartesian window coordinates, rather than just going j/k on the stack.

This module is experimental. You'll have better luck with the original.

This module differs from the other in a few ways:

1. You can go up/down/left/right across multiple screens.
2. It doesn't provide little border colors for your neighboring windows.
3. It doesn't provide the 'Move' action, which seems to be related to the XMonad.Layout.Combo extension.
4. It tries to be slightly smarter about tracking your current position.
5. Configuration is different.

Usage

To use it, you're going to apply the withWindowNavigation function. withWindowNavigation performs some IO operations, so the syntax you'll use is the same as the spawnPipe example in XMonad.Hooks.DynamicLog. In particular:

main = do
    config <- withWindowNavigation (xK_w, xK_a, xK_s, xK_d)
            $ def { ... }
    xmonad config

Or, for the brave souls:

main = xmonad =<< withWindowNavigation (xK_w, xK_a, xK_s, xK_d)
            $ def { ... }

Here, we pass in the keys for navigation in counter-clockwise order from up. It creates keybindings for modMask to move to window, and modMask .|. shiftMask to swap windows.

If you want more flexibility over your keybindings, you can use withWindowNavigationKeys, which takes a list of keys-esque entries rather than a tuple of the four directional keys. See the source code of withWindowNavigation for an example.

withWindowNavigation :: forall (l :: Type -> Type). (KeySym, KeySym, KeySym, KeySym) -> XConfig l -> IO (XConfig l)

withWindowNavigationKeys :: forall (l :: Type -> Type). [((KeyMask, KeySym), WNAction)] -> XConfig l -> IO (XConfig l)

data WNAction

Constructors

WNGo Direction2D

WNSwap Direction2D

go :: IORef WNState -> Direction2D -> X ()

swap :: IORef WNState -> Direction2D -> X ()

data Direction2D

Two-dimensional directions:

Constructors

U

Up

D

Down

R

Right

L

Left

Instances

Bounded Direction2D

Defined in XMonad.Util.Types

Methods

minBound :: Direction2D

maxBound :: Direction2D

Enum Direction2D

Defined in XMonad.Util.Types

Methods

succ :: Direction2D -> Direction2D

pred :: Direction2D -> Direction2D

toEnum :: Int -> Direction2D

fromEnum :: Direction2D -> Int

enumFrom :: Direction2D -> [Direction2D]

enumFromThen :: Direction2D -> Direction2D -> [Direction2D]

enumFromTo :: Direction2D -> Direction2D -> [Direction2D]

enumFromThenTo :: Direction2D -> Direction2D -> Direction2D -> [Direction2D]

Read Direction2D

Defined in XMonad.Util.Types

Methods

readsPrec :: Int -> ReadS Direction2D

readList :: ReadS [Direction2D]

readPrec :: ReadPrec Direction2D

readListPrec :: ReadPrec [Direction2D]

Show Direction2D

Defined in XMonad.Util.Types

Methods

showsPrec :: Int -> Direction2D -> ShowS

show :: Direction2D -> String

showList :: [Direction2D] -> ShowS

Eq Direction2D

Defined in XMonad.Util.Types

Methods

(==) :: Direction2D -> Direction2D -> Bool

(/=) :: Direction2D -> Direction2D -> Bool

Ord Direction2D

Defined in XMonad.Util.Types

Methods

compare :: Direction2D -> Direction2D -> Ordering

(<) :: Direction2D -> Direction2D -> Bool

(<=) :: Direction2D -> Direction2D -> Bool

(>) :: Direction2D -> Direction2D -> Bool

(>=) :: Direction2D -> Direction2D -> Bool

max :: Direction2D -> Direction2D -> Direction2D

min :: Direction2D -> Direction2D -> Direction2D

type WNState = Map WorkspaceId Point