commit d7f97d3965b37e96ea5fba8d4c8a9b94fa0e191b Author: Sravan Balaji Date: Thu May 6 19:41:06 2021 -0400 Initial Xmonad Configuration - Add xmonad configuration as org document - Add tangled xmonad configuration output diff --git a/xmonad.hs b/xmonad.hs new file mode 100644 index 0000000..49493d9 --- /dev/null +++ b/xmonad.hs @@ -0,0 +1,230 @@ +import XMonad +import Data.Monoid +import System.Exit + +import qualified XMonad.StackSet as W +import qualified Data.Map as M + +myTerminal = "xterm" + +myFocusFollowsMouse :: Bool +myFocusFollowsMouse = True + +myClickJustFocuses :: Bool +myClickJustFocuses = False + +myBorderWidth = 2 + +myNormalBorderColor = "#4D4D4D" +myFocusedBorderColor = "#BD93F9" + +myWorkspaces = ["1","2","3","4","5","6","7","8","9"] + +myModMask = mod4Mask + +myKeys conf@(XConfig {XMonad.modMask = modm}) = M.fromList $ + + -- launch a terminal + [ ((modm .|. shiftMask, xK_Return), spawn $ XMonad.terminal conf) + + -- launch rofi + , ((modm, xK_p ), spawn "rofi -show drun") + + -- 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_i ), sendMessage (IncMasterN 1)) + + -- Deincrement the number of windows in the master area + , ((modm, xK_d), 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") + + -- Run xmessage with a summary of the default keybindings (useful for beginners) + , ((modm .|. shiftMask, xK_slash ), spawn ("echo \"" ++ help ++ "\" | xmessage -file -")) + ] + ++ + + -- + -- 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)]] + +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) + ] + +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 + +myManageHook = composeAll + [ className =? "MPlayer" --> doFloat + , className =? "Gimp" --> doFloat + , resource =? "desktop_window" --> doIgnore + , resource =? "kdesktop" --> doIgnore ] + +myEventHook = mempty + +myLogHook = return () + +myStartupHook = return () + +main = xmonad defaults + +defaults = def { + -- simple stuff + terminal = myTerminal, + focusFollowsMouse = myFocusFollowsMouse, + clickJustFocuses = myClickJustFocuses, + 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 + } + +help :: String +help = unlines ["The default modifier key is 'alt'. Default keybindings:", + "", + "-- launching and killing programs", + "mod-Shift-Enter Launch xterminal", + "mod-p Launch dmenu", + "mod-Shift-p Launch gmrun", + "mod-Shift-c Close/kill the focused window", + "mod-Space Rotate through the available layout algorithms", + "mod-Shift-Space Reset the layouts on the current workSpace to default", + "mod-n Resize/refresh viewed windows to the correct size", + "", + "-- move focus up or down the window stack", + "mod-Tab Move focus to the next window", + "mod-Shift-Tab Move focus to the previous window", + "mod-j Move focus to the next window", + "mod-k Move focus to the previous window", + "mod-m Move focus to the master window", + "", + "-- modifying the window order", + "mod-Return Swap the focused window and the master window", + "mod-Shift-j Swap the focused window with the next window", + "mod-Shift-k Swap the focused window with the previous window", + "", + "-- resizing the master/slave ratio", + "mod-h Shrink the master area", + "mod-l Expand the master area", + "", + "-- floating layer support", + "mod-t Push window back into tiling; unfloat and re-tile it", + "", + "-- increase or decrease number of windows in the master area", + "mod-comma (mod-,) Increment the number of windows in the master area", + "mod-period (mod-.) Deincrement the number of windows in the master area", + "", + "-- quit, or restart", + "mod-Shift-q Quit xmonad", + "mod-q Restart xmonad", + "mod-[1..9] Switch to workSpace N", + "", + "-- Workspaces & screens", + "mod-Shift-[1..9] Move client to workspace N", + "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", + "", + "-- Mouse bindings: default actions bound to mouse events", + "mod-button1 Set the window to floating mode and move by dragging", + "mod-button2 Raise the window to the top of the stack", + "mod-button3 Set the window to floating mode and resize by dragging"] diff --git a/xmonad.org b/xmonad.org new file mode 100644 index 0000000..69342b2 --- /dev/null +++ b/xmonad.org @@ -0,0 +1,437 @@ +#+title: Personal Xmonad Configuration +#+author: Sravan Balaji +#+PROPERTY: header-args:haskell :tangle ./xmonad.hs + +* Sravan's Xmonad Configuration +** Welcome + + My personal configuration of Xmonad, written as an [[https://orgmode.org][Org Mode]] document. + + Run the block below with `C-c C-c` to tangle code blocks to config file. + +#+begin_src emacs-lisp :tangle no + (org-mode-restart) + (org-babel-tangle) +#+end_src + +* Imports + +#+begin_src haskell + import XMonad + import Data.Monoid + import System.Exit + + import qualified XMonad.StackSet as W + import qualified Data.Map as M +#+end_src + +* Terminal + +The preferred terminal program, which is used in a binding below and by +certain contrib modules. + +#+begin_src haskell + myTerminal = "xterm" +#+end_src + +* Window Behavior & Appearance + +** Mouse Focus + +Whether focus follows the mouse pointer. + +#+begin_src haskell + myFocusFollowsMouse :: Bool + myFocusFollowsMouse = True +#+end_src + +Whether clicking on a window to focus also passes the click to the window + +#+begin_src haskell + myClickJustFocuses :: Bool + myClickJustFocuses = False +#+end_src + +** Window Border Size + +Width of the window border in pixels. + +#+begin_src haskell + myBorderWidth = 2 +#+end_src + +** Window Border Colors + +Border colors for unfocused and focused windows, respectively. + +#+begin_src haskell + myNormalBorderColor = "#4D4D4D" + myFocusedBorderColor = "#BD93F9" +#+end_src + +* Workspaces + +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] + +#+begin_src haskell + myWorkspaces = ["1","2","3","4","5","6","7","8","9"] +#+end_src + +* Keybindings + +** Modifier Key + +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. + +#+begin_src haskell + myModMask = mod4Mask +#+end_src + +** General + +#+begin_src haskell + myKeys conf@(XConfig {XMonad.modMask = modm}) = M.fromList $ + + -- launch a terminal + [ ((modm .|. shiftMask, xK_Return), spawn $ XMonad.terminal conf) + + -- launch rofi + , ((modm, xK_p ), spawn "rofi -show drun") + + -- 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_i ), sendMessage (IncMasterN 1)) + + -- Deincrement the number of windows in the master area + , ((modm, xK_d), 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") + + -- Run xmessage with a summary of the default keybindings (useful for beginners) + , ((modm .|. shiftMask, xK_slash ), spawn ("echo \"" ++ help ++ "\" | xmessage -file -")) + ] + ++ + + -- + -- 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)]] + #+end_src + +** Mouse Bindings + +Mouse bindings: default actions bound to mouse events + + #+begin_src haskell + 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) + ] + #+end_src + +* 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. + +*Example With Xmobar* + #+begin_src haskell :tangle no + myLayout = avoidStruts (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 + #+end_src + + #+begin_src haskell + 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 + #+end_src + +* 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. + + #+begin_src haskell + myManageHook = composeAll + [ className =? "MPlayer" --> doFloat + , className =? "Gimp" --> doFloat + , resource =? "desktop_window" --> doIgnore + , resource =? "kdesktop" --> doIgnore ] + #+end_src + +* Event Handling + + *NOTE*: 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. + +#+begin_src haskell + myEventHook = mempty +#+end_src + +* Status Bars & Logging + +Perform an arbitrary action on each internal state change or X event. +See the 'XMonad.Hooks.DynamicLog' extension for examples. + +#+begin_src haskell + myLogHook = return () +#+end_src + +* 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. + + *Example* +#+begin_src haskell :tangle no + import Xmonad.Util.SpawnOnce + + myStartupHook = do + spawnOnce "nitrogen --restore &" + spawnOnce "picom &" +#+end_src + + By default, do nothing. + +#+begin_src haskell + myStartupHook = return () +#+end_src + +** Run + +Now run xmonad with all the defaults we set up. + +Run xmonad with the settings you specify. No need to modify this. + +*Example With Xmobar* +#+begin_src haskell :tangle no + -- needed for `spawnPipe` + import XMonad.Util.Run + + -- needed for managing dock type programs like xmobar + import XMonad.Hooks.ManageDocks + + main = do + -- `xmobar -x 0` launches the bar on monitor 0 + xmproc <- spawnPipe "xmobar -x 0 /home/sravan/.config/xmobar/xmobar.config" + -- launches xmobar as a dock + xmonad $ docks defaults +#+end_src + +#+begin_src haskell + main = xmonad defaults +#+end_src + +** Configuration Settings + +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. + +#+begin_src haskell + defaults = def { + -- simple stuff + terminal = myTerminal, + focusFollowsMouse = myFocusFollowsMouse, + clickJustFocuses = myClickJustFocuses, + 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 + } +#+end_src + +** Default Keybindings Reference + +Finally, a copy of the default bindings in simple textual tabular format. + +#+begin_src haskell + help :: String + help = unlines ["The default modifier key is 'alt'. Default keybindings:", + "", + "-- launching and killing programs", + "mod-Shift-Enter Launch xterminal", + "mod-p Launch dmenu", + "mod-Shift-p Launch gmrun", + "mod-Shift-c Close/kill the focused window", + "mod-Space Rotate through the available layout algorithms", + "mod-Shift-Space Reset the layouts on the current workSpace to default", + "mod-n Resize/refresh viewed windows to the correct size", + "", + "-- move focus up or down the window stack", + "mod-Tab Move focus to the next window", + "mod-Shift-Tab Move focus to the previous window", + "mod-j Move focus to the next window", + "mod-k Move focus to the previous window", + "mod-m Move focus to the master window", + "", + "-- modifying the window order", + "mod-Return Swap the focused window and the master window", + "mod-Shift-j Swap the focused window with the next window", + "mod-Shift-k Swap the focused window with the previous window", + "", + "-- resizing the master/slave ratio", + "mod-h Shrink the master area", + "mod-l Expand the master area", + "", + "-- floating layer support", + "mod-t Push window back into tiling; unfloat and re-tile it", + "", + "-- increase or decrease number of windows in the master area", + "mod-comma (mod-,) Increment the number of windows in the master area", + "mod-period (mod-.) Deincrement the number of windows in the master area", + "", + "-- quit, or restart", + "mod-Shift-q Quit xmonad", + "mod-q Restart xmonad", + "mod-[1..9] Switch to workSpace N", + "", + "-- Workspaces & screens", + "mod-Shift-[1..9] Move client to workspace N", + "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", + "", + "-- Mouse bindings: default actions bound to mouse events", + "mod-button1 Set the window to floating mode and move by dragging", + "mod-button2 Raise the window to the top of the stack", + "mod-button3 Set the window to floating mode and resize by dragging"] +#+end_src