Xmonad/Config archive/Template xmonad.hs (darcs)
From HaskellWiki
< Xmonad | Config archive(Difference between revisions)
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 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 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 = | + | myKeys conf@(XConfig {XMonad.modMask = modm}) = M.fromList $ |
-- launch a terminal | -- launch a terminal | ||
| - | [ (( | + | [ ((modm .|. shiftMask, xK_Return), spawn $ XMonad.terminal conf) |
-- launch dmenu | -- launch dmenu | ||
| - | , (( | + | , ((modm, xK_p ), spawn "exe=`dmenu_path | dmenu` && eval \"exec $exe\"") |
-- launch gmrun | -- launch gmrun | ||
| - | , (( | + | , ((modm .|. shiftMask, xK_p ), spawn "gmrun") |
| - | -- close focused window | + | -- close focused window |
| - | , (( | + | , ((modm .|. shiftMask, xK_c ), kill) |
-- Rotate through the available layout algorithms | -- Rotate through the available layout algorithms | ||
| - | , (( | + | , ((modm, xK_space ), sendMessage NextLayout) |
-- Reset the layouts on the current workspace to default | -- Reset the layouts on the current workspace to default | ||
| - | , (( | + | , ((modm .|. shiftMask, xK_space ), setLayout $ XMonad.layoutHook conf) |
-- Resize viewed windows to the correct size | -- Resize viewed windows to the correct size | ||
| - | , (( | + | , ((modm, xK_n ), refresh) |
-- Move focus to the next window | -- Move focus to the next window | ||
| - | , (( | + | , ((modm, xK_Tab ), windows W.focusDown) |
-- Move focus to the next window | -- Move focus to the next window | ||
| - | , (( | + | , ((modm, xK_j ), windows W.focusDown) |
-- Move focus to the previous window | -- Move focus to the previous window | ||
| - | , (( | + | , ((modm, xK_k ), windows W.focusUp ) |
-- Move focus to the master window | -- Move focus to the master window | ||
| - | , (( | + | , ((modm, xK_m ), windows W.focusMaster ) |
-- Swap the focused window and the master window | -- Swap the focused window and the master window | ||
| - | , (( | + | , ((modm, xK_Return), windows W.swapMaster) |
-- Swap the focused window with the next window | -- Swap the focused window with the next window | ||
| - | , (( | + | , ((modm .|. shiftMask, xK_j ), windows W.swapDown ) |
-- Swap the focused window with the previous window | -- Swap the focused window with the previous window | ||
| - | , (( | + | , ((modm .|. shiftMask, xK_k ), windows W.swapUp ) |
-- Shrink the master area | -- Shrink the master area | ||
| - | , (( | + | , ((modm, xK_h ), sendMessage Shrink) |
-- Expand the master area | -- Expand the master area | ||
| - | , (( | + | , ((modm, xK_l ), sendMessage Expand) |
-- Push window back into tiling | -- Push window back into tiling | ||
| - | , (( | + | , ((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 | ||
| - | , (( | + | , ((modm , xK_comma ), sendMessage (IncMasterN 1)) |
-- Deincrement the number of windows in the master area | -- 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 | -- Quit xmonad | ||
| - | , (( | + | , ((modm .|. shiftMask, xK_q ), io (exitWith ExitSuccess)) |
-- Restart xmonad | -- 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-[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 .|. | + | [((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 .|. | + | [((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 = | + | 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 | ||
| - | [ (( | + | [ ((modm, button1), (\w -> focus w >> mouseMoveWindow w |
| - | + | >> 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 | ||
| - | , (( | + | , ((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 | ||
| - | , (( | + | , ((modm, button3), (\w -> focus w >> mouseResizeWindow w |
| - | + | >> 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 | |
| - | + | 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 | |
------------------------------------------------------------------------ | ------------------------------------------------------------------------ | ||
| Line 223: | Line 220: | ||
------------------------------------------------------------------------ | ------------------------------------------------------------------------ | ||
| - | -- Event handling | + | -- Event handling |
| - | + | ||
| - | + | ||
| - | + | ||
-- 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 | + | -- combine event hooks use mappend or mconcat from Data.Monoid. |
| - | -- | + | -- |
| - | myEventHook = | + | -- * 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 | ||
------------------------------------------------------------------------ | ------------------------------------------------------------------------ | ||
| 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. |
| - | + | ||
| - | + | ||
-- | -- | ||
| - | -- | + | -- * 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 () | 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, | ||
| - | |||
workspaces = myWorkspaces, | workspaces = myWorkspaces, | ||
normalBorderColor = myNormalBorderColor, | normalBorderColor = myNormalBorderColor, | ||
Current revision
-- -- 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 }
