<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html> <head> <!-- Generated by HsColour, http://code.haskell.org/~malcolm/hscolour/ --> <title>XMonad/Actions/Commands.hs</title> <link type='text/css' rel='stylesheet' href='hscolour.css' /> </head> <body> <pre><a name="line-1"></a><span class='hs-comment'>-----------------------------------------------------------------------------</span> <a name="line-2"></a><span class='hs-comment'>-- |</span> <a name="line-3"></a><span class='hs-comment'>-- Module : XMonad.Actions.Commands</span> <a name="line-4"></a><span class='hs-comment'>-- Copyright : (c) David Glasser 2007</span> <a name="line-5"></a><span class='hs-comment'>-- License : BSD3</span> <a name="line-6"></a><span class='hs-comment'>--</span> <a name="line-7"></a><span class='hs-comment'>-- Maintainer : glasser@mit.edu</span> <a name="line-8"></a><span class='hs-comment'>-- Stability : stable</span> <a name="line-9"></a><span class='hs-comment'>-- Portability : portable</span> <a name="line-10"></a><span class='hs-comment'>--</span> <a name="line-11"></a><span class='hs-comment'>-- Allows you to run internal xmonad commands (X () actions) using</span> <a name="line-12"></a><span class='hs-comment'>-- a dmenu menu in addition to key bindings. Requires dmenu and</span> <a name="line-13"></a><span class='hs-comment'>-- the Dmenu XMonad.Actions module.</span> <a name="line-14"></a><span class='hs-comment'>--</span> <a name="line-15"></a><span class='hs-comment'>-----------------------------------------------------------------------------</span> <a name="line-16"></a> <a name="line-17"></a><span class='hs-keyword'>module</span> <span class='hs-conid'>XMonad</span><span class='hs-varop'>.</span><span class='hs-conid'>Actions</span><span class='hs-varop'>.</span><span class='hs-conid'>Commands</span> <span class='hs-layout'>(</span> <a name="line-18"></a> <span class='hs-comment'>-- * Usage</span> <a name="line-19"></a> <span class='hs-comment'>-- $usage</span> <a name="line-20"></a> <span class='hs-varid'>commandMap</span><span class='hs-layout'>,</span> <a name="line-21"></a> <span class='hs-varid'>runCommand</span><span class='hs-layout'>,</span> <a name="line-22"></a> <span class='hs-varid'>runCommand'</span><span class='hs-layout'>,</span> <a name="line-23"></a> <span class='hs-varid'>workspaceCommands</span><span class='hs-layout'>,</span> <a name="line-24"></a> <span class='hs-varid'>screenCommands</span><span class='hs-layout'>,</span> <a name="line-25"></a> <span class='hs-varid'>defaultCommands</span> <a name="line-26"></a> <span class='hs-layout'>)</span> <span class='hs-keyword'>where</span> <a name="line-27"></a> <a name="line-28"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>XMonad</span> <a name="line-29"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>XMonad</span><span class='hs-varop'>.</span><span class='hs-conid'>StackSet</span> <span class='hs-varid'>hiding</span> <span class='hs-layout'>(</span><span class='hs-varid'>workspaces</span><span class='hs-layout'>)</span> <a name="line-30"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>XMonad</span><span class='hs-varop'>.</span><span class='hs-conid'>Util</span><span class='hs-varop'>.</span><span class='hs-conid'>Dmenu</span> <span class='hs-layout'>(</span><span class='hs-varid'>dmenu</span><span class='hs-layout'>)</span> <a name="line-31"></a> <a name="line-32"></a><span class='hs-keyword'>import</span> <span class='hs-keyword'>qualified</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Map</span> <span class='hs-keyword'>as</span> <span class='hs-conid'>M</span> <a name="line-33"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>System</span><span class='hs-varop'>.</span><span class='hs-conid'>Exit</span> <a name="line-34"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Maybe</span> <a name="line-35"></a> <a name="line-36"></a><span class='hs-comment'>-- $usage</span> <a name="line-37"></a><span class='hs-comment'>--</span> <a name="line-38"></a><span class='hs-comment'>-- You can use this module with the following in your @~\/.xmonad\/xmonad.hs@:</span> <a name="line-39"></a><span class='hs-comment'>--</span> <a name="line-40"></a><span class='hs-comment'>-- > import XMonad.Actions.Commands</span> <a name="line-41"></a><span class='hs-comment'>--</span> <a name="line-42"></a><span class='hs-comment'>-- Then add a keybinding to the runCommand action:</span> <a name="line-43"></a><span class='hs-comment'>--</span> <a name="line-44"></a><span class='hs-comment'>-- > , ((modm .|. controlMask, xK_y), commands >>= runCommand)</span> <a name="line-45"></a><span class='hs-comment'>--</span> <a name="line-46"></a><span class='hs-comment'>-- and define the list of commands you want to use:</span> <a name="line-47"></a><span class='hs-comment'>--</span> <a name="line-48"></a><span class='hs-comment'>-- > commands :: X [(String, X ())]</span> <a name="line-49"></a><span class='hs-comment'>-- > commands = defaultCommands</span> <a name="line-50"></a><span class='hs-comment'>--</span> <a name="line-51"></a><span class='hs-comment'>-- Whatever key you bound to will now cause a popup menu of internal</span> <a name="line-52"></a><span class='hs-comment'>-- xmonad commands to appear. You can change the commands by changing</span> <a name="line-53"></a><span class='hs-comment'>-- the contents of the list returned by 'commands'. (If you like it</span> <a name="line-54"></a><span class='hs-comment'>-- enough, you may even want to get rid of many of your other key</span> <a name="line-55"></a><span class='hs-comment'>-- bindings!)</span> <a name="line-56"></a><span class='hs-comment'>--</span> <a name="line-57"></a><span class='hs-comment'>-- For detailed instructions on editing your key bindings, see</span> <a name="line-58"></a><span class='hs-comment'>-- "XMonad.Doc.Extending#Editing_key_bindings".</span> <a name="line-59"></a> <a name="line-60"></a><a name="commandMap"></a><span class='hs-comment'>-- | Create a 'Data.Map.Map' from @String@s to xmonad actions from a</span> <a name="line-61"></a><span class='hs-comment'>-- list of pairs.</span> <a name="line-62"></a><span class='hs-definition'>commandMap</span> <span class='hs-keyglyph'>::</span> <span class='hs-keyglyph'>[</span><span class='hs-layout'>(</span><span class='hs-conid'>String</span><span class='hs-layout'>,</span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span><span class='hs-layout'>)</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>M</span><span class='hs-varop'>.</span><span class='hs-conid'>Map</span> <span class='hs-conid'>String</span> <span class='hs-layout'>(</span><span class='hs-conid'>X</span> <span class='hs-conid'>()</span><span class='hs-layout'>)</span> <a name="line-63"></a><span class='hs-definition'>commandMap</span> <span class='hs-varid'>c</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>M</span><span class='hs-varop'>.</span><span class='hs-varid'>fromList</span> <span class='hs-varid'>c</span> <a name="line-64"></a> <a name="line-65"></a><a name="workspaceCommands"></a><span class='hs-comment'>-- | Generate a list of commands to switch to\/send windows to workspaces.</span> <a name="line-66"></a><span class='hs-definition'>workspaceCommands</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>X</span> <span class='hs-keyglyph'>[</span><span class='hs-layout'>(</span><span class='hs-conid'>String</span><span class='hs-layout'>,</span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span><span class='hs-layout'>)</span><span class='hs-keyglyph'>]</span> <a name="line-67"></a><span class='hs-definition'>workspaceCommands</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>asks</span> <span class='hs-layout'>(</span><span class='hs-varid'>workspaces</span> <span class='hs-varop'>.</span> <span class='hs-varid'>config</span><span class='hs-layout'>)</span> <span class='hs-varop'>>>=</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>spaces</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>return</span> <a name="line-68"></a> <span class='hs-keyglyph'>[</span><span class='hs-layout'>(</span><span class='hs-layout'>(</span><span class='hs-varid'>m</span> <span class='hs-varop'>++</span> <span class='hs-varid'>show</span> <span class='hs-varid'>i</span><span class='hs-layout'>)</span><span class='hs-layout'>,</span> <span class='hs-varid'>windows</span> <span class='hs-varop'>$</span> <span class='hs-varid'>f</span> <span class='hs-varid'>i</span><span class='hs-layout'>)</span> <a name="line-69"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>i</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>spaces</span> <a name="line-70"></a> <span class='hs-layout'>,</span> <span class='hs-layout'>(</span><span class='hs-varid'>f</span><span class='hs-layout'>,</span> <span class='hs-varid'>m</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'><-</span> <span class='hs-keyglyph'>[</span><span class='hs-layout'>(</span><span class='hs-varid'>view</span><span class='hs-layout'>,</span> <span class='hs-str'>"view"</span><span class='hs-layout'>)</span><span class='hs-layout'>,</span> <span class='hs-layout'>(</span><span class='hs-varid'>shift</span><span class='hs-layout'>,</span> <span class='hs-str'>"shift"</span><span class='hs-layout'>)</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>]</span> <a name="line-71"></a> <a name="line-72"></a><a name="screenCommands"></a><span class='hs-comment'>-- | Generate a list of commands dealing with multiple screens.</span> <a name="line-73"></a><span class='hs-definition'>screenCommands</span> <span class='hs-keyglyph'>::</span> <span class='hs-keyglyph'>[</span><span class='hs-layout'>(</span><span class='hs-conid'>String</span><span class='hs-layout'>,</span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span><span class='hs-layout'>)</span><span class='hs-keyglyph'>]</span> <a name="line-74"></a><span class='hs-definition'>screenCommands</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyglyph'>[</span><span class='hs-layout'>(</span><span class='hs-layout'>(</span><span class='hs-varid'>m</span> <span class='hs-varop'>++</span> <span class='hs-varid'>show</span> <span class='hs-varid'>sc</span><span class='hs-layout'>)</span><span class='hs-layout'>,</span> <span class='hs-varid'>screenWorkspace</span> <span class='hs-layout'>(</span><span class='hs-varid'>fromIntegral</span> <span class='hs-varid'>sc</span><span class='hs-layout'>)</span> <span class='hs-varop'>>>=</span> <span class='hs-varid'>flip</span> <span class='hs-varid'>whenJust</span> <span class='hs-layout'>(</span><span class='hs-varid'>windows</span> <span class='hs-varop'>.</span> <span class='hs-varid'>f</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <a name="line-75"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>sc</span> <span class='hs-keyglyph'><-</span> <span class='hs-keyglyph'>[</span><span class='hs-num'>0</span><span class='hs-layout'>,</span> <span class='hs-num'>1</span><span class='hs-keyglyph'>]</span><span class='hs-keyglyph'>::</span><span class='hs-keyglyph'>[</span><span class='hs-conid'>Int</span><span class='hs-keyglyph'>]</span> <span class='hs-comment'>-- TODO: adapt to screen changes</span> <a name="line-76"></a> <span class='hs-layout'>,</span> <span class='hs-layout'>(</span><span class='hs-varid'>f</span><span class='hs-layout'>,</span> <span class='hs-varid'>m</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'><-</span> <span class='hs-keyglyph'>[</span><span class='hs-layout'>(</span><span class='hs-varid'>view</span><span class='hs-layout'>,</span> <span class='hs-str'>"screen"</span><span class='hs-layout'>)</span><span class='hs-layout'>,</span> <span class='hs-layout'>(</span><span class='hs-varid'>shift</span><span class='hs-layout'>,</span> <span class='hs-str'>"screen-to-"</span><span class='hs-layout'>)</span><span class='hs-keyglyph'>]</span> <a name="line-77"></a> <span class='hs-keyglyph'>]</span> <a name="line-78"></a> <a name="line-79"></a><a name="defaultCommands"></a><span class='hs-comment'>-- | A nice pre-defined list of commands.</span> <a name="line-80"></a><span class='hs-definition'>defaultCommands</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>X</span> <span class='hs-keyglyph'>[</span><span class='hs-layout'>(</span><span class='hs-conid'>String</span><span class='hs-layout'>,</span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span><span class='hs-layout'>)</span><span class='hs-keyglyph'>]</span> <a name="line-81"></a><span class='hs-definition'>defaultCommands</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span> <a name="line-82"></a> <span class='hs-varid'>wscmds</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>workspaceCommands</span> <a name="line-83"></a> <span class='hs-varid'>return</span> <span class='hs-varop'>$</span> <span class='hs-varid'>wscmds</span> <span class='hs-varop'>++</span> <span class='hs-varid'>screenCommands</span> <span class='hs-varop'>++</span> <span class='hs-varid'>otherCommands</span> <a name="line-84"></a> <span class='hs-keyword'>where</span> <a name="line-85"></a> <span class='hs-varid'>otherCommands</span> <span class='hs-keyglyph'>=</span> <a name="line-86"></a> <span class='hs-keyglyph'>[</span> <span class='hs-layout'>(</span><span class='hs-str'>"shrink"</span> <span class='hs-layout'>,</span> <span class='hs-varid'>sendMessage</span> <span class='hs-conid'>Shrink</span> <span class='hs-layout'>)</span> <a name="line-87"></a> <span class='hs-layout'>,</span> <span class='hs-layout'>(</span><span class='hs-str'>"expand"</span> <span class='hs-layout'>,</span> <span class='hs-varid'>sendMessage</span> <span class='hs-conid'>Expand</span> <span class='hs-layout'>)</span> <a name="line-88"></a> <span class='hs-layout'>,</span> <span class='hs-layout'>(</span><span class='hs-str'>"next-layout"</span> <span class='hs-layout'>,</span> <span class='hs-varid'>sendMessage</span> <span class='hs-conid'>NextLayout</span> <span class='hs-layout'>)</span> <a name="line-89"></a> <span class='hs-layout'>,</span> <span class='hs-layout'>(</span><span class='hs-str'>"default-layout"</span> <span class='hs-layout'>,</span> <span class='hs-varid'>asks</span> <span class='hs-layout'>(</span><span class='hs-varid'>layoutHook</span> <span class='hs-varop'>.</span> <span class='hs-varid'>config</span><span class='hs-layout'>)</span> <span class='hs-varop'>>>=</span> <span class='hs-varid'>setLayout</span> <span class='hs-layout'>)</span> <a name="line-90"></a> <span class='hs-layout'>,</span> <span class='hs-layout'>(</span><span class='hs-str'>"restart-wm"</span> <span class='hs-layout'>,</span> <span class='hs-varid'>restart</span> <span class='hs-str'>"xmonad"</span> <span class='hs-conid'>True</span> <span class='hs-layout'>)</span> <a name="line-91"></a> <span class='hs-layout'>,</span> <span class='hs-layout'>(</span><span class='hs-str'>"restart-wm-no-resume"</span><span class='hs-layout'>,</span> <span class='hs-varid'>restart</span> <span class='hs-str'>"xmonad"</span> <span class='hs-conid'>False</span> <span class='hs-layout'>)</span> <a name="line-92"></a> <span class='hs-layout'>,</span> <span class='hs-layout'>(</span><span class='hs-str'>"xterm"</span> <span class='hs-layout'>,</span> <span class='hs-varid'>spawn</span> <span class='hs-varop'>=<<</span> <span class='hs-varid'>asks</span> <span class='hs-layout'>(</span><span class='hs-varid'>terminal</span> <span class='hs-varop'>.</span> <span class='hs-varid'>config</span><span class='hs-layout'>)</span> <span class='hs-layout'>)</span> <a name="line-93"></a> <span class='hs-layout'>,</span> <span class='hs-layout'>(</span><span class='hs-str'>"run"</span> <span class='hs-layout'>,</span> <span class='hs-varid'>spawn</span> <span class='hs-str'>"exe=`dmenu_path | dmenu -b` && exec $exe"</span> <span class='hs-layout'>)</span> <a name="line-94"></a> <span class='hs-layout'>,</span> <span class='hs-layout'>(</span><span class='hs-str'>"kill"</span> <span class='hs-layout'>,</span> <span class='hs-varid'>kill</span> <span class='hs-layout'>)</span> <a name="line-95"></a> <span class='hs-layout'>,</span> <span class='hs-layout'>(</span><span class='hs-str'>"refresh"</span> <span class='hs-layout'>,</span> <span class='hs-varid'>refresh</span> <span class='hs-layout'>)</span> <a name="line-96"></a> <span class='hs-layout'>,</span> <span class='hs-layout'>(</span><span class='hs-str'>"focus-up"</span> <span class='hs-layout'>,</span> <span class='hs-varid'>windows</span> <span class='hs-varid'>focusUp</span> <span class='hs-layout'>)</span> <a name="line-97"></a> <span class='hs-layout'>,</span> <span class='hs-layout'>(</span><span class='hs-str'>"focus-down"</span> <span class='hs-layout'>,</span> <span class='hs-varid'>windows</span> <span class='hs-varid'>focusDown</span> <span class='hs-layout'>)</span> <a name="line-98"></a> <span class='hs-layout'>,</span> <span class='hs-layout'>(</span><span class='hs-str'>"swap-up"</span> <span class='hs-layout'>,</span> <span class='hs-varid'>windows</span> <span class='hs-varid'>swapUp</span> <span class='hs-layout'>)</span> <a name="line-99"></a> <span class='hs-layout'>,</span> <span class='hs-layout'>(</span><span class='hs-str'>"swap-down"</span> <span class='hs-layout'>,</span> <span class='hs-varid'>windows</span> <span class='hs-varid'>swapDown</span> <span class='hs-layout'>)</span> <a name="line-100"></a> <span class='hs-layout'>,</span> <span class='hs-layout'>(</span><span class='hs-str'>"swap-master"</span> <span class='hs-layout'>,</span> <span class='hs-varid'>windows</span> <span class='hs-varid'>swapMaster</span> <span class='hs-layout'>)</span> <a name="line-101"></a> <span class='hs-layout'>,</span> <span class='hs-layout'>(</span><span class='hs-str'>"sink"</span> <span class='hs-layout'>,</span> <span class='hs-varid'>withFocused</span> <span class='hs-varop'>$</span> <span class='hs-varid'>windows</span> <span class='hs-varop'>.</span> <span class='hs-varid'>sink</span> <span class='hs-layout'>)</span> <a name="line-102"></a> <span class='hs-layout'>,</span> <span class='hs-layout'>(</span><span class='hs-str'>"quit-wm"</span> <span class='hs-layout'>,</span> <span class='hs-varid'>io</span> <span class='hs-varop'>$</span> <span class='hs-varid'>exitWith</span> <span class='hs-conid'>ExitSuccess</span> <span class='hs-layout'>)</span> <a name="line-103"></a> <span class='hs-keyglyph'>]</span> <a name="line-104"></a> <a name="line-105"></a><a name="runCommand"></a><span class='hs-comment'>-- | Given a list of command\/action pairs, prompt the user to choose a</span> <a name="line-106"></a><span class='hs-comment'>-- command and return the corresponding action.</span> <a name="line-107"></a><span class='hs-definition'>runCommand</span> <span class='hs-keyglyph'>::</span> <span class='hs-keyglyph'>[</span><span class='hs-layout'>(</span><span class='hs-conid'>String</span><span class='hs-layout'>,</span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span><span class='hs-layout'>)</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span> <a name="line-108"></a><span class='hs-definition'>runCommand</span> <span class='hs-varid'>cl</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span> <a name="line-109"></a> <span class='hs-keyword'>let</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>commandMap</span> <span class='hs-varid'>cl</span> <a name="line-110"></a> <span class='hs-varid'>choice</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>dmenu</span> <span class='hs-layout'>(</span><span class='hs-conid'>M</span><span class='hs-varop'>.</span><span class='hs-varid'>keys</span> <span class='hs-varid'>m</span><span class='hs-layout'>)</span> <a name="line-111"></a> <span class='hs-varid'>fromMaybe</span> <span class='hs-layout'>(</span><span class='hs-varid'>return</span> <span class='hs-conid'>()</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-conid'>M</span><span class='hs-varop'>.</span><span class='hs-varid'>lookup</span> <span class='hs-varid'>choice</span> <span class='hs-varid'>m</span><span class='hs-layout'>)</span> <a name="line-112"></a> <a name="line-113"></a><a name="runCommand'"></a><span class='hs-comment'>-- | Given the name of a command from 'defaultCommands', return the</span> <a name="line-114"></a><span class='hs-comment'>-- corresponding action (or the null action if the command is not</span> <a name="line-115"></a><span class='hs-comment'>-- found).</span> <a name="line-116"></a><span class='hs-definition'>runCommand'</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>String</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span> <a name="line-117"></a><span class='hs-definition'>runCommand'</span> <span class='hs-varid'>c</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span> <a name="line-118"></a> <span class='hs-varid'>m</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>fmap</span> <span class='hs-varid'>commandMap</span> <span class='hs-varid'>defaultCommands</span> <a name="line-119"></a> <span class='hs-varid'>fromMaybe</span> <span class='hs-layout'>(</span><span class='hs-varid'>return</span> <span class='hs-conid'>()</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-conid'>M</span><span class='hs-varop'>.</span><span class='hs-varid'>lookup</span> <span class='hs-varid'>c</span> <span class='hs-varid'>m</span><span class='hs-layout'>)</span> </pre></body> </html>
