# 4.1.1

## Improvements

 * Add [`pollingLabelWithVariableDelayAndRefresh`][pollingLabelWithVariableDelayAndRefresh]. The [`WttrIn`][WttrIn] widget uses this.

[pollingLabelWithVariableDelayAndRefresh]: https://hackage.haskell.org/package/taffybar-4.1.1/docs/System-Taffybar-Widget-Generic-PollingLabel.html#v:pollingLabelWithVariableDelayAndRefresh

[WttrIn]: https://hackage.haskell.org/package/taffybar-4.1.1/docs/System-Taffybar-Widget-WttrIn.html

## Breaking Changes

 * Use version-named package build dependencies. Users building their
   configurations with Stack or Nix may need to do likewise. That is,
   change:
    - `gi-gtk` → `gi-gtk3`
    - `gi-gdk` → `gi-gdk3`
    - `gi-gdkx11` → `gi-gdkx113`

 * Taffybar is tested with GHC versions 9.8 and 9.10.
   Other versions may or may not work.


# 4.1.0

## Breaking Changes

 * The [`BroadcastChan`][broadcast-chan] dependency has not received
   Cabal revisions for a while, so is replaced with [`Control.Concurrent.STM.TChan`][tchan].
   Some types in `System.Taffybar.Hooks` and `System.Taffybar.Information.{Battery,Chrome,Crypto}` change accordingly.

[broadcast-chan]: https://hackage.haskell.org/package/broadcast-chan
[tchan]: https://hackage.haskell.org/package/stm-2.5.1.0/docs/Control-Concurrent-STM-TChan.html

## Improvements

 * Add icon next to window label in Windows widget. This can be configured
   with [`WindowsConfig(getActiveWindowIconPixbuf)`][WindowsConfig].

 * Taffybar now watches its CSS files with inotify. Changes to CSS
   should be visible immediately after saving the file.

   If Taffybar is not running in a terminal, and the process receives
   a `SIGHUP` signal, then it will restart the inotify instance and
   reload the CSS files.

[WindowsConfig]: https://hackage.haskell.org/package/taffybar-4.1.0/docs/System-Taffybar-Widget-Windows.html#t:WindowsConfig


# 4.0.3

## Breaking Changes

 * Taffybar is tested with GHC versions >= 9.2 && < 9.10.
   Other versions may or may not work.

 * The following symbols have been deprecated (not removed):
    - `System.Taffybar.SimpleConfig.toTaffyConfig` -
      Use [`toTaffybarConfig`][toTaffybarConfig] instead.
    - `System.Taffybar.Support.PagerHints` -
      Use the [`XMonad.Hooks.TaffybarPagerHints`][TaffybarPagerHints] module instead.
    - `System.Taffybar.Util`:
        * `liftReader` - Use [`Control.Monad.Trans.Reader.mapReaderT`][mapReaderT] instead.
        * `logPrintFDebug` -  Use [`logPrintF`][logPrintF] instead.
        * `(??)` - Use `f <*> pure a` instead.
        * `runCommandFromPath` - Use [`runCommand`][runCommand] instead.

[toTaffybarConfig]: https://hackage.haskell.org/package/taffybar-4.0.3/docs/System-Taffybar-SimpleConfig.html#v:toTaffybarConfig
[TaffybarPagerHints]: https://hackage.haskell.org/package/xmonad-contrib-0.18.1/docs/XMonad-Hooks-TaffybarPagerHints.html
[mapReaderT]: https://hackage.haskell.org/package/transformers-0.6.1.0/docs/Control-Monad-Trans-Reader.html#v:mapReaderT
[logPrintF]: https://hackage.haskell.org/package/taffybar-4.0.3/docs/System-Taffybar-Util.html#v:logPrintF
[runCommand]: https://hackage.haskell.org/package/taffybar-4.0.3/docs/System-Taffybar-Util.html#v:runCommand

## Improvements

 * Revise and expand documentation.

 * Some code cleanups such as applying HLint suggestions, fixing
   compiler warnings, cleaning module imports.

 * The Nix code for `flake.nix` was streamlined, because upstream
   nixpkgs already contains the necessary derivation overrides.

## Bug Fixes

 * Fix handling of Ctrl-C.

 * Improve logging in [`System.Taffybar.Information.Battery`](https://hackage.haskell.org/package/taffybar-4.0.3/docs/System-Taffybar-Information-Battery.html)
   and [`System.Taffybar.WindowIcon`](https://hackage.haskell.org/package/taffybar-4.0.3/docs/System-Taffybar-WindowIcon.html).


# 4.0.2

 * Taffybar can now build with GHC 9.6.

 * Allow building with Scotty 0.22.

 * Drop unused `ConfigFile` dependency.


# 4.0.1

## Improvements

 * Taffybar can now build with GHC 9.4.

 * Adds a `flake.nix`.

## Bug Fixes

 * `Gtk.widgetShowAll` is run on the widget created by `cryptoPriceLabelWithIcon`,
   so that it shows up by default.

 * Fix misleading precision of rgba() parameters in `taffybar.css`.

 * Remove `cryptocurrency` Cabal flag, which is now unnecessary.


# 4.0.0

## Breaking Changes

 * `simpleTaffybar` now starts taffybar using `startTaffybar` instead of
   `dyreTaffybar`. Use `simpleDyreTaffybar` to start taffybar with
   `dyreTaffybar` as before.

 * The `cssPath` fields in 'SimpleTaffyConfig' and 'TaffybarConfig' have been
   renamed to `cssPaths` and have type `[FilePath]` instead of `Maybe Filepath`.

 * The module `System.Taffybar.Widget.Decorators` has been removed. The
   functions that were in that module can now be found in
   `System.Taffybar.Widget.Util`.

 * The `barHeight` property of `SimpleTaffyConfig` is now a `StrutSize`. This
   means that in addition to specifying an exact pixel count for the height of
   taffybar, it is also possible to specify a fraction of the screen that it
   should occupy. See the docs for `StrutSize` for more details.

## New Features

 * A new module `System.Taffybar.Widget.Crypto` that contains widgets that display
   the prices of crypto assets with icons was added.

 * `textBatteryNewLabelAction` provides a version of the text battery widget to
   which a custom label updater function can be provided.

 * The textual battery widget now applies classes according to its charge level
   that can be used to style the battery text with css.

 * A generalized interface to the text battery widget that accepts an arbitrary
   update function is available at `textBatteryNewLabelAction`.

 * New workspace widget builder `buildLabelOverlayController` that overlays the
   workspace label on top of the the workspace icons.

 * It is now possible to customize the player widgets of the MPRIS2 Widget by
   using the new function `mpris2NewWithConfig`.

 * Classes are added to the MPRIS2 Widget to indicate whether or not it has
   visible player children.

 * The default MPRIS2 player widget now sends the play pause message to the
   relevant player when clicked.

 * New `pollingGraphNewWithTooltip` that allows to specify a tooltip.

 * New `networkGraphNewWith` that allows to configure a tooltip format, scaling
   and network interfaces via function.

 * New `showMemoryInfo` exposed from `MemoryMonitor` that can be used to format
   tooltips.

 * Swap variables are added to `MemoryMonitor`.

 * Many types have `Default` instances.

 * Window titles are shown on hover.

 * Allow sorting workspace window icons by _NET_CLIENT_LIST_STACKING.

## Changes

 * Graph labels are now overlayed on top of the graph instead of placed beside
   them.

 * MPRIS2 Widgets will remain visible when their players are in the paused state.

 * `getSongInfo` now doesn't automatically return `Nothing` when `xesam:artist`
   is missing. This makes the MPRIS2 Widget display in more situations than
   before.

 * Network graph will have a tooltip by default.

 * The SNI Tray will respect `ItemIsMenu` property to handle mouse left click.

## Bug Fixes

 * Center widgets will now properly expand vertically.

 * Errors, including icon missing from theme errors, in workspace pixbuf getters
   are now handled gracefully.

 * A workaround to properly display the chrome icon in MPRIS was added.

# 3.3.0

## Bug Fixes

 * Compatibility with newer versions of GHC.

## New Features

 * A wttr.in widget was added.

 * Make memoryAvailable action available inside the Text MemoryMonitor widget.

 * The SNI Tray supports triggering Activate and SecondaryActivate on icons.

 * Better formatting for Text MemoryMonitor Widget

# 3.2.2

## Bug Fixes

 * Solve space leaks on `updateSamples` and `getDeviceUpDown` (#472).

 * Prevent crash when using mpris2New and librsvg is not available (#478).

 * Fixed compilation issues that appear when using ghc 8.8.

# 3.2.1

## Bug Fixes

 * The workspaces widget now listens on the additional EWMH properties that it
   needs to in order to properly update things when the active window changes.
   This problem likely only emerged recently because xmonad has recently become
   much more conservative about emitting change events (#454).

 * The workspaces widget listens for changes to window geometry (similar to
   above) (#456).

# 3.2.0

## New Features

 * The Layout widget can now be styled with the css class "layout-label".

 * A new polling label function `pollingLabelWithVariableDelay` that allows for
   variable poll times was added.

 * A new widget `System.Taffybar.Widget.SimpleCommandButton` was added.

 * Taffybar now outputs colorized and annotated logs by default.

## Breaking Changes

 * The file specified in the cssPath parameter in config is now used instead of,
   rather than in addition to the default user config file.

 * All parameters are now passed to `textClockNewWith` as part of the
   ClockConfig it receives. A new mechanism for rounded variable polling should
   allow the clock to always remain accurate (to the precision selected by the
   user) without having a very high polling rate, thus reducing CPU usage.

 * The polling label functions no longer accept a default text parameter.

## Miscellaneous

 * Battery updates are only triggered when a more limited number of UPower
   properties are changed. This can be customized by manually calling
   `setupDisplayBatteryChanVar` as a hook.

## Bug Fixes

 * Calendar pops up below bar without hiding any other widget #261.

 * Avoid failing when parsing XDG Desktop files with unrecognized application
   type, which previously resulted in "Prelude.read: no parse" #447.

 * Use XDG data dir so that taffybar dbus toggling functions correctly when
   taffybar is installed in a location that is not writable by the user. This is
   the case with nix when it is installed in the nix store #452.

# 3.1.2

## Updates

 * Weather now uses new uris and https (Kirill Zaborsky)

 * Bump the version of gi-gdkpixbuf, this fixes nixpkgs compilation

# 3.1.0

## New Features

 * A new module Chrome which makes it so that Workspaces can display the
   favicons of the website that the chrome window is currently visiting.

# 3.0.0

## Breaking Changes

 * Taffybar has replaced gtk2hs with gi-gtk everywhere. All widgets must now be
   created with gi-gtk.

# 2.0.0

## Breaking Changes

 * An entirely new config system has been put in place. TaffybarConfig now lives
   in System.Taffybar.Context, but for most users, System.Taffybar.SimpleConfig
   is the configuration interface that should be used.

 * The main entry point to taffybar is now dyreTaffybar instead of
   defaultTaffybar.

 * All widget constructors provided to both config systems must now be of type
   `TaffyIO Gtk.Widget`. If you have an existing `IO Gtk.Widget` you can convert it
   using liftIO. All widgets provided by taffybar are now of type
   `MonadIO m => m Gtk.Widget`, or specialized to `TaffyIO Gtk.Widgets`.

 * The `graphBackgroundColor` and `graphBorderColor` fields are now RGBA
   quadruples instead of RGB triples.

 * Module removals:

   - WorkspaceSwitcher: Workspaces is much more abstract and makes this widget
     redundant.
   - Pager: The Context module solves the problem that Pager solved in a much
     more general way. It also makes it so that the user doesn't even need to
     know about the Pager component at all.
   - TaffyPager: Since you no longer need to explicitly initialize a Pager, it's
     not really very hard to simply add the (Workspaces, Layout, Windows) triple
     to your config any more.
   - XMonadLog: This module has long been deprecated

 * Module moves:

   - Everything in System.Information has been moved to
     System.Information.Taffybar
   - All Widgets that were found in System.Taffybar have been moved to
     System.Taffybar.Widget
   - The helper widgets that were previously located in System.Taffybar.Widgets
     have been moved to System.Taffybar.Widget.Generic

 * Module renames:

	- WorkspaceHUD -> Workspaces
	- WindowSwitcher -> Windows
	- LayoutSwitcher -> Layout
	- ToggleMonitors -> DBus.Toggle

  * Module deprecations:

    - System.Taffybar.Widget.Systray (Use SNITray instead)
	- System.Taffybar.Widget.NetMonitor (Use
      System.Taffybar.Widget.Text.NetworkMonitor instead)

 * Many widgets have subtle interface changes that may break existing configurations.

## New Features

 * Widgets can now be placed in the center of taffybar with the `centerWidgets`
   configuration parameter.

 * taffybar is now transparent by default, but you will need to use a compositor
   for transparency to work. https://github.com/chjj/compton is recommended. If
   you do not want a transparent taffybar set a background color on the class
   `TaffyBox` in taffybar.css.

 * StatusNotifierItem support has been added to taffybar in the SNITray module.

 * Monitor configuration changes are handled automatically. Unfortunately the
   bar must be completely recreated when this happens.

 * New network monitor widgets `System.Taffybar.Widget.Text.NetworkMonitor`
   and `System.Taffybar.Widget.NetworkGraph` were added.

 * All widgets are now exported in `System.Taffybar.Widget`, which should
   eliminate the need to import widgets explicitly.

# 1.0.2

## Bug Fixes

 * Fix long standing memory leak that was caused by a failure to free memory
   allocated for gtk pixbufs.
 * Widgets unregister from X11 event listening.

# 1.0.0

## Breaking Changes

 * Migrate from Gtk2 to Gtk3, which replaces rc theming with css theming (Ivan Malison)

## New Features

 * Support for taffybar on multiple monitors (Ivan Malison)
 * D-Bus toggling of taffybar per monitor (Ivan Malison)
 * A new workspace switcher widget called WorkspaceHUD (Ivan Malison)
 * Support for multiple batteries via ``batteryContextsNew`` (Edd Steel)
 * Add support for IO actions to configure vertical bar widgets
 * Images in WorkspaceSwitcher - images are taken from EWMH via \_NET\_WM_ICON (Elliot Wolk)
 * Preliminary support for i3wm (Saksham Sharma)
 * Support for multiple network interfaces in NetMonitor (Robert Klotzner)
 * Add a pager config field that configures the construction of window switcher titles (Ivan Malison)
 * Quick start script for installing from git with stack (Ivan Malison)
 * Add a volume widget (Nick Hu and Abdul Sattar)
 * Add available memory field to MemoryInfo (Will Price)
 * The freedesktop.org notifications widget now allows for notifications to
   never expire and can handle multiple notifications at once. In particular the
   default formatter now shows the number of pending notifications (Daniel
   Oliveira)
 * Battery bar is more informative (Samshak Sharma)
 * Network monitor speeds are auto formatted to use the most appropriate units (TeXitoi)
 * A new freedesktop.org menu widget (u11gh)

...and many smaller tweaks.

## Bug Fixes

 * Fixes for outdated weather information sources
 * Various styling fixes in the gtkrc code
 * Share a single X11Connection between all components to fix the `user error
   (openDisplay)` error (Ivan Malison)
 * Call initThreads at startup. This fixes ```taffybar-linux-x86_64:
   xcb_io.c:259: poll_for_event: Assertion `!xcb_xlib_threads_sequence_lost'
   failed.``` (Ivan Malison)
 * Add an eventBox to window switcher to allow setting its background (Ivan Malison)
 * #105 Prevent taffybar from crashing when two windows are closed
   simultaneously, or when taffybar otherwise requests data about a window that
   no longer exists.

# 0.4.6

 * Fix a longstanding bug in loading .rc files (Peder Stray)
 * Add support for scrolling in the workspace switcher (Saksham Sharma)
 * Improve default formatting of empty workspaces in the pager (Saksham Sharma)
 * Relax gtk version bounds

# 0.4.5

 * GHC 7.10 compat

# 0.4.4

 * Fix compilation with gtk 0.13.1

# 0.4.3

 * Try again to fix the network dependency

# 0.4.2

 * Expand the version range for time
 * Depend on network-uri instead of network

# 0.4.1

 * Make the clock react to time zone changes

# 0.4.0

## Features

 * Resize the bar when the screen configuration changes (Robert Helgesson)
 * Support bypassing `dyre` by exposing `taffybarMain` (Christian Hoener zu Siederdissen)
 * Textual CPU and memory monitors (Zakhar Voit)
 * A new window switcher menu in the pager (José Alfredo Romero L)
 * Dynamic workspace support in the workspace switcher (Nick Hu)
 * More configurable network monitor (Arseniy Seroka)
 * New widget: text-based command runner (Arseniy Seroka)
 * The Graph widget supports lines graphs (via graphDataStyles) (Joachim Breitner)
 * Compile with gtk2hs 0.13

## Bug Fixes

 * Reduce wakeups by tweaking the default GHC RTS options (Joachim Breitner)
 * UTF8 fixes (Nathan Maxson)
 * Various fixes to EWMH support (José Alfredo Romero L)

## Deprecations

The `XMonadLog` module is deprecated.  This module let taffybar display XMonad desktop information through a dbus connection.  The EWMH desktop support by José Alfredo Romero L is better in every way, so that (through TaffyPager) is the recommended replacement.  Upgrading should be straightforward.


# 0.3.0:

 * A new pager (System.Taffybar.TaffyPager) from José A. Romero L.  This pager is a drop-in replacement for the dbus-based XMonadLog widget.  It communicates via X atoms and EWMH like a real pager.  It even supports changing workspaces by clicking on them.  I recommend this over the old widget.
 * Added an MPRIS2 widget (contributed by Igor Babuschkin)
 * Ported to use the newer merged dbus library instead of dbus-client/dbus-core (contributed by CJ van den Berg)
 * Finally have the calendar widget pop up over the date/time widget (contributed by José A. Romero)
 * GHC 7.6 compatibility
 * Vertical bars can now have dynamic background colors (suggested by Elliot Wolk)
 * Bug fixes

# 0.2.1:

 * More robust strut handling for multiple monitors of different sizes (contributed by Morgan Gibson)
 * New widgets from José A. Romero (network monitor, fs monitor, another CPU monitor)
 * Allow the bar widget to grow vertically (also contributed by José A. Romero)

# 0.2.0:

 * Add some more flexible formatting options for the XMonadLog widget (contributed by cnervi).
 * Make the PollingLabel more robust with an exception handler for IOExceptions
 * Added more documentation for a few widgets

# 0.1.3:

 * Depend on gtk 0.12.1+ to be able to build under ghc 7.2
 * Fix the background colors in the calendar so that it follows the GTK theme instead of the bar-specific color settings
 * Fix the display of non-ASCII window titles in the XMonad log applet (assuming you use the dbusLog function)
 * Add a horrible hack to force the bar to not resize to be larger than the screen due to notifications or long window titles

# 0.1.2:

 * Readable widget for freedesktop notifications
 * Fixed a few potential deadlocks on startup
 * Use the GTK+ rc-file styling system for colors instead of hard coding them
