Custom script to manage Picom behavior on Cereus Linux. This tool was developed with the main purpose to provide multiple backend configurations depending of machine hardware.
Usage: picom-manager [OPTION]...
OPTIONS:
-c [CONFIG_FILE] Custom configuration path to use.
-d Override picom-manager configurations and use user-defined instead.
-h Shows this help.
-f [--flag] Add an extra flag to compositor. May be used many times.
-m [MODE] Override environment compositor mode. Possible values are: off, compatibility, opengl and blur.
-t Toggle the compositor."
Cereus by default will use GLX backend, but if this script detects an error at Picom startup, it will inmediately fallback to XRender.
picom-manager works with environment variables. The most important is $COMPOSITOR_MODE. In LXQt ISOs this is defined at $HOME/.config/lxqt/session.conf, but if you want to define it to ~/.profile you MUST remove it from LXQt configuration first (this isn't necessary for any other desktop environment).
Supported compositor modes are: off (disable compositor), compatibility (XRender backend), opengl (GLX backend) and blur (blur effects with GLX backend).
LXQt allows to define environment variables graphically. We consider this ideal for begginner users.
LXQt edition by default ships this package (which is available at cereus-extra repository). If you need to install it manually, run:
# xbps-install -S picom-manager
You could probably use this tool in other distros, but it does needs to be patched first to not use certain Cereus specific paths and commands. We'll consider doing this in the future.