WebKit-based status bar for tiling window managers.
Switch branches/tags
Nothing to show
Clone or download
Lokaltog core: Use correct screen Y offset when positioning bar
When using offset monitors the bar would incorrectly be positioned
outside of the monitor. When offsetting a monitor by e.g. +0+100, the
coordinates of the upper left corner of the monitor are (0, 100) and not
(0, 0) which was previously assumed when setting the bar position.

This update fixes the issue by considering *both* the `dest.x` and
`dest.y` coordinates from `gdk_screen_get_monitor_geometry()` as the
upper left corner of the monitor.
Latest commit e81b66a Sep 28, 2015

README.asciidoc

candybar(1)

Name

candybar - WebKit-based status bar for tiling window managers

Synopsis

candybar [-d] [-c config-file] [-h height] [-m monitor] [-p position] [-t theme-uri]

Description

candybar displays a HTML-based status bar in a WebKit web view. It provides a smooth looking status bar with CSS transitions and effects, and the possibility of having a transparent background with effects without a desktop compositor running.

Screenshots are available on the candybar wiki.

Options

-d

Enable debugging mode and display the WebKit inspector window on launch.

-c config-file

Read configuration options from the specified config-file. config-file overrides CANDYBAR_CONFIG_PATH and any system-wide and per-user configuration files. The file must exist and be valid JSON.

-h height

Set the height of the status bar in pixels.

-m monitor

Define which monitor the status bar appears on.

-p position

Set the status bar position. Valid options are top and bottom.

-t theme-uri

Set the URI for a theme HTML file. Must be a valid URI, i.e. local files must be prefixed with file://.

Window manager support

bspwm

supported; requires bspwm to be configured to reserve space with bspc config top_padding 24.

dwm

supported; requires the dwm built-in bar to be enabled and set to the same position and height as candybar, candybar will be placed on top of the dwm bar.

i3

supported; desktop support requires the desktops_i3 widget to be enabled instead of the default desktops widget for desktop list support.

monsterwm

supported

qtile

supported; requires a recent version, support for desktop EWMH properties was implemented in qtile revision 02fd471.

Files

~/.config/candybar/config.json

Per-user configuration file. See candybar(5) for further details.

/etc/xdg/candybar/config.json

System-wide configuration file. See candybar(5) for further details.

Environment

CANDYBAR_CONFIG_PATH

Full path of an alternate config.json file. This variable overrides any system-wide and per-user configuration files, but does not override the -c command-line argument. The file must exist and be valid JSON.

Authors

Kim Silkebækken <kim@silkebaekken.no>

See https://github.com/Lokaltog/candybar/graphs/contributors for a list of all contributors.

See also

candybar(5)