XMonad.Layout.FixedAspectRatio

Layout modifier for user provided per-window aspect ratios.

Usage

You can use this module with the following in your ~/.xmonad/xmonad.hs:

import XMonad.Layout.FixedAspectRatio

Then add it to your layout:

myLayout = fixedAspectRatio (0.5, 0.5) $ Tall 1 (3/100) (1/2)  ||| Full ||| etc..
main = xmonad def { layoutHook = myLayout }

Which will center the (eventually) shrinked windows in their assigned rectangle.

For a layout modifier that automatically sets the aspect ratio depending on the size hints (for example for programs like mpv), see XMonad.Layout.LayoutHints

See XMonad.Doc.Extending for more info on the layoutHook.

You also want to add keybindings to set and clear the aspect ratio:

     -- Set the aspect ratio of the focused window to 16:9
  ,((modm, xK_a), withFocused $ sendMessage . FixRatio (16 / 9))

     -- Clear the aspect ratio from the focused window
  ,((modm .|. shiftMask, xK_a), withFocused $ sendMessage . ResetRatio)

There's one caveat: to keep the usage of the modifier simple, it doesn't remove a window from its cache automatically. Which means that if you close a program window that has some fixed aspect ratios and relaunch it, sometimes it'll still have the fixed aspect ratio. You can try to avoid this by changing they keybinding used to kill the window:

 , ((modMask .|. shiftMask, xK_c), withFocused (sendMessage . ResetRatio) >> kill)

See XMonad.Doc.Extending for more info on customizing the keybindings.

This layout also comes with a ManageHook doFixAspect to automatically fix the aspect ratio:

myManageHook = composeOne [
  title =? "Netflix" <||> className =? "vlc" --> doFixAspect (16 / 9)
  ...
]

Check XMonad.Doc.Extending for more information on customizing the manage hook.

fixedAspectRatio :: (Double, Double) -> l a -> ModifiedLayout FixedAspectRatio l a

Similar to layoutHintsWithReplacement, but relies on the user to provide the ratio for each window. aspectRatio (rx, ry) layout will adapt the sizes of a layout's windows according to the provided aspect ratio, and position them inside their originally assigned area according to the rx and ry parameters. (0, 0) places the window at the top left, (1, 0) at the top right, (0.5, 0.5) at the center, etc.

data FixedAspectRatio a

Instances

LayoutModifier FixedAspectRatio Window

Defined in XMonad.Layout.FixedAspectRatio

Methods

modifyLayout :: LayoutClass l Window => FixedAspectRatio Window -> Workspace WorkspaceId (l Window) Window -> Rectangle -> X ([(Window, Rectangle)], Maybe (l Window))

modifyLayoutWithUpdate :: LayoutClass l Window => FixedAspectRatio Window -> Workspace WorkspaceId (l Window) Window -> Rectangle -> X (([(Window, Rectangle)], Maybe (l Window)), Maybe (FixedAspectRatio Window))

handleMess :: FixedAspectRatio Window -> SomeMessage -> X (Maybe (FixedAspectRatio Window))

handleMessOrMaybeModifyIt :: FixedAspectRatio Window -> SomeMessage -> X (Maybe (Either (FixedAspectRatio Window) SomeMessage))

pureMess :: FixedAspectRatio Window -> SomeMessage -> Maybe (FixedAspectRatio Window)

redoLayout :: FixedAspectRatio Window -> Rectangle -> Maybe (Stack Window) -> [(Window, Rectangle)] -> X ([(Window, Rectangle)], Maybe (FixedAspectRatio Window))

pureModifier :: FixedAspectRatio Window -> Rectangle -> Maybe (Stack Window) -> [(Window, Rectangle)] -> ([(Window, Rectangle)], Maybe (FixedAspectRatio Window))

hook :: FixedAspectRatio Window -> X ()

unhook :: FixedAspectRatio Window -> X ()

modifierDescription :: FixedAspectRatio Window -> String

modifyDescription :: LayoutClass l Window => FixedAspectRatio Window -> l Window -> String

Read (FixedAspectRatio a)

Defined in XMonad.Layout.FixedAspectRatio

Methods

readsPrec :: Int -> ReadS (FixedAspectRatio a)

readList :: ReadS [FixedAspectRatio a]

readPrec :: ReadPrec (FixedAspectRatio a)

readListPrec :: ReadPrec [FixedAspectRatio a]

Show (FixedAspectRatio a)

Defined in XMonad.Layout.FixedAspectRatio

Methods

showsPrec :: Int -> FixedAspectRatio a -> ShowS

show :: FixedAspectRatio a -> String

showList :: [FixedAspectRatio a] -> ShowS

data ManageAspectRatio

Constructors

FixRatio Rational Window

Set the aspect ratio for the window

ResetRatio Window

Remove the aspect ratio for the window

ToggleRatio Rational Window

Toggle the reatio

Instances

Message ManageAspectRatio

Defined in XMonad.Layout.FixedAspectRatio

doFixAspect

Arguments

:: Rational

The aspect ratio

-> ManageHook

A ManageHook to set the aspect ratio for newly spawned windows