You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
zapashcanon ceeb19d971
clean code
4 months ago
src clean code 4 months ago
.gitignore first commit 2 years ago
.ocamlformat clean code 4 months ago 0.1 1 year ago first commit 2 years ago fix typo 1 year ago
ccbg.opam fix bos lower bound 1 year ago
dune-project fix bos lower bound 1 year ago


ccbg is an OCaml executable to manage wallpapers in Wayland, using swaybg.


ccbg can be installed with opam:

opam install ccbg

If you don't have opam, you can install it following the how to install opam guide.

If you can't or don't want to use opam, consult the opam file for build instructions.


In your sway configuration file, add the following:

exec ccbg

It'll start ccbg automatically with sway.

By default, ccbg will change your wallpaper every minute, display them using the fill mode of swaybg and look for images in the directory XDG_PICTURES_DIR set in ${XDG_CONFIG_HOME:-~/.config}/user-dirs.dirs

You can overwrite this by writing a configuration file for ccbg in ${XDG_CONFIG_HOME:-~/.config}/ccbg/config.scfg with the following content:

interval 600
mode center
wallpaper_dir /home/tedkaczynski/img/wallpaper

If you set interval to 0, ccbg won't regularly change your wallpaper.