Skip to content

A gtk based status bar for tiling window managers such as XMonad

License

Notifications You must be signed in to change notification settings

taffybar/taffybar

Taffybar

Build Status Hackage Commits Stackage LTS Stackage Nightly Matrix Chat Gitter Chat License BSD3

Summary

Taffybar is a desktop information bar, intended primarily for use with XMonad, though it can also function alongside other EWMH compliant window managers. It is similar in spirit to xmobar, but it differs in that it gives up some simplicity for a reasonable helping of GTK 3 eye candy.

Screenshot

Taffybar is a library

As with window managers like XMonad and dwm, Taffybar is most appropriately described as a library that allows you to build an executable that is customized to your tastes. Like xmobar and XMonad, Taffybar is configured in Haskell.

Taffybar has a reasonably useful default configuration built in.

To use a different configuration, however, you must install a Haskell compiler (GHC) that can compile your taffybar.hs source file.

You then select from the list of available widgets for functionality to add to your Taffybar. If the widget you need doesn't exist, then create your own with GTK.

Documentation

  • Installation

    Taffybar can be installed from Linux distribution packages, or compiled from source.

  • Configuration (and compilation)

    Taffybar can recompile itself from taffybar.hs, similar to how XMonad recompiles itself from xmonad.hs.

    There are a number of ways to compile your configuration.

  • Customization

    Taffybar has a library of functions and widgets for collecting and displaying information.

    Many aspects of the bar's appearance can be changed using CSS.

  • Running

    Taffybar is one component of a desktop environment. To work correctly, it requires other desktop components and system services.

  • FAQ

    Assorted information.

  • Contributing

    Help Wanted Easy Issues

    Taffybar desperately needs contributors. There is plenty to do; enquire within.