Difference between revisions of "Xmonad"
imported>Ackthet |
|||
| (23 intermediate revisions by 5 users not shown) | |||
| Line 1: | Line 1: | ||
| − | '''Xmonad''' the tiling window manager that rocks! | + | '''Xmonad''' is the tiling window manager that rocks! |
| − | + | ||
| − | < | + | =Basic Xmonad Keybindings= |
| + | Xmonad has very similar keybindings to [[w:dwm|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 | -- xmonad example config file for xmonad-0.9 | ||
| Line 331: | Line 388: | ||
startupHook = myStartupHook | startupHook = myStartupHook | ||
} | } | ||
| − | </ | + | </pre> |
| + | |||
| + | [[Category:Howtos]] | ||
| + | [[Category:Software]] | ||
| + | [[Category:Scripts]] | ||
Latest revision as of 07:29, 4 January 2019
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 ~/.xmonad/xmonad.hs, 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:
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%"
}
Here is a modified xmonad.hs
--
-- 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
}