Skip to content
A gtk based status bar for tiling window managers such as XMonad
Branch: master
Clone or download
Latest commit eb9f7b9 Apr 29, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github/ISSUE_TEMPLATE Add ask for help non-template Jun 18, 2018
app typo fix: this is taffybar, not gtk-sni-tray Aug 14, 2018
dbus-xml Rewrite Battery Information and Textual Battery May 13, 2018
doc Update screenshot May 11, 2018
icons Show player icons in MPRIS2 Widget May 5, 2018
nix Building with ghc-8.2.2 on nix Sep 7, 2018
src/System Merge pull request #449 from u11gh/fix#420 Apr 28, 2019
.dockerignore Update dockerignore May 10, 2018
.gitignore Ignore build-docs Feb 10, 2019
.travis.yml Disable ghc 8.0 build Jan 11, 2019
CHANGELOG.md Document fixes of issues #261 and #420 Apr 29, 2019
Dockerfile Remove old source directory in docker build Jun 4, 2018
Dockerfile.base Add apt dependencies to base docker image Apr 23, 2018
LICENSE Add license badge Apr 12, 2018
README.md Add link to FAQ issue in README Mar 18, 2019
Setup.hs Initial import Aug 12, 2011
default.nix Nix: re-use the nixpkgs provided wrapper Sep 22, 2018
my-taffybar.cabal.example Remove references to gtk-traymanager Jan 10, 2019
quick-start.sh Fix links to point to taffybar/taffybar github Apr 27, 2018
stack-11.22.yaml Bump to gi-gdkpixbuf-2.0.18 Jan 18, 2019
stack-8.0.yaml Add broadcast-chan to all stack-8.?.yaml Mar 25, 2019
stack-8.2.yaml Add broadcast-chan to all stack-8.?.yaml Mar 25, 2019
stack-8.4.yaml Add broadcast-chan to all stack-8.?.yaml Mar 25, 2019
stack-8.6.yaml Use hackage release of broadcast-chan Mar 31, 2019
stack.yaml Add stack-8.6 yaml file Dec 8, 2018
stack.yaml.example Bump to gi-gdkpixbuf-2.0.18 Jan 18, 2019
taffybar.cabal Add new widget SimpleCommandButton Apr 28, 2019
taffybar.css Set all: unsert; Jun 16, 2018
taffybar.hs.example Refactor SimpleClock to allow for rounded polling Feb 27, 2019
xmonad.hs.example Update comments in xmonad example Dec 13, 2018

README.md

Taffybar Hackage Commits Build Status Help Wanted Gitter chat License BSD3

https://github.com/taffybar/taffybar/blob/master/doc/screenshot.png

Taffybar is a gtk+3 (through gi-gtk) based 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 eye candy.

Prerequisites

Taffybar has a number of non-haskell dependencies. It is recommended that you follow the installation instructions for haskell-gi before attempting to install taffybar.

In addition the the dependencies needed by haskell-gi, taffybar also needs the equivalent of libdbusmenu-gtk3-dev and libgirepository1.0-dev on Debian.

Installation

Taffybar itself can be installed in a number of different ways:

Stack

Though it is admittedly a bit complicated to set up properly, using stack is the preferred approach for installing taffybar, because it makes the build process stable and repeatable. Even if you are unfamiliar with stack, or even haskell in general, you should be able to get things working by using the taffybar's quick-start script:

curl -sSL https://raw.githubusercontent.com/taffybar/taffybar/master/quick-start.sh | bash

This script will clone the taffybar repository into a subdirectory of the default taffybar configuration directory, and copy the example cabal, stack and taffybar.hs files into the same location. It will then install a binary my-taffybar to $HOME/.local/bin, which can be executed to run taffybar. Note that with this approach, running the taffybar binary WILL NOT work; you must run the binary that is produced by the stack build in your local directory. The name of the binary can be changed in the cabal file in the taffybar configuration directory.

Running with stack

When you build with stack, it is recommended that you start taffybar with startTaffybar rather than dyreTaffybar, and use https://github.com/yamadapc/stack-run to execute the custom executable specified by your cabal and stack files. The maintainers have plans for a better solution (that does not require the user to use stack-run themselves) in #158.

Cabal

Cabal installation is a simple matter of installing taffybar from hackage:

cabal install taffybar

Configuration

Like xmobar and XMonad, taffybar is configured in haskell. Taffybar depends on dyre to automatically detect changes to its configuration file ($XDG_CONFIG_HOME/taffybar/taffybar.hs) and recompile when appropriate.

For more details about how to configure taffybar, see the full documentation. You can find a list of available widgets here

FAQ

For the time being, taffybar's frequently asked questions page lives in this github issue.

Contributing

Taffybar desperately needs contributors. If you want to help, but don't know where to get started you can check out our "help wanted" and "easy" labels:

Help Wanted Help Wanted

You can’t perform that action at this time.