Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
WebKit-based status bar for tiling window managers.
C Python
Branch: develop

widgets/desktops: Allow hiding empty desktops on desktops widget

Configurable with a "show_empty" configuration option to desktops
widget. Defaults to "true", so if the user does not touch the default
config, the default behaviour is maintained.

Fixes #102
Closes #103
latest commit d23f877f15
@Eloi Eloi authored committed

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)

Something went wrong with that request. Please try again.