Tutorials

Add transparent background

Install GraphicsMagick and recompile candybar. Add the following to your config.json:

{
	"widgets": [
		...
		{
			"module": "magick_background",
			"config": {}
		}
		...
	]
}

The widget will automatically read the background image if you're setting it with e.g. feh. If this doesn't work, set the image config property to the absolute path of your background image:

"config": {
	"image": "/path/to/your/image.jpg",
}

You can also customize background effects by setting the blur_radius, brightness and saturation parameters as described in man 5 candybar.

Desktop lists in i3wm

Desktop lists in i3wm require the use of the plugin desktops_i3, as well as the external library i3ipc-glib.

If on arch, you can install i3ipc-glib from the aur here. If not, go to i3ipc-glib's github page and follow the compile and install instructions from there.

After it's installed, open your config.json and change this...

{
	"widgets": [
		...
		{
			"module": "desktops",
			"config": {}
		}
		...
	]
}

to this...

{
	"widgets": [
		...
		{
			"module": "desktops_i3",
			"config": {}
		}
		...
	]
}