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 c78df9ae69
fix bos lower bound
2 days ago
src use scfg, clean code 3 days ago
.gitignore first commit 1 year ago
.ocamlformat update ocamlformat 3 days ago 0.1 3 days ago first commit 1 year ago fix typo 3 days ago
ccbg.opam fix bos lower bound 2 days ago
dune-project fix bos lower bound 2 days 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.