This is the method to enable an urgency hook. It uses the default urgencyConfig to control behavior. To change this, use withUrgencyHookC instead.

This lets you modify the defaults set in urgencyConfig. An example:

withUrgencyHookC dzenUrgencyHook { ... } urgencyConfig { suppressWhen = Focused }

(Don't type the ..., you dolt.) See UrgencyConfig for details on configuration.

Global configuration, applied to all types of UrgencyHook. See urgencyConfig for the defaults.

The default UrgencyConfig. suppressWhen = Visible, remindWhen = Dont. Use a variation of this in your config just as you use a variation of def for your xmonad definition.

A set of choices as to when you should (or rather, shouldn't) be notified of an urgent window. The default is Visible. Prefix each of the following with "don't bug me when":

A set of choices as to when you want to be re-notified of an urgent window. Perhaps you focused on something and you miss the dzen popup bar. Or you're AFK. Or you feel the need to be more distracted. I don't care.

The interval arguments are in seconds. See the minutes helper.

Focuses the most recently urgent window. Good for what ails ya -- I mean, your keybindings. Example keybinding:

, ((modm              , xK_BackSpace), focusUrgent)

Just makes the urgents go away. Example keybinding:

, ((modm .|. shiftMask, xK_BackSpace), clearUrgents)

Flashes when a window requests your attention and you can't see it. Defaults to a duration of five seconds, and no extra args to dzen. See DzenUrgencyHook.

Your set of options for configuring a dzenUrgencyHook.

urgencyhook such that windows on certain workspaces never get urgency set.

Useful for scratchpad workspaces perhaps:

main = xmonad (withUrgencyHook (filterUrgencyHook ["NSP", "SP"]) def)

filterUrgencyHook that takes a generic Query to select which windows should never be marked urgent.

A prettified way of multiplying by 60. Use like: (5 minutes).

Multiplies by ONE MILLION, for functions that take microseconds.

Use like:

(5.5 `seconds`)

In GHC 7 and later, you must either enable the PostfixOperators extension (by adding

{-# LANGUAGE PostfixOperators #-}

to the top of your file) or use seconds in prefix form:

seconds 5.5

Mark the given window urgent.

(The implementation is a bit hacky: send a _NET_WM_STATE ClientMessage to ourselves. This is so that we respect the SuppressWhen of the configured urgency hooks. If this module if ever migrated to the ExtensibleConf infrastrcture, we'll then invoke markUrgent directly.)

Helper for ManageHook that marks the window as urgent (unless suppressed, see SuppressWhen). Useful in setEwmhActivateHook and also in combination with XMonad.Hooks.InsertPosition, XMonad.Hooks.Focus.

X action that returns a list of currently urgent windows. You might use it, or withUrgents, in your custom logHook, to display the workspaces that contain urgent windows.

An HOF version of readUrgents, for those who prefer that sort of thing.

Clear urgency status of selected windows.

The class definition, and some pre-defined instances.

A hook that sets the border color of an urgent window. The color will remain until the next time the window gains or loses focus, at which point the standard border color from the XConfig will be applied. You may want to use suppressWhen = Never with this:

withUrgencyHookC BorderUrgencyHook { urgencyBorderColor = "#ff0000" } urgencyConfig { suppressWhen = Never } ...

(This should be urgentBorderColor but that breaks XMonad.Layout.Decoration. borderColor breaks anyone using XPConfig from XMonad.Prompt. We need to think a bit more about namespacing issues, maybe.)

A hook which will automatically send you to anything which sets the urgent flag (as opposed to printing some sort of message. You would use this as usual, eg.

withUrgencyHook FocusHook $ myconfig { ...

Spawn a commandline thing, appending the window id to the prefix string you provide. (Make sure to add a space if you need it.) Do your crazy xcompmgr thing.

For debugging purposes, really.