WebKit-based status bar for tiling window managers.
C Python
Switch branches/tags
Nothing to show
Latest commit e81b66a Sep 28, 2015 @Lokaltog 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.
Permalink
Failed to load latest commit information.
docs widgets/desktops: Allow hiding empty desktops on desktops widget Apr 20, 2015
src core: Use correct screen Y offset when positioning bar Sep 28, 2015
.gitignore waf: add waf binary to repo to avoid having it as a build dependency Mar 9, 2014
.uncrustify.cfg uncrustify: update rules Mar 6, 2014
CONTRIBUTING.asciidoc docs: Add info for contributing to the project May 1, 2014
LICENSE Update author e-mail address Jun 27, 2014
README.asciidoc
waf waf: add waf binary to repo to avoid having it as a build dependency Mar 9, 2014
wscript process: Uncrustify code and convert to snake_case Jun 27, 2014

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)