Need help with candybar?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

Lokaltog
213 Stars 19 Forks Other 441 Commits 25 Opened issues

Description

WebKit-based status bar for tiling window managers.

Services available

!
?

Need anything else?

Contributors list

:man source: candybar :man version: {revnumber} :man manual: Candybar Manual

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 https://github.com/Lokaltog/candybar/wiki/Screenshots[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 CANDYBARCONFIGPATH 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 toppadding 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 desktopsi3_ 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

CANDYBARCONFIGPATH:: 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 [email protected]

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

See also

candybar(5)

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.