aboutsummaryrefslogtreecommitdiffstats
path: root/XMonad/Hooks/Script.hs
blob: 82e486851c77d0fdd010c249842e381bf5f78bde (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
-----------------------------------------------------------------------------
-- |
-- Module      : XMonad.Hooks.Script
-- Copyright   : (c) Trevor Elliott <trevor@galois.com>
-- License     : BSD3-style (see LICENSE)
--
-- Maintainer  : Trevor Elliott <trevor@galois.com>
-- Stability   : unstable
-- Portability : unportable
--
-- Provides a simple interface for running a ~\/.xmonad\/hooks script with the
-- name of a hook.
--
-----------------------------------------------------------------------------

module XMonad.Hooks.Script (
    -- * Usage
    -- $usage

    -- * Script Hook Interface
    execScriptHook
  ) where

--
-- Useful Imports
--
import XMonad

-- $usage
--
-- This module allows you to run a centrally located script with the text
-- name of a hook.  The script is assumed to be located at @~\/.xmonad\/hooks@.
--
-- For example, if you wanted to run the hook "startup" in your script every
-- time your startup hook ran, you could modify your xmonad config as such:
--
-- > main = xmonad $ defaultConfig {
-- >   ...
-- >   startupHook = execScriptHook "startup"
-- >   ...
-- >   }
--
-- Now, every time the startup hook runs, the command
-- @~\/.xmonad\/hooks startup@ will also.

-- | Execute a named script hook
execScriptHook :: MonadIO m => String -> m ()
execScriptHook hook = do
  xmonadDir <- getXMonadDir
  let script = xmonadDir ++ "/hooks "
  spawn (script ++ hook)