Difference between revisions of "Xmonad/Config archive/Template xmonad.hs (darcs)"

From HaskellWiki
Jump to navigation Jump to search
m (Event Hook: return (All True) instead of True)
(oops, remove rather than use deprecation warning in darcs template. was editing wrong version)
(8 intermediate revisions by the same user not shown)
Line 10: Line 10:
   
 
import XMonad
 
import XMonad
  +
import Data.Monoid
 
import System.Exit
 
import System.Exit
   
Line 34: Line 35:
 
--
 
--
 
myModMask = mod1Mask
 
myModMask = mod1Mask
 
-- The mask for the numlock key. Numlock status is "masked" from the
 
-- current modifier status, so the keybindings will work with numlock on or
 
-- off. You may need to change this on some systems.
 
--
 
-- You can find the numlock modifier by running "xmodmap" and looking for a
 
-- modifier with Num_Lock bound to it:
 
--
 
-- > $ xmodmap | grep Num
 
-- > mod2 Num_Lock (0x4d)
 
--
 
-- Set numlockMask = 0 if you don't have a numlock key, or want to treat
 
-- numlock status separately.
 
--
 
myNumlockMask = mod2Mask
 
   
 
-- The default number of workspaces (virtual screens) and their names.
 
-- The default number of workspaces (virtual screens) and their names.
Line 69: Line 55:
 
-- Key bindings. Add, modify or remove key bindings here.
 
-- Key bindings. Add, modify or remove key bindings here.
 
--
 
--
myKeys conf@(XConfig {XMonad.modMask = modMask}) = M.fromList $
+
myKeys conf@(XConfig {XMonad.modMask = modm}) = M.fromList $
   
 
-- launch a terminal
 
