Taffybar

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.

Taffybar also supports running under Wayland via gtk-layer-shell. Wayland support is currently compositor-specific for some widgets, with Hyprland workspaces, windows, and layout widgets available. Many widgets still rely on X11/EWMH, so check the widget docs and examples (including example/taffybar-wayland.hs) for what works on your setup.

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

  

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