https://github.com/koterpillar/tianbar

A status bar for XMonad using WebKit for rendering
https://github.com/koterpillar/tianbar

desktop html status-bar xmonad

Last synced: about 2 months ago
JSON representation

A status bar for XMonad using WebKit for rendering

• Host: GitHub
• URL: https://github.com/koterpillar/tianbar
• Owner: koterpillar
• License: mit
• Archived: true
• Created: 2013-05-12T05:45:43.000Z (about 11 years ago)
• Default Branch: master
• Last Pushed: 2024-02-17T11:10:49.000Z (5 months ago)
• Last Synced: 2024-04-26T18:21:49.528Z (2 months ago)
• Topics: desktop, html, status-bar, xmonad
• Language: Haskell
• Homepage:
• Size: 482 KB
• Stars: 30
• Watchers: 3
• Forks: 0
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Lists

• awesome-ricing - tianbar - A status bar for XMonad using WebKit for rendering. (Haskell) (Packages / Bars, Panels, and Widgets)
• awesome-statusbars - Tianbar - A status bar for XMonad using WebKit for rendering (Projects)

README

        
Tianbar

=======

[![Build status](https://img.shields.io/travis/aloetesting/aloe.svg)](https://travis-ci.org/aloetesting/aloe)

[![Hackage](https://img.shields.io/hackage/v/tianbar.svg)](http://hackage.haskell.org/package/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](tianbar.png)

Usage

-----

Tianbar will show `index.html` from its [XDG configuration directory][xdg]

(usually `$HOME/.config/tianbar`). 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][requirejs],

which, as well as [jQuery][jquery] and other libraries required, are bundled

with Tianbar.

For an example of RequireJS configuration, see the

[example index.html](index.html).

### IBus

Displays the status of IBus input method.

### Network

Displays the connection status from NetworkManager.

### 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-dbus-protocol`

is required to be available.

### Weather

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

through [OpenWeatherMap][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

------

* 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`.

* 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][taffybar], stripped down of

Haskell configuration and widgets and not yet having achieved functional parity

with it.

[freegeoip]: http://freegeoip.net/

[jquery]: http://jquery.com/

[openweathermap]: http://openweathermap.org/

[requirejs]: http://requirejs.org/

[taffybar]: https://github.com/travitch/taffybar

[xdg]: http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html