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.

1.3 KiB


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.