-- launch a terminal
[ ((modMask .|. shiftMask, xK_Return), spawn $ XMonad.terminal conf)
+
[ ((modm .|. shiftMask, xK_Return), spawn $ XMonad.terminal conf)
   
 
-- launch dmenu
 
-- launch dmenu
, ((modMask, xK_p ), spawn "exe=`dmenu_path | dmenu` && eval \"exec $exe\"")
+
, ((modm, xK_p ), spawn "exe=`dmenu_path | dmenu` && eval \"exec $exe\"")
   
 
-- launch gmrun
 
-- launch gmrun
, ((modMask .|. shiftMask, xK_p ), spawn "gmrun")
+
, ((modm .|. shiftMask, xK_p ), spawn "gmrun")
   
-- close focused window
+
-- close focused window
, ((modMask .|. shiftMask, xK_c ), kill)
+
, ((modm .|. shiftMask, xK_c ), kill)
   
 
-- Rotate through the available layout algorithms
 
-- Rotate through the available layout algorithms
, ((modMask, xK_space ), sendMessage NextLayout)
+
, ((modm, xK_space ), sendMessage NextLayout)
   
 
-- Reset the layouts on the current workspace to default
 
-- Reset the layouts on the current workspace to default
, ((modMask .|. shiftMask, xK_space ), setLayout $ XMonad.layoutHook conf)
+
, ((modm .|. shiftMask, xK_space ), setLayout $ XMonad.layoutHook conf)
   
 
-- Resize viewed windows to the correct size
 
-- Resize viewed windows to the correct size
, ((modMask, xK_n ), refresh)
+
, ((modm, xK_n ), refresh)
   
 
-- Move focus to the next window
 
-- Move focus to the next window
, ((modMask, xK_Tab ), windows W.focusDown)
+
, ((modm, xK_Tab ), windows W.focusDown)
   
 
-- Move focus to the next window
 
-- Move focus to the next window
, ((modMask, xK_j ), windows W.focusDown)
+
, ((modm, xK_j ), windows W.focusDown)
   
 
-- Move focus to the previous window
 
-- Move focus to the previous window
, ((modMask, xK_k ), windows W.focusUp )
+
, ((modm, xK_k ), windows W.focusUp )
   
 
-- Move focus to the master window
 
-- Move focus to the master window
, ((modMask, xK_m ), windows W.focusMaster )
+
, ((modm, xK_m ), windows W.focusMaster )
   
 
-- Swap the focused window and the master window
 
-- Swap the focused window and the master window
, ((modMask, xK_Return), windows W.swapMaster)
+
, ((modm, xK_Return), windows W.swapMaster)
   
 
-- Swap the focused window with the next window
 
-- Swap the focused window with the next window
, ((modMask .|. shiftMask, xK_j ), windows W.swapDown )
+
, ((modm .|. shiftMask, xK_j ), windows W.swapDown )
   
 
-- Swap the focused window with the previous window
 
-- Swap the focused window with the previous window
, ((modMask .|. shiftMask, xK_k ), windows W.swapUp )
+
, ((modm .|. shiftMask, xK_k ), windows W.swapUp )
   
 
-- Shrink the master area
 
-- Shrink the master area
, ((modMask, xK_h ), sendMessage Shrink)
+
, ((modm, xK_h ), sendMessage Shrink)
   
 
-- Expand the master area
 
-- Expand the master area
, ((modMask, xK_l ), sendMessage Expand)
+
, ((modm, xK_l ), sendMessage Expand)
   
 
-- Push window back into tiling
 
-- Push window back into tiling
, ((modMask, xK_t ), withFocused $ windows . W.sink)
+
, ((modm, xK_t ), withFocused $ windows . W.sink)
   
 
-- Increment the number of windows in the master area
 
-- Increment the number of windows in the master area
, ((modMask , xK_comma ), sendMessage (IncMasterN 1))
+
, ((modm , xK_comma ), sendMessage (IncMasterN 1))
   
 
-- Deincrement the number of windows in the master area
 
-- Deincrement the number of windows in the master area
, ((modMask , xK_period), sendMessage (IncMasterN (-1)))
+
, ((modm , xK_period), sendMessage (IncMasterN (-1)))
   
-- toggle the status bar gap
+
-- Toggle the status bar gap
-- TODO, update this binding with avoidStruts , ((modMask , xK_b ),
+
-- Use this binding with avoidStruts from Hooks.ManageDocks.
  +
-- See also the statusBar function from Hooks.DynamicLog.
  +
--
  +
-- , ((modm , xK_b ), sendMessage ToggleStruts)
   
 
-- Quit xmonad
 
-- Quit xmonad
, ((modMask .|. shiftMask, xK_q ), io (exitWith ExitSuccess))
+
, ((modm .|. shiftMask, xK_q ), io (exitWith ExitSuccess))
   
 
-- Restart xmonad
 
-- Restart xmonad
, ((modMask , xK_q ), restart "xmonad" True)
+
, ((modm , xK_q ), spawn "xmonad --recompile; xmonad --restart")
 
]
 
]
 
++
 
++
   
  +
--
  +
-- mod-[1..9], Switch to workspace N
 
--
 
--
 
-- mod-[1..9], Switch to workspace N
 
-- mod-[1..9], Switch to workspace N
 
-- mod-shift-[1..9], Move client to workspace N
 
-- mod-shift-[1..9], Move client to workspace N
 
--
 
--
[((m .|. modMask, k), windows $ f i)
+
[((m .|. modm, k), windows $ f i)
 
| (i, k) <- zip (XMonad.workspaces conf) [xK_1 .. xK_9]
 
| (i, k) <- zip (XMonad.workspaces conf) [xK_1 .. xK_9]
 
, (f, m) <- [(W.greedyView, 0), (W.shift, shiftMask)]]
 
, (f, m) <- [(W.greedyView, 0), (W.shift, shiftMask)]]
Line 152: Line 143:
 
-- mod-shift-{w,e,r}, Move client to screen 1, 2, or 3
 
-- mod-shift-{w,e,r}, Move client to screen 1, 2, or 3
 
--
 
--
[((m .|. modMask, key), screenWorkspace sc >>= flip whenJust (windows . f))
+
[((m .|. modm, key), screenWorkspace sc >>= flip whenJust (windows . f))
 
| (key, sc) <- zip [xK_w, xK_e, xK_r] [0..]
 
| (key, sc) <- zip [xK_w, xK_e, xK_r] [0..]
 
, (f, m) <- [(W.view, 0), (W.shift, shiftMask)]]
 
, (f, m) <- [(W.view, 0), (W.shift, shiftMask)]]
Line 160: Line 151:
 
-- Mouse bindings: default actions bound to mouse events
 
-- Mouse bindings: default actions bound to mouse events
 
--
 
--
myMouseBindings (XConfig {XMonad.modMask = modMask}) = M.fromList $
+
myMouseBindings (XConfig {XMonad.modMask = modm}) = M.fromList $
   
 
-- mod-button1, Set the window to floating mode and move by dragging
 
-- mod-button1, Set the window to floating mode and move by dragging
[ ((modMask, button1), (\w -> focus w >> mouseMoveWindow w
+
[ ((modm, button1), (\w -> focus w >> mouseMoveWindow w
>> windows W.shiftMaster))
+
>> windows W.shiftMaster))
   
 
-- mod-button2, Raise the window to the top of the stack
 
-- mod-button2, Raise the window to the top of the stack
, ((modMask, button2), (\w -> focus w >> windows W.shiftMaster))
+
, ((modm, button2), (\w -> focus w >> windows W.shiftMaster))
   
 
-- mod-button3, Set the window to floating mode and resize by dragging
 
-- mod-button3, Set the window to floating mode and resize by dragging
, ((modMask, button3), (\w -> focus w >> mouseResizeWindow w
+
, ((modm, button3), (\w -> focus w >> mouseResizeWindow w
>> windows W.shiftMaster))
+
>> windows W.shiftMaster))
   
 
-- you may also bind events to the mouse scroll wheel (button4 and button5)
 
-- you may also bind events to the mouse scroll wheel (button4 and button5)
Line 183: Line 174:
 
-- restarting (with 'mod-q') to reset your layout state to the new
 
-- restarting (with 'mod-q') to reset your layout state to the new
 
-- defaults, as xmonad preserves your old layout settings by default.
 
-- defaults, as xmonad preserves your old layout settings by default.
 
--
  +
-- * NOTE: XMonad.Hooks.EwmhDesktops users must remove the obsolete
  +
-- ewmhDesktopsLayout modifier from layoutHook. It no longer exists.
  +
-- Instead use the 'ewmh' function from that module to modify your
  +
-- defaultConfig as a whole. (See also logHook, handleEventHook, and
  +
-- startupHook ewmh notes.)
 
--
 
--
 
-- The available layouts. Note that each layout is separated by |||,
 
-- The available layouts. Note that each layout is separated by |||,
Line 189: Line 186:
 
myLayout = tiled ||| Mirror tiled ||| Full
 
myLayout = tiled ||| Mirror tiled ||| Full
 
where
 
where
-- default tiling algorithm partitions the screen into two panes
+
-- default tiling algorithm partitions the screen into two panes
tiled = Tall nmaster delta ratio
+
tiled = Tall nmaster delta ratio
   
-- The default number of windows in the master pane
+
-- The default number of windows in the master pane
nmaster = 1
+
nmaster = 1
   
-- Default proportion of screen occupied by master pane
+
-- Default proportion of screen occupied by master pane
ratio = 1/2
+
ratio = 1/2
   
-- Percent of screen to increment by when resizing panes
+
-- Percent of screen to increment by when resizing panes
delta = 3/100
+
delta = 3/100
   
 
------------------------------------------------------------------------
 
------------------------------------------------------------------------
Line 223: Line 220:
   
 
------------------------------------------------------------------------
 
------------------------------------------------------------------------
-- Event handling:
+
-- Event handling
  +
 
-- * EwmhDesktops users should change this to ewmhDesktopsEventHook
 
--
 
 
-- Defines a custom handler function for X Events. The function should
 
-- Defines a custom handler function for X Events. The function should
-- return (All True) if the default handler is to be run afterwards. To
+
-- return (All True) if the default handler is to be run afterwards. To
-- combine Event Hooks use mappend or mconcat from Data.Monoid.
+
-- combine event hooks use mappend or mconcat from Data.Monoid.
 
--
--
 
 
-- * NOTE: EwmhDesktops users should use the 'ewmh' function from
myEventHook = handleEventHook
 
  +
-- XMonad.Hooks.EwmhDesktops to modify their defaultConfig as a whole.
  +
-- It will add EWMH event handling to your custom event hooks by
  +
-- combining them with ewmhDesktopsEventHook.
 
--
 
myEventHook = mempty
   
 
------------------------------------------------------------------------
 
------------------------------------------------------------------------
Line 237: Line 237:
   
 
-- Perform an arbitrary action on each internal state change or X event.
 
-- Perform an arbitrary action on each internal state change or X event.
-- See the 'DynamicLog' extension for examples.
+
-- See the 'XMonad.Hooks.DynamicLog' extension for examples.
--
 
-- To emulate dwm's status bar
 
 
--
 
--
  +
-- * NOTE: EwmhDesktops users should use the 'ewmh' function from
-- > logHook = dynamicLogDzen
 
  +
-- XMonad.Hooks.EwmhDesktops to modify their defaultConfig as a whole.
  +
-- It will add EWMH logHook actions to your custom log hook by
  +
-- combining it with ewmhDesktopsLogHook.
 
--
 
--
 
myLogHook = return ()
 
myLogHook = return ()
Line 253: Line 254:
 
--
 
--
 
-- By default, do nothing.
 
-- By default, do nothing.
 
--
  +
-- * NOTE: EwmhDesktops users should use the 'ewmh' function from
  +
-- XMonad.Hooks.EwmhDesktops to modify their defaultConfig as a whole.
  +
-- It will add initialization of EWMH support to your custom startup
  +
-- hook by combining it with ewmhDesktopsStartup.
 
--
 
myStartupHook = return ()
 
myStartupHook = return ()
   
Line 263: Line 270:
   
 
-- A structure containing your configuration settings, overriding
 
-- A structure containing your configuration settings, overriding
-- fields in the default config. Any you don't override, will
+
-- fields in the default config. Any you don't override, will
 
-- use the defaults defined in xmonad/XMonad/Config.hs
 
-- use the defaults defined in xmonad/XMonad/Config.hs
--
+
--
 
-- No need to modify this.
 
-- No need to modify this.
 
--
 
--
Line 274: Line 281:
 
borderWidth = myBorderWidth,
 
borderWidth = myBorderWidth,
 
modMask = myModMask,
 
modMask = myModMask,
numlockMask = myNumlockMask,
 
 
workspaces = myWorkspaces,
 
workspaces = myWorkspaces,
 
normalBorderColor = myNormalBorderColor,
 
normalBorderColor = myNormalBorderColor,

Revision as of 18:41, 17 December 2009

--
-- xmonad example config file.
--
-- A template showing all available configuration hooks,
-- and how to override the defaults in your own xmonad.hs conf file.
--
-- Normally, you'd only override those defaults you care about.
--

import XMonad
import Data.Monoid
import System.Exit

import qualified XMonad.StackSet as W
import qualified Data.Map        as M

-- The preferred terminal program, which is used in a binding below and by
-- certain contrib modules.
--
myTerminal      = "xterm"

-- Whether focus follows the mouse pointer.
myFocusFollowsMouse :: Bool
myFocusFollowsMouse = True

-- Width of the window border in pixels.
--
myBorderWidth   = 1

-- modMask lets you specify which modkey you want to use. The default
-- is mod1Mask ("left alt").  You may also consider using mod3Mask
-- ("right alt"), which does not conflict with emacs keybindings. The
-- "windows key" is usually mod4Mask.
--
myModMask       = mod1Mask

-- The default number of workspaces (virtual screens) and their names.
-- By default we use numeric strings, but any string may be used as a
-- workspace name. The number of workspaces is determined by the length
-- of this list.
--
-- A tagging example:
--
-- > workspaces = ["web", "irc", "code" ] ++ map show [4..9]
--
myWorkspaces    = ["1","2","3","4","5","6","7","8","9"]

-- Border colors for unfocused and focused windows, respectively.
--
myNormalBorderColor  = "#dddddd"
myFocusedBorderColor = "#ff0000"

------------------------------------------------------------------------
-- Key bindings. Add, modify or remove key bindings here.
--
myKeys conf@(XConfig {XMonad.modMask = modm}) = M.fromList $

    -- launch a terminal
    [ ((modm .|. shiftMask, xK_Return), spawn $ XMonad.terminal conf)

    -- launch dmenu
    , ((modm,               xK_p     ), spawn "exe=`dmenu_path | dmenu` && eval \"exec $exe\"")

    -- launch gmrun
    , ((modm .|. shiftMask, xK_p     ), spawn "gmrun")

    -- close focused window
    , ((modm .|. shiftMask, xK_c     ), kill)

     -- Rotate through the available layout algorithms
    , ((modm,               xK_space ), sendMessage NextLayout)

    --  Reset the layouts on the current workspace to default
    , ((modm .|. shiftMask, xK_space ), setLayout $ XMonad.layoutHook conf)

    -- Resize viewed windows to the correct size
    , ((modm,               xK_n     ), refresh)

    -- Move focus to the next window
    , ((modm,               xK_Tab   ), windows W.focusDown)

    -- Move focus to the next window
    , ((modm,               xK_j     ), windows W.focusDown)

    -- Move focus to the previous window
    , ((modm,               xK_k     ), windows W.focusUp  )

    -- Move focus to the master window
    , ((modm,               xK_m     ), windows W.focusMaster  )

    -- Swap the focused window and the master window
    , ((modm,               xK_Return), windows W.swapMaster)

    -- Swap the focused window with the next window
    , ((modm .|. shiftMask, xK_j     ), windows W.swapDown  )

    -- Swap the focused window with the previous window
    , ((modm .|. shiftMask, xK_k     ), windows W.swapUp    )

    -- Shrink the master area
    , ((modm,               xK_h     ), sendMessage Shrink)

    -- Expand the master area
    , ((modm,               xK_l     ), sendMessage Expand)

    -- Push window back into tiling
    , ((modm,               xK_t     ), withFocused $ windows . W.sink)

    -- Increment the number of windows in the master area
    , ((modm              , xK_comma ), sendMessage (IncMasterN 1))

    -- Deincrement the number of windows in the master area
    , ((modm              , xK_period), sendMessage (IncMasterN (-1)))

    -- Toggle the status bar gap
    -- Use this binding with avoidStruts from Hooks.ManageDocks.
    -- See also the statusBar function from Hooks.DynamicLog.
    --
    -- , ((modm              , xK_b     ), sendMessage ToggleStruts)

    -- Quit xmonad
    , ((modm .|. shiftMask, xK_q     ), io (exitWith ExitSuccess))

    -- Restart xmonad
    , ((modm              , xK_q     ), spawn "xmonad --recompile; xmonad --restart")
    ]
    ++

    --
    -- mod-[1..9], Switch to workspace N
    --
    -- mod-[1..9], Switch to workspace N
    -- mod-shift-[1..9], Move client to workspace N
    --
    [((m .|. modm, k), windows $ f i)
        | (i, k) <- zip (XMonad.workspaces conf) [xK_1 .. xK_9]
        , (f, m) <- [(W.greedyView, 0), (W.shift, shiftMask)]]
    ++

    --
    -- mod-{w,e,r}, Switch to physical/Xinerama screens 1, 2, or 3
    -- mod-shift-{w,e,r}, Move client to screen 1, 2, or 3
    --
    [((m .|. modm, key), screenWorkspace sc >>= flip whenJust (windows . f))
        | (key, sc) <- zip [xK_w, xK_e, xK_r] [0..]
        , (f, m) <- [(W.view, 0), (W.shift, shiftMask)]]


------------------------------------------------------------------------
-- Mouse bindings: default actions bound to mouse events
--
myMouseBindings (XConfig {XMonad.modMask = modm}) = M.fromList $

    -- mod-button1, Set the window to floating mode and move by dragging
    [ ((modm, button1), (\w -> focus w >> mouseMoveWindow w
                                       >> windows W.shiftMaster))

    -- mod-button2, Raise the window to the top of the stack
    , ((modm, button2), (\w -> focus w >> windows W.shiftMaster))

    -- mod-button3, Set the window to floating mode and resize by dragging
    , ((modm, button3), (\w -> focus w >> mouseResizeWindow w
                                       >> windows W.shiftMaster))

    -- you may also bind events to the mouse scroll wheel (button4 and button5)
    ]

------------------------------------------------------------------------
-- Layouts:

-- You can specify and transform your layouts by modifying these values.
-- If you change layout bindings be sure to use 'mod-shift-space' after
-- restarting (with 'mod-q') to reset your layout state to the new
-- defaults, as xmonad preserves your old layout settings by default.
--
-- * NOTE: XMonad.Hooks.EwmhDesktops users must remove the obsolete
-- ewmhDesktopsLayout modifier from layoutHook. It no longer exists.
-- Instead use the 'ewmh' function from that module to modify your
-- defaultConfig as a whole. (See also logHook, handleEventHook, and
-- startupHook ewmh notes.)
--
-- The available layouts.  Note that each layout is separated by |||,
-- which denotes layout choice.
--
myLayout = tiled ||| Mirror tiled ||| Full
  where
    -- default tiling algorithm partitions the screen into two panes
    tiled   = Tall nmaster delta ratio

    -- The default number of windows in the master pane
    nmaster = 1

    -- Default proportion of screen occupied by master pane
    ratio   = 1/2

    -- Percent of screen to increment by when resizing panes
    delta   = 3/100

------------------------------------------------------------------------
-- Window rules:

-- Execute arbitrary actions and WindowSet manipulations when managing
-- a new window. You can use this to, for example, always float a
-- particular program, or have a client always appear on a particular
-- workspace.
--
-- To find the property name associated with a program, use
-- > xprop | grep WM_CLASS
-- and click on the client you're interested in.
--
-- To match on the WM_NAME, you can use 'title' in the same way that
-- 'className' and 'resource' are used below.
--
myManageHook = composeAll
    [ className =? "MPlayer"        --> doFloat
    , className =? "Gimp"           --> doFloat
    , resource  =? "desktop_window" --> doIgnore
    , resource  =? "kdesktop"       --> doIgnore ]

------------------------------------------------------------------------
-- Event handling

-- Defines a custom handler function for X Events. The function should
-- return (All True) if the default handler is to be run afterwards. To
-- combine event hooks use mappend or mconcat from Data.Monoid.
--
-- * NOTE: EwmhDesktops users should use the 'ewmh' function from
-- XMonad.Hooks.EwmhDesktops to modify their defaultConfig as a whole.
-- It will add EWMH event handling to your custom event hooks by
-- combining them with ewmhDesktopsEventHook.
--
myEventHook = mempty

------------------------------------------------------------------------
-- Status bars and logging

-- Perform an arbitrary action on each internal state change or X event.
-- See the 'XMonad.Hooks.DynamicLog' extension for examples.
--
-- * NOTE: EwmhDesktops users should use the 'ewmh' function from
-- XMonad.Hooks.EwmhDesktops to modify their defaultConfig as a whole.
-- It will add EWMH logHook actions to your custom log hook by
-- combining it with ewmhDesktopsLogHook.
--
myLogHook = return ()

------------------------------------------------------------------------
-- Startup hook

-- Perform an arbitrary action each time xmonad starts or is restarted
-- with mod-q.  Used by, e.g., XMonad.Layout.PerWorkspace to initialize
-- per-workspace layout choices.
--
-- By default, do nothing.
--
-- * NOTE: EwmhDesktops users should use the 'ewmh' function from
-- XMonad.Hooks.EwmhDesktops to modify their defaultConfig as a whole.
-- It will add initialization of EWMH support to your custom startup
-- hook by combining it with ewmhDesktopsStartup.
--
myStartupHook = return ()

------------------------------------------------------------------------
-- Now run xmonad with all the defaults we set up.

-- Run xmonad with the settings you specify. No need to modify this.
--
main = xmonad defaults

-- A structure containing your configuration settings, overriding
-- fields in the default config. Any you don't override, will
-- use the defaults defined in xmonad/XMonad/Config.hs
--
-- No need to modify this.
--
defaults = defaultConfig {
      -- simple stuff
        terminal           = myTerminal,
        focusFollowsMouse  = myFocusFollowsMouse,
        borderWidth        = myBorderWidth,
        modMask            = myModMask,
        workspaces         = myWorkspaces,
        normalBorderColor  = myNormalBorderColor,
        focusedBorderColor = myFocusedBorderColor,

      -- key bindings
        keys               = myKeys,
        mouseBindings      = myMouseBindings,

      -- hooks, layouts
        layoutHook         = myLayout,
        manageHook         = myManageHook,
        handleEventHook    = myEventHook,
        logHook            = myLogHook,
        startupHook        = myStartupHook
    }