Skip to content
Find file
Fetching contributors…
Cannot retrieve contributors at this time
48 lines (33 sloc) 1.01 KB


This is a library which allows XMonad to manage Mac OS X windows.


  • Only attached hook is layoutHook
  • No workspaces
  • No borders
  • No focusFollowsMouse


We need XMonad's compilation step to include the -framework Cocoa flag to GHC. This repository includes a xmonad.patch (1 line diff) that you must apply to the XMonad source:

git clone git://
darcs get
cd xmonad
darcs apply ../osxmonad/xmonad.patch
cabal configure
cabal install
cd ../osxmonad
cabal configure
cabal install

Note: Mountain Lion users will have to download and install XQuartx.


Create ~/.xmonad/xmonad.hs:

import XMonad
import OSXMonad.Core

main = osxmonad defaultConfig {
         modMask = mod1Mask .|. mod4Mask,
         keys = osxKeys

Now we can run xmonad to have our windows managed.



Jump to Line
Something went wrong with that request. Please try again.