Hackage :: [Package]

taffybar: A desktop bar similar to xmobar, but with more GUI

[ bsd3, library, program, system ] [ Propose Tags ] [ Report a vulnerability ]

Taffybar is a desktop status bar with GTK widgets for window manager state, system information, tray icons, and custom user modules.

[Skip to Readme]

Modules

[Last Documentation]

  • System
    • System.Taffybar
      • System.Taffybar.Auth
      • System.Taffybar.Context
        • System.Taffybar.Context.Backend
      • System.Taffybar.DBus
        • System.Taffybar.DBus.Toggle
      • System.Taffybar.Example
      • System.Taffybar.Hooks
      • System.Taffybar.Hyprland
      • Information
        • System.Taffybar.Information.ASUS
        • System.Taffybar.Information.AnthropicUsage
        • System.Taffybar.Information.Audio
        • System.Taffybar.Information.Backlight
        • System.Taffybar.Information.Battery
        • System.Taffybar.Information.Bluetooth
        • System.Taffybar.Information.CPU2
        • System.Taffybar.Information.Chrome
        • System.Taffybar.Information.ChromeWindowInfo
        • System.Taffybar.Information.Crypto
        • System.Taffybar.Information.DiskIO
        • System.Taffybar.Information.DiskUsage
        • System.Taffybar.Information.EWMHDesktopInfo
        • System.Taffybar.Information.Hyprland
        • System.Taffybar.Information.HyprlandWorkspaceHistory
        • System.Taffybar.Information.Inhibitor
        • System.Taffybar.Information.KeyboardState
        • Layout
          • System.Taffybar.Information.Layout.EWMH
          • System.Taffybar.Information.Layout.Hyprland
          • System.Taffybar.Information.Layout.Model
        • System.Taffybar.Information.MPRIS2
        • System.Taffybar.Information.Memory
        • System.Taffybar.Information.Network
        • System.Taffybar.Information.NetworkManager
        • System.Taffybar.Information.OpenAIUsage
        • System.Taffybar.Information.PowerProfiles
        • System.Taffybar.Information.Privacy
        • System.Taffybar.Information.PulseAudio
        • System.Taffybar.Information.SafeX11
        • System.Taffybar.Information.ScreenLock
        • System.Taffybar.Information.StreamInfo
        • System.Taffybar.Information.Systemd
        • System.Taffybar.Information.Temperature
        • System.Taffybar.Information.Wakeup
        • System.Taffybar.Information.WirePlumber
        • System.Taffybar.Information.Wlsunset
        • Workspaces
          • System.Taffybar.Information.Workspaces.EWMH
          • System.Taffybar.Information.Workspaces.Hyprland
          • System.Taffybar.Information.Workspaces.Model
          • System.Taffybar.Information.Workspaces.Refresh
        • System.Taffybar.Information.X11DesktopInfo
        • XDG
          • System.Taffybar.Information.XDG.Protocol
      • System.Taffybar.LogFormatter
      • System.Taffybar.LogLevels
      • System.Taffybar.SimpleConfig
      • Support
        • System.Taffybar.Support.PagerHints
      • System.Taffybar.Util
      • System.Taffybar.Widget
        • System.Taffybar.Widget.ASUS
        • System.Taffybar.Widget.AnthropicUsage
        • System.Taffybar.Widget.Audio
        • System.Taffybar.Widget.Backlight
        • System.Taffybar.Widget.Battery
        • System.Taffybar.Widget.BatteryDonut
        • System.Taffybar.Widget.BatteryTextIcon
        • System.Taffybar.Widget.Bluetooth
        • System.Taffybar.Widget.CPUMonitor
        • System.Taffybar.Widget.CommandRunner
        • System.Taffybar.Widget.CoordinatedClock
        • System.Taffybar.Widget.Crypto
        • System.Taffybar.Widget.DiskIOMonitor
        • System.Taffybar.Widget.DiskUsage
        • System.Taffybar.Widget.FSMonitor
        • System.Taffybar.Widget.FreedesktopNotifications
        • Generic
          • System.Taffybar.Widget.Generic.AutoFillImage
          • System.Taffybar.Widget.Generic.AutoSizeImage
          • System.Taffybar.Widget.Generic.ChannelGraph
          • System.Taffybar.Widget.Generic.ChannelWidget
          • System.Taffybar.Widget.Generic.DynamicMenu
          • System.Taffybar.Widget.Generic.Graph
          • System.Taffybar.Widget.Generic.Icon
          • System.Taffybar.Widget.Generic.PollingBar
          • System.Taffybar.Widget.Generic.PollingGraph
          • System.Taffybar.Widget.Generic.PollingLabel
          • System.Taffybar.Widget.Generic.ScalingImage
          • System.Taffybar.Widget.Generic.VerticalBar
        • System.Taffybar.Widget.HyprlandLayout
        • System.Taffybar.Widget.ImageCommandButton
        • System.Taffybar.Widget.Inhibitor
        • System.Taffybar.Widget.KeyboardState
        • System.Taffybar.Widget.Layout
        • System.Taffybar.Widget.MPRIS2
        • System.Taffybar.Widget.NetworkGraph
        • System.Taffybar.Widget.NetworkManager
        • System.Taffybar.Widget.OmniMenu
        • System.Taffybar.Widget.OpenAIUsage
        • System.Taffybar.Widget.PowerProfiles
        • System.Taffybar.Widget.Privacy
        • System.Taffybar.Widget.PulseAudio
        • System.Taffybar.Widget.SNIMenu
        • System.Taffybar.Widget.SNITray
          • System.Taffybar.Widget.SNITray.PrioritizedCollapsible
        • System.Taffybar.Widget.ScreenLock
        • System.Taffybar.Widget.SimpleClock
        • System.Taffybar.Widget.SimpleCommandButton
        • System.Taffybar.Widget.Systemd
        • System.Taffybar.Widget.Temperature
        • Text
          • System.Taffybar.Widget.Text.CPUMonitor
          • System.Taffybar.Widget.Text.MemoryMonitor
          • System.Taffybar.Widget.Text.NetworkMonitor
        • System.Taffybar.Widget.Util
        • System.Taffybar.Widget.WakeupDebug
        • System.Taffybar.Widget.Weather
        • System.Taffybar.Widget.Windows
        • System.Taffybar.Widget.WirePlumber
        • System.Taffybar.Widget.Wlsunset
        • System.Taffybar.Widget.Workspaces
        • System.Taffybar.Widget.WttrIn
        • XDGMenu
          • System.Taffybar.Widget.XDGMenu.Menu
          • System.Taffybar.Widget.XDGMenu.MenuWidget
      • System.Taffybar.WindowIcon

Flags

Automatic Flags
NameDescriptionDefault
deprecated-pager-hints

Enables the deprecated System.Taffybar.Support.PagerHints module, which has been moved to xmonad-contrib.

Enabled

Use -f <flag> to enable a flag, or -f -<flag> to disable that flag. More info

Downloads

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees

Candidates

Versions [RSS] 0.1.0, 0.1.1, 0.1.2, 0.1.3, 0.2.0, 0.2.1, 0.3.0, 0.4.0, 0.4.1, 0.4.2, 0.4.3, 0.4.4, 0.4.5, 0.4.6, 1.0.0, 1.0.1, 1.0.2, 2.0.0, 2.1.0, 2.1.1, 2.1.2, 3.0.0, 3.1.0, 3.1.1, 3.1.2, 3.2.0, 3.2.1, 3.2.2, 3.2.3, 3.2.4, 3.2.5, 3.3.0, 4.0.0, 4.0.1, 4.0.2, 4.0.3, 4.1.0, 4.1.1, 4.1.2, 5.0.0, 5.1.0, 5.1.1, 5.1.2, 5.1.3, 5.2.0, 5.2.1, 6.0.0, 7.0.0, 7.0.1, 7.1.0, 7.2.0, 7.2.1, 7.2.2 (info)
Change log CHANGELOG.md
Dependencies aeson (>=1.4 && <2.3), ansi-terminal (>=0.10 && <1.2), attoparsec (>=0.13 && <0.15), base (>=4.15.0.0 && <5), bytestring (>=0.10 && <0.13), conduit (>=1.3 && <1.4), containers (>=0.5 && <0.8), data-default (>=0.7 && <0.9), dbus (>=1.2.11 && <2), dbus-hslogger (>=0.1.1.1 && <0.2), dbus-menu (>=0.1.3.3 && <0.2), dhall (>=1.40 && <1.43), directory (>=1.3 && <1.4), disk-free-space (>=0.1.0.1 && <0.2), dyre (>=0.9.0 && <0.10), either (>=4.0.0.0 && <5.1), enclosed-exceptions (>=1.0.0.1 && <1.1), extra (>=1.7 && <1.9), filepath (>=1.4 && <1.6), fsnotify (>=0.4 && <0.5), gi-cairo-connector (>=0.1 && <0.2), gi-cairo-render (>=0.1 && <0.2), gi-gdk3 (>=3.0.30 && <3.1), gi-gdkpixbuf (>=2.0.6 && <2.1), gi-gdkx113 (>=3.0.17 && <4), gi-glib (>=2.0 && <2.1), gi-gobject (>=2.0 && <2.1), gi-gtk-hs (>=0.3.17 && <0.4), gi-gtk-layer-shell (>=0.1.7 && <0.2), gi-gtk3 (>=3.0.44 && <4), gi-pango (>=1.0 && <1.1), gi-wireplumber (>=0.5.14.2 && <0.6), gtk-scaling-image (>=0.1.0.1 && <0.2), gtk-sni-tray (>=0.2.1.2 && <0.3), gtk-strut (>=0.1.4.1 && <0.2), haskell-gi-base (>=0.24 && <0.27), hslogger (>=1.2 && <1.4), hspec (>=2.8 && <3), HStringTemplate (>=0.8 && <0.9), http-client (>=0.5 && <0.8), http-client-tls (>=0.3 && <0.4), http-conduit (>=2.3 && <2.4), http-types (>=0.12 && <0.13), JuicyPixels (>=3.3 && <3.4), monad-control (>=1.0 && <1.1), multimap (>=1.2.1 && <1.3), network (>=3.1 && <3.3), optparse-applicative (>=0.17 && <0.20), parsec (>=3.1 && <3.2), process (>=1.0.1.1 && <1.7), QuickCheck (>=2 && <2.17), rate-limit (>=1.1.1 && <1.5), regex-compat (>=0.95 && <0.96), safe (>=0.3 && <1), scotty (>=0.20 && <0.31), split (>=0.1.4.2 && <0.3), status-notifier-item (>=0.3.2.14 && <0.4), stm (>=2.5 && <2.6), taffybar, template-haskell (>=2.17 && <2.24), text (>=1.2 && <2.2), time (>=1.9 && <2), time-locale-compat (>=0.1 && <0.2), time-units (>=1.0.0 && <1.1), transformers (>=0.3.0.0 && <0.7), tuple (>=0.3.0.2 && <0.4), typed-process (>=0.2 && <0.3), unix (>=2.7 && <2.9), unliftio (>=0.2 && <0.3), unliftio-core (>=0.2 && <0.3), utf8-string (>=1.0 && <1.1), X11 (>=1.5.0.1 && <1.11), xdg-basedir (>=0.2 && <0.3), xdg-desktop-entry (>=0.1.1.5 && <0.2), xml (>=1.3 && <1.4), xml-helpers (>=1.0 && <1.1), xmonad (>=0.17 && <0.19), xmonad-contrib (>=0.17 && <0.19), yaml (>=0.11 && <0.12) [details]
Tested with ghc ==9.8.4, ghc ==9.10.3, ghc ==9.12.3
License BSD-3-Clause
Author Ivan Malison
Maintainer IvanMalison@gmail.com
Uploaded by eyevanmalicesun at 2026-05-13T17:12:53Z
Category System
Home page https://github.com/taffybar/taffybar
Source repo head: git clone https://github.com/taffybar/taffybar.git
Distributions Arch:4.1.0, Stackage:6.0.0
Reverse Dependencies 1 direct, 0 indirect [details]
Executables taffybar-appearance-snap-hyprland, taffybar-appearance-snap, taffybar-test-wm, taffybar
Downloads 22846 total (136 in the last 30 days)
Rating 2.0 (votes: 1) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs pending
Build status unknown [no reports yet]

Readme for taffybar-7.2.2

[back to package description]

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.

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.

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.