xmonad-contrib-0.9.1: Third party extensions for xmonad

Portabilityunportable
Stabilityunstable
MaintainerSpencer Janssen <spencerjanssen@gmail.com>

XMonad.Actions.SpawnOn

Contents

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

Usage

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

    import XMonad.Actions.SpawnOn
    main = do
      sp <- mkSpawner
      xmonad defaultConfig {
         ...
         manageHook = manageSpawn sp <+> manageHook defaultConfig
         ...
      }

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

  , ((mod1Mask,xK_o), spawnHere sp "urxvt")
  , ((mod1Mask,xK_s), shellPromptHere sp defaultXPConfig)

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 XMonad.Doc.Extending.

mkSpawner :: (Functor m, MonadIO m) => m SpawnerSource

Create Spawner which then has to be passed to other functions.

manageSpawn :: Spawner -> ManageHookSource

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

spawnHere :: Spawner -> String -> X ()Source

Replacement for spawn which launches application on current workspace.

spawnOn :: Spawner -> WorkspaceId -> String -> X ()Source

Replacement for spawn which launches application on given workspace.

spawnAndDo :: Spawner -> ManageHook -> String -> X ()Source

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

shellPromptHere :: Spawner -> XPConfig -> X ()Source

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

shellPromptOn :: Spawner -> WorkspaceId -> XPConfig -> X ()Source

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