Open main menu

Linux and Unix Users Group at Virginia Teck Wiki β

Changes

Xmonad

14,735 bytes added, 07:29, 4 January 2019
Undo revision 910 by [[Special:Contributions/imported>Pew|imported>Pew]] ([[User talk:imported>Pew|talk]])
'''Xmonad''' is the tiling window manager that rocks! =Basic Xmonad Keybindings=Xmonad has very similar keybindings to [[dwm]]. Heres a few of the major ones. They can be redefined by editing the example configuration below.;Mod-Space:Changes the tiling method;Mod-Enter:Changes the selected tile to the master tile;Mod-q:Restarts Xmonad. Note that any open windows and tiles will NOT bet lost;Mod-Shift-q:Kills Xmonad, and usually Xorg (depending on how you start X);Mod-j:Select the next tile;Mod-k:Select the previous tile;Mod-Shift-j:Move the current tile forward;Mod-Shift-k:Move the current tile backwards;Mod-n:Moves to desktop number n;Mod-Shift-n:Move the current tile to desktop n;Mod-h:Increase the size of the current tile;Mod-l:Decrease the size of the current tile;Mod-p:Launches dmenu (if installed) =Configuring Xmonad=Edit <code>~/.xmonad/xmonad.hs</code>, then restart Xmonad (Mod-q be default). This configuration file below is the default configuration file, plus a few changes. The mode key is moved from Alt to Super (windows key), the default terminal is set to urxvt instead of xterm, and the PrtSc and Ctr-PrtSc are mapped to scrot (see below for details). Note that this file is written in Haskell, and thus, comments are --. This file also starts xmobar (Xmonad's bar). It is usually a separate package, so if you want this bar, make sure to install it and configure .xmobarrc. =Ackthet's xmonad.hs and .xmobarrc=For dual head setup, come to IRC and bug Shards_of_Narsil (used to be ackthet)Here is an example .xmobarrc:<pre>Config { font = "-*-terminus-*-*-*-*-12-*-*-*-*-*-*-u" , bgColor = "#000000" , fgColor = "#00FFFF" , position = Top , lowerOnStart = False , commands = [ Run Network "eth0" ["-L","0","-H","32","-l", "green", "--normal","orange","--high","red"] 10 , Run Network "wlan0" ["-L","0","-H","32","-l", "green", "--normal","orange","--high","red"] 10 , Run Cpu ["<cpu0>/<cpu1>","-L","3","-H","50","-l","green","--normal","orange","--high","red"] 10 , Run Cpu ["<cpu0>","-L","3","-H","50","-l","green","--normal","orange","--high","red"] 10 , Run Memory ["-t","Mem: <usedratio>%", "-l", "green", "--normal","orange","--high","red"] 10 , Run Date "%a %b %_d %H:%M" "date" 60 , Run CpuFreq ["-t","Freq:<cpu0>|<cpu1>GHz","-L","0","-H","2","-l","green","-n","orange","-h","red"] 10 , Run Battery ["-L","50","-H","75","--high","green","--normal","yellow", "--low", "red"] 10 , Run StdinReader ] , sepChar = "%" , alignSep = "}{" , template = " %StdinReader% }{ %cpu% @ %cpufreq% <fc=#0033FF>|</fc> %memory% <fc=#0033FF>|</fc> %eth0% <fc=#0033FF>|</fc> %wlan0% <fc=#0033FF>|</fc> %date% <fc=#0033FF>|</fc> %battery%" }</pre>Here is a modified xmonad.hs<pre>---- xmonad example config file for xmonad-0.9---- 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.---- NOTE: Those updating from earlier xmonad versions, who use-- EwmhDesktops, safeSpawn, WindowGo, or the simple-status-bar-- setup functions (dzen, xmobar) probably need to change-- xmonad.hs, please see the notes below, or the following-- link for more details:---- http://www.haskell.org/haskellwiki/Xmonad/Notable_changes_since_0.8-- import XMonadimport Data.Monoidimport System.Exitimport XMonad.Hooks.DynamicLogimport XMonad.Hooks.ManageDocks import qualified XMonad.StackSet as Wimport qualified Data.Map as M -- The preferred terminal program, which is used in a binding below and by-- certain contrib modules.--myTerminal = "urxvt" -- Whether focus follows the mouse pointer.myFocusFollowsMouse :: BoolmyFocusFollowsMouse = 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 = mod4Mask -- 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.-- 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)  , ((controlMask, xK_Print ), spawn "sleep 0.2; scrot -s")  , ((0 , xK_Print), spawn "scrot")  -- 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=<< xmobar 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, numlockMask = myNumlockMask, workspaces = myWorkspaces, normalBorderColor = myNormalBorderColor, focusedBorderColor = myFocusedBorderColor, -- key bindings keys = myKeys, mouseBindings = myMouseBindings, -- hooks, layouts layoutHook = myLayout, manageHook = myManageHook, handleEventHook = myEventHook, logHook = myLogHook, startupHook = myStartupHook }</pre> [[Category:Howtos]][[Category:Software]][[Category:Pending deletionScripts]]