Readme for tianbar-0.4.6.3

Tianbar

Tianbar is a status bar for XMonad and possibly similar window managers. It is using WebKit as its rendering engine, meaning that the entire look and feel is customizable using HTML, CSS and JavaScript.

Screenshot - left part Screenshot - right part

Usage

Tianbar will show index.html from its XDG configuration directory (usually $HOME/.config/taffybar). It it up to you to create that, add styles, widgets and other behavior.

A small collection of widgets written in JavaScript is bundled with Tianbar, see scripts directory. Widgets are loaded using RequireJS, which, as well as jQuery and other libraries required, are bundled with Tianbar.

For an example of RequireJS configuration, see the example index.html.

Power

Displays the battery status for all the batteries reporting through UPower.

Time

Displays the time and date.

Volume

Displays the current PulseAudio volume. Note that module-cli-protocol-unix is required to be loaded.

Weather

Displays the weather at current location (determined via HTML geolocation API) through OpenWeatherMap.

XMonad

XMonad status widget works by listening on DBus for messages sent by the provided logHook, see System.Tianbar.XMonadLog documentation for details.

Quirks

Acknowledgements

The project is essentially a fork of Taffybar, stripped down of Haskell configuration and widgets and not yet having achieved functional parity with it.