xmonad-contrib-0.9.1: Third party extensions for xmonad

Portabilityunportable
Stabilityunstable
Maintainerjuhe_xmonad@hck.sk

XMonad.Prompt.DirExec

Contents

Description

A directory file executables prompt for XMonad. This might be useful if you don't want to have scripts in your PATH environment variable (same executable names, different behavior) - otherwise you might want to use XMonad.Prompt.Shell instead - but you want to have easy access to these executables through the xmonad's prompt.

Synopsis

Usage

  1. In your ~/.xmonad/xmonad.hs:
 import XMonad.Prompt.DirExec
  1. In your keybindings add something like:
   , ("M-C-x", dirExecPrompt defaultXPConfig spawn "/home/joe/.scipts")

or

   , ("M-C-x", dirExecPromptNamed defaultXPConfig spawn
                                  "/home/joe/.scripts" "My Scripts: ")

or add this after your default bindings:

   ++
   [ ("M-x " ++ key, dirExecPrompt defaultXPConfig fn "/home/joe/.scripts")
     | (key, fn) <- [ ("x", spawn), ("M-x", runInTerm "-hold") ]
   ]
   ++

The first alternative uses the last element of the directory path for a name of prompt. The second alternative uses the provided string for the name of the prompt. The third alternative defines 2 key bindings, first one spawns the program by shell, second one runs the program in terminal

For detailed instruction on editing the key binding see XMonad.Doc.Extending.

dirExecPrompt :: XPConfig -> (String -> X ()) -> FilePath -> X ()Source

Function dirExecPrompt starts the prompt with list of all executable files in directory specified by FilePath. The name of the prompt is taken from the last element of the path. If you specify root directory - / - as the path, name Root: will be used as the name of the prompt instead. The XPConfig parameter can be used to customize visuals of the prompt. The runner parameter specifies the function used to run the program - see usage for more information

dirExecPromptNamed :: XPConfig -> (String -> X ()) -> FilePath -> String -> X ()Source

Function dirExecPromptNamed does the same as dirExecPrompt except the name of the prompt is specified by String parameter.