Difference between revisions of "Xmonad/Config archive/Template xmonad.hs (darcs)"
< Xmonad | Config archive
Jump to navigation
Jump to search
m (rm extra indent) |
(correct field name) |
||
| (10 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
| + | If you want a good configuration to start from, it's quite simple. |
||
| − | <haskell> |
||
| − | -- |
||
| − | -- 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. |
||
| − | -- |
||
| + | A very basic configuration, which will work for things like simple terminals but not so well for many modern applications such as web browsers: |
||
| + | |||
| + | <pre> |
||
import XMonad |
import XMonad |
||
| − | import Data.Monoid |
||
| − | import System.Exit |
||
| + | main = xmonad defaultConfig |
||
| − | import qualified XMonad.StackSet as W |
||
| + | </pre> |
||
| − | import qualified Data.Map as M |
||
| + | A more modern and more easily customized, yet still minimal, configuration (requires xmonad-contrib). '''Use this config if you plan to run Chromium; recent versions do ''not'' work correctly if you do not have desktop support enabled!''' |
||
| − | -- The preferred terminal program, which is used in a binding below and by |
||
| − | -- certain contrib modules. |
||
| − | -- |
||
| − | myTerminal = "xterm" |
||
| + | <pre> |
||
| − | -- Whether focus follows the mouse pointer. |
||
| + | import XMonad |
||
| − | myFocusFollowsMouse :: Bool |
||
| + | import XMonad.Config.Desktop |
||
| − | myFocusFollowsMouse = True |
||
| + | baseConfig = desktopConfig |
||
| − | -- Width of the window border in pixels. |
||
| − | -- |
||
| − | myBorderWidth = 1 |
||
| + | main = xmonad baseConfig |
||
| − | -- modMask lets you specify which modkey you want to use. The default |
||
| + | </pre> |
||
| − | -- 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 |
||
| + | In this one, if you want to add things to various hooks (anything that ends with <code>Hook</code>, except <code>layoutHook</code> which is handled specially), you should prepend <code>hookName baseConfig <+></code> to the new value. (You may also make it the first item in a <code>composeAll</code> for the <code>manageHook</code>, or use Haskell's <code>do</code> notation for most other hooks.) |
||
| − | -- 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 |
||
| + | <pre> |
||
| − | -- The default number of workspaces (virtual screens) and their names. |
||
| + | import XMonad |
||
| − | -- By default we use numeric strings, but any string may be used as a |
||
| + | import XMonad.Config.Desktop |
||
| − | -- workspace name. The number of workspaces is determined by the length |
||
| + | import XMonad.Util.SpawnOnce |
||
| − | -- of this list. |
||
| − | -- |
||
| − | -- A tagging example: |
||
| − | -- |
||
| − | -- > workspaces = ["web", "irc", "code" ] ++ map show [4..9] |
||
| − | -- |
||
| − | myWorkspaces = ["1","2","3","4","5","6","7","8","9"] |
||
| + | baseConfig = desktopConfig |
||
| − | -- Border colors for unfocused and focused windows, respectively. |
||
| − | -- |
||
| − | myNormalBorderColor = "#dddddd" |
||
| − | myFocusedBorderColor = "#ff0000" |
||
| + | main = xmonad baseConfig { |
||
| − | ------------------------------------------------------------------------ |
||
| + | focusedBorderColor = "#ff2037" -- not a hook |
||
| − | -- Key bindings. Add, modify or remove key bindings here. |
||
| + | ,startupHook = startupHook baseConfig <+> spawnOnce "urxvt" |
||
| − | -- |
||
| + | } |
||
| − | myKeys conf@(XConfig {XMonad.modMask = modm}) = M.fromList $ |
||
| + | </pre> |
||
| + | This ensures that you don't skip any hooks needed by the base configuration. If you want to do this with <code>layoutHook</code>, use <code>(|||)</code> instead: |
||
| − | -- launch a terminal |
||
| − | [ ((modm .|. shiftMask, xK_Return), spawn $ XMonad.terminal conf) |
||
| + | <pre> |
||
| − | -- launch dmenu |
||
| + | layoutHook = myTall ||| layoutHook baseConfig |
||
| − | , ((modm, xK_p ), spawn "exe=`dmenu_path | dmenu` && eval \"exec $exe\"") |
||
| + | </pre> |
||
| + | The consistent use of <code>baseConfig</code> means you only need to change the definition of <code>baseConfig</code> in order to switch to a different base, e.g. <code>defaultConfig</code> for basic ICCCM compliance or <code>xfceConfig</code> to integrate with an existing XFCE session. |
||
| − | -- launch gmrun |
||
| − | , ((modm .|. shiftMask, xK_p ), spawn "gmrun") |
||
| + | If you plan to use <code>XMonad.Util.EZConfig.additionalKeys</code>, or define your own hooks or commands, you may wish to put non-hooks in the definition of <code>baseConfig</code> so that you can refer to your <code>modMask</code> etc. later: |
||
| − | -- close focused window |
||
| − | , ((modm .|. shiftMask, xK_c ), kill) |
||
| + | <pre> |
||
| − | -- Rotate through the available layout algorithms |
||
| + | import XMonad |
||
| − | , ((modm, xK_space ), sendMessage NextLayout) |
||
| + | import XMonad.Config.Desktop |
||
| − | |||
| + | import XMonad.Util.EZConfig |
||
| − | -- 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. |
||
| − | -- |
||
| − | -- 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 |
||
| − | |||
| − | -- * EwmhDesktops users should change this to ewmhDesktopsEventHook |
||
| − | -- |
||
| − | -- 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. |
||
| − | -- |
||
| − | myEventHook = mempty |
||
| − | |||
| − | ------------------------------------------------------------------------ |
||
| − | -- Status bars and logging |
||
| − | |||
| − | -- Perform an arbitrary action on each internal state change or X event. |
||
| − | -- See the 'DynamicLog' extension for examples. |
||
| − | -- |
||
| − | -- To emulate dwm's status bar |
||
| − | -- |
||
| − | -- > logHook = dynamicLogDzen |
||
| − | -- |
||
| − | 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. |
||
| − | myStartupHook = return () |
||
| − | |||
| − | ------------------------------------------------------------------------ |
||
| − | -- Now run xmonad with all the defaults we set up. |
||
| + | baseConfig = desktopConfig { |
||
| − | -- Run xmonad with the settings you specify. No need to modify this. |
||
| + | modMask = mod4Mask |
||
| − | -- |
||
| + | , focusedBorderColor = "#ff2037" |
||
| − | main = xmonad defaults |
||
| + | } |
||
| + | main = xmonad $ baseConfig { |
||
| − | -- A structure containing your configuration settings, overriding |
||
| + | startupHook = startupHook baseConfig <+> myHook |
||
| − | -- fields in the default config. Any you don't override, will |
||
| + | } |
||
| − | -- use the defaults defined in xmonad/XMonad/Config.hs |
||
| + | `additionalKeys` |
||
| − | -- |
||
| + | [((modMask baseConfig,xK_F1), spawn "firefox")) |
||
| − | -- No need to modify this. |
||
| + | ] |
||
| − | -- |
||
| − | defaults = defaultConfig { |
||
| − | -- simple stuff |
||
| − | terminal = myTerminal, |
||
| − | focusFollowsMouse = myFocusFollowsMouse, |
||
| − | borderWidth = myBorderWidth, |
||
| − | modMask = myModMask, |
||
| − | numlockMask = myNumlockMask, |
||
| − | workspaces = myWorkspaces, |
||
| − | normalBorderColor = myNormalBorderColor, |
||
| − | focusedBorderColor = myFocusedBorderColor, |
||
| + | myHook = {- ... -} |
||
| − | -- key bindings |
||
| + | </pre> |
||
| − | keys = myKeys, |
||
| − | mouseBindings = myMouseBindings, |
||
| + | See [http://xmonad.org/xmonad-docs/xmonad-contrib/XMonad-Doc-Configuring.html XMonad.Doc.Configuring] for more information on customizing an xmonad configuration. |
||
| − | -- hooks, layouts |
||
| − | layoutHook = myLayout, |
||
| − | manageHook = myManageHook, |
||
| − | handleEventHook = myEventHook, |
||
| − | logHook = myLogHook, |
||
| − | startupHook = myStartupHook |
||
| − | } |
||
| − | </haskell> |
||
Latest revision as of 17:06, 11 January 2018
If you want a good configuration to start from, it's quite simple.
A very basic configuration, which will work for things like simple terminals but not so well for many modern applications such as web browsers:
import XMonad main = xmonad defaultConfig
A more modern and more easily customized, yet still minimal, configuration (requires xmonad-contrib). Use this config if you plan to run Chromium; recent versions do not work correctly if you do not have desktop support enabled!
import XMonad import XMonad.Config.Desktop baseConfig = desktopConfig main = xmonad baseConfig
In this one, if you want to add things to various hooks (anything that ends with Hook, except layoutHook which is handled specially), you should prepend hookName baseConfig <+> to the new value. (You may also make it the first item in a composeAll for the manageHook, or use Haskell's do notation for most other hooks.)
import XMonad
import XMonad.Config.Desktop
import XMonad.Util.SpawnOnce
baseConfig = desktopConfig
main = xmonad baseConfig {
focusedBorderColor = "#ff2037" -- not a hook
,startupHook = startupHook baseConfig <+> spawnOnce "urxvt"
}
This ensures that you don't skip any hooks needed by the base configuration. If you want to do this with layoutHook, use (|||) instead:
layoutHook = myTall ||| layoutHook baseConfig
The consistent use of baseConfig means you only need to change the definition of baseConfig in order to switch to a different base, e.g. defaultConfig for basic ICCCM compliance or xfceConfig to integrate with an existing XFCE session.
If you plan to use XMonad.Util.EZConfig.additionalKeys, or define your own hooks or commands, you may wish to put non-hooks in the definition of baseConfig so that you can refer to your modMask etc. later:
import XMonad
import XMonad.Config.Desktop
import XMonad.Util.EZConfig
baseConfig = desktopConfig {
modMask = mod4Mask
, focusedBorderColor = "#ff2037"
}
main = xmonad $ baseConfig {
startupHook = startupHook baseConfig <+> myHook
}
`additionalKeys`
[((modMask baseConfig,xK_F1), spawn "firefox"))
]
myHook = {- ... -}
See XMonad.Doc.Configuring for more information on customizing an xmonad configuration.