tianbar: A desktop bar based on WebKit

[ library, mit, program, system ] [ Propose Tags ]

A desktop bar using WebKit for rendering as much as possible. Based on Taffybar.


[Skip to Readme]

Modules

[Index]

Downloads

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees

Candidates

  • No Candidates
Versions [RSS] 0.1.0.0, 0.1.1.0, 0.1.2.0, 0.1.3.0, 0.1.3.1, 0.2.0.0, 0.2.1.0, 0.2.2.0, 0.2.2.1, 0.3.0.0, 0.3.1.0, 0.3.2.0, 0.3.3.0, 0.3.4.0, 0.3.4.1, 0.3.5.0, 0.3.6.0, 0.4.0.0, 0.4.0.1, 0.4.1.0, 0.4.2.0, 0.4.3.0, 0.4.4.0, 0.4.5.0, 0.4.6.0, 0.4.6.3, 0.4.7.0, 0.4.8.0, 1.0.0.0, 1.0.1.0, 1.0.2.0, 1.0.3.0, 1.1.0.0, 1.1.0.1, 1.1.1.1, 1.2.0.0, 1.2.1.0, 1.2.2.0, 1.2.3.0, 1.2.4, 1.2.5
Dependencies aeson (>=0.6 && <0.7), base (>3 && <5), blaze-html (>=0.5 && <0.8), blaze-markup (>=0.5 && <0.7), containers (>=0.5 && <0.6), dbus (>=0.10.7 && <0.11), gtk (>=0.12 && <0.13), gtk-traymanager (>=0.1 && <0.2), happstack-server (>=7.3 && <7.4), MissingH (>=1.2 && <1.3), network (>=2.4 && <2.5), process (>=1.1 && <1.2), random (>=1.0 && <1.1), split (>=0.2 && <0.3), text (>=0.11 && <0.12), transformers (>=0.3 && <0.4), utf8-string (>=0.3 && <0.4), webkit (>=0.12 && <0.13), xdg-basedir (>=0.2 && <0.3), xmonad, xmonad-contrib [details]
License MIT
Author Alexey Kotlyarov
Maintainer a@koterpillar.com
Category System
Home page https://github.com/koterpillar/tianbar
Source repo head: git clone git://github.com/koterpillar/tianbar.git
Uploaded by AlexeyKotlyarov at 2014-04-13T06:39:06Z
Distributions
Reverse Dependencies 1 direct, 0 indirect [details]
Executables tianbar
Downloads 27471 total (82 in the last 30 days)
Rating (no votes yet) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs available [build log]
Successful builds reported [all 1 reports]

Readme for tianbar-0.4.0.1

[back to package description]

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.

Widgets

A small collection of widgets written in JavaScript is bundled with Tianbar, see scripts directory. To include them on your page, use tianbar:///data/ prefix, e.g. tianbar:///data/scripts/time.js.

Most widgets require third-party libraries such as jQuery and RequireJS, and neither of those is distributed with Tianbar -- see individual widget documentation and obtain the libraries manually.

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 through OpenWeatherMap. HTML geolocation API is required to determine the current location, see Quirks below.

XMonad

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

Quirks

  • AJAX requests from Tianbar are not subject to the same origin policy. This makes it easier to interact with various Web services. You can also make requests to the local files, for example, to extract CPU activity statistics from /proc/stat.
  • HTML5 geolocation API does not work. A shim, which uses freegeoip.net, is provided instead.
  • Interaction with the displayed Web page is limited. For example, text fields are not active if there are other windows on the screen.

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.