Run xmonad with a property-based xmobar status bar set to some nice defaults.

main = xmonad $ xmobarProp myConfig

myConfig = def { ... }

The intent is that the above config file should provide a nice status bar with minimal effort. Note that you still need to configure xmobar to use the XMonadLog plugin instead of the default StdinReader, see above.

If you wish to customize the status bar format at all, use the modernized interface provided by the XMonad.Hooks.StatusBar and XMonad.Hooks.StatusBar.PP modules instead.

The binding uses the XMonad.Hooks.ManageDocks module to automatically handle screen placement for xmobar, and enables 'mod-b' for toggling the menu bar.

This function works like xmobarProp, but uses pipes instead of property-based logging.

Like statusBarProp, but uses pipes instead of property-based logging. Only use this function if your status bar does not support reading from a property of the root window.

Run xmonad with a dzen status bar set to some nice defaults.

main = xmonad =<< dzen myConfig

myConfig = def { ... }

This works pretty much the same as the xmobar function.

Run xmonad with a dzen status bar with specified dzen command line arguments.

main = xmonad =<< dzenWithFlags flags myConfig

myConfig = def { ... }

flags = "-e onstart lower -w 800 -h 24 -ta l -fg #a8a3f7 -bg #3f3c6d"

This function works much in the same way as the dzen function, only that it can also be used to customize the arguments passed to dzen2, e.g changing the default width and height of dzen2.

You should use this function only when the default dzen function does not serve your purpose.

An example log hook, which prints status information to stdout in the default format:

1 2 [3] 4 7 : full : title

That is, the currently populated workspaces, the current workspace layout, and the title of the focused window.

To customize the output format, see dynamicLogWithPP.

Workspace logger with a format designed for Xinerama:

[1 9 3] 2 7

where 1, 9, and 3 are the workspaces on screens 1, 2 and 3, respectively, and 2 and 7 are non-visible, non-empty workspaces.

At the present time, the current layout and window title are not shown. The xinerama workspace format shown above can be (mostly) replicated using dynamicLogWithPP by setting ppSort to getSortByXineramaRule from XMonad.Util.WorkspaceCompare. For example,

def { ppCurrent = dzenColor "red" "#efebe7"
    , ppVisible = wrap "[" "]"
    , ppSort    = getSortByXineramaRule
    }

Write a string to the _XMONAD_LOG property on the root window.

Write a string to a property on the root window. This property is of type UTF8_STRING.

The default property xmonad writes to. (_XMONAD_LOG).

Format the current status using the supplied pretty-printing format, and write it to stdout.

The same as dynamicLogWithPP, except it simply returns the status as a formatted string without actually printing it to stdout, to allow for further processing, or use in some application other than a status bar.

The PP type allows the user to customize the formatting of status information.

The default value for this type.

Settings to emulate dwm's statusbar, dzen only.

Some nice xmobar defaults.

The options that sjanssen likes to use with xmobar, as an example. Note the use of xmobarColor and the record update on def.

The options that byorgey likes to use with dzen, as another example.

Wrap a string in delimiters, unless it is empty.

Pad a string with a leading and trailing space.

Trim leading and trailing whitespace from a string.

Limit a string to a certain length, adding "..." if truncated.

Limit a string to a certain length, adding end if truncated.

Like shorten, but truncate from the left instead of right.

Like shorten', but truncate from the left instead of right.

Use xmobar escape codes to output a string with given foreground and background colors.

Encapsulate text with an action. The text will be displayed, and the action executed when the displayed text is clicked. Illegal input is not filtered, allowing xmobar to display any parse errors. Uses xmobar's new syntax wherein the command is surrounded by backticks.

Use xmobar box to add a border to an arbitrary string.

Encapsulate arbitrary text for display only, i.e. untrusted content if wrapped (perhaps from window titles) will be displayed only, with all tags ignored. Introduced in xmobar 0.21; see their documentation. Be careful not to shorten the result.

Strip xmobar markup, specifically the <fc>, <icon> and <action> tags and the matching tags like </fc>.

Use dzen escape codes to output a string with given foreground and background colors.

Escape any dzen metacharacters.

Strip dzen formatting or commands.

Transforms a pretty-printer into one not displaying the given workspaces.

For example, filtering out the NSP workspace before giving the PP to dynamicLogWithPP:

logHook = dynamicLogWithPP . filterOutWsPP [scratchpadWorkspaceTag] $ def

Here is another example, when using XMonad.Layout.IndependentScreens. If you have handles hLeft and hRight for bars on the left and right screens, respectively, and pp is a pretty-printer function that takes a handle, you could write

logHook = let log screen handle = dynamicLogWithPP . filterOutWsPP [scratchpadWorkspaceTag] . marshallPP screen . pp $ handle
          in log 0 hLeft >> log 1 hRight

Format the workspace information, given a workspace sorting function, a list of urgent windows, a pretty-printer format, and the current WindowSet.