imported>Pew |
imported>Pew |
Line 1: |
Line 1: |
− | TODO: Move to software page
| + | [[Category:Pending deletion]] |
− | | |
− | '''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 XMonad
| |
− | import Data.Monoid
| |
− | import System.Exit
| |
− | import XMonad.Hooks.DynamicLog
| |
− | import XMonad.Hooks.ManageDocks
| |
− |
| |
− | 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 = "urxvt"
| |
− |
| |
− | -- 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 = 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:Window managers]]
| |
− | [[Category:Needs restoration]] | |