xmonad-contrib-0.18.1: Community-maintained extensions for xmonad

Copyright | (c) Spencer Janssen
License | BSD
Maintainer | Spencer Janssen <spencerjanssen@gmail.com>
Stability | unstable
Portability | unportable
Safe Haskell | None
Language | Haskell2010

XMonad.Actions.SpawnOn

Contents

- Usage

Description

Provides a way to modify a window spawned by a command(e.g shift it to the workspace it was launched on) by using the _NET_WM_PID property that most windows set on creation. Hence this module won't work on applications that don't set this property.

Synopsis

- data Spawner
- manageSpawn :: ManageHook
- manageSpawnWithGC :: ([(ProcessID, ManageHook)] -> X [(ProcessID, ManageHook)]) -> ManageHook
- spawnHere :: String -> X ()
- spawnOn :: WorkspaceId -> String -> X ()
- spawnAndDo :: ManageHook -> String -> X ()
- shellPromptHere :: XPConfig -> X ()
- shellPromptOn :: WorkspaceId -> XPConfig -> X ()

# Usage

You can use this module with the following in your `xmonad.hs`:

       import XMonad.Actions.SpawnOn

       main = do
         xmonad def {
            ...
            manageHook = manageSpawn <> manageHook def
            ...
         }

To ensure that application appears on a workspace it was launched at, add keybindings like:

     , ((mod1Mask,xK_o), spawnHere "urxvt")
     , ((mod1Mask,xK_s), shellPromptHere def)

The module can also be used to apply other manage hooks to the window of the spawned application(e.g. float or resize it).

For detailed instructions on editing your key bindings, see the tutorial.

data Spawner #

#### Instances

Instances details

ExtensionClass Spawner # |
Instance details Defined in XMonad.Actions.SpawnOn Methods initialValue :: Spawner # extensionType :: Spawner -> StateExtension #

manageSpawn :: ManageHook #

Provides a manage hook to react on process spawned with `spawnOn`, `spawnHere` etc.

manageSpawnWithGC #

Arguments

:: ([(ProcessID, ManageHook)] -> X [(ProcessID, ManageHook)]) | function to stop accumulation of entries for windows that never set `_NET_WM_PID`
-> ManageHook |

spawnHere :: String -> X () #

Replacement for `spawn` which launches application on current workspace.

spawnOn :: WorkspaceId -> String -> X () #

Replacement for `spawn` which launches application on given workspace.

spawnAndDo :: ManageHook -> String -> X () #

Spawn an application and apply the manage hook when it opens.

shellPromptHere :: XPConfig -> X () #

Replacement for Shell prompt (XMonad.Prompt.Shell) which launches application on current workspace.

shellPromptOn :: WorkspaceId -> XPConfig -> X () #

Replacement for Shell prompt (XMonad.Prompt.Shell) which launches application on given workspace.