candybar

a stupidly simple modular statusbar

usage

candybar only outputs the text that should be shown on the bar, which makes it useable on different applications.

add the following to your ~/.xinitrc:

while true; do
	xsetroot -name "$(candybar)"
	sleep 2
done &

add the following to your ~/.tmux.conf:

set -g status-interval 2
set -g status-right-length 100
set -g status-right "#(candybar)"

add the following to your ~/.zshrc:

precmd() {
	psvar[1]="$(candybar)"
}
export CSI=$'\e'"["
export PROMPT="${CSI}s${CSI}1;$((LINES-1))r${CSI}$LINES;1f%S%1v%s${CSI}K${CSI}u${PROMPT}"

writing candybar modules is very easy. modules can be written in any programming language.

first, open up the modules.sh file. create a new function with, for example, the name module_foo().

module_foo() {
	# uh, so what now?
}

next, if you are using POSIX SH to write your module, just write your script in the function.

for this example, we'll be writing a module that outputs the current date.

module_foo() {
	# remember to keep the ${bar}, ${1}, and ${2} here!
	export bar="${bar}${1}$(date)${2}"
}

if you are using a different language, write your module and then run it with sh.

module_foo() {
	export output="$(/path/to/program)"
	export bar="${bar}${1}${output}${2}"
}

now add a line for your module in the config.sh, for example:

module_foo	"Date:"		" | "

you're done! run candybar to see the results.

remember that if you have configured candybar to be used in zsh, tmux or dwm like in this README, you won't have to restart candybar!