LinuxCommandLibrary

compton

standalone compositor for X11 window systems

TLDR

Start compton with default settings

$ compton
copy
Start with a configuration file
$ compton --config [~/.config/compton.conf]
copy
Enable shadows on windows
$ compton -c
copy
Enable fading effects for windows
$ compton -f
copy
Set shadow opacity
$ compton -c -o [0.5]
copy
Disable shadows on dock and panel windows
$ compton -c -C
copy
Run in background as daemon
$ compton -b
copy
Enable vsync to prevent tearing
$ compton --vsync opengl
copy

SYNOPSIS

compton [options]

DESCRIPTION

compton is a standalone compositor for X11, providing visual effects like window shadows, transparency, fading animations, and vsync to prevent screen tearing. It works with any window manager that supports compositing.
The compositor operates by intercepting window rendering and applying effects before displaying the final image. It supports both XRender and OpenGL backends, with GLX generally providing better performance. Configuration can be done via command-line options or a configuration file.
Compton is commonly used with lightweight window managers like i3, openbox, and bspwm to add visual polish without the overhead of a full desktop environment's compositor. It can also help with screen tearing issues on systems without built-in compositing.

PARAMETERS

-c, --shadow

Enable client-side shadows on windows.
-C, --no-dock-shadow
Disable shadows on dock/panel windows.
-f, --fading
Fade windows in/out when opening/closing.
-o OPACITY
Shadow opacity (0.0 to 1.0).
-r RADIUS
Shadow blur radius in pixels.
-l OFFSET
Left offset for shadows in pixels.
-t OFFSET
Top offset for shadows in pixels.
--vsync METHOD
VSync method: none, drm, opengl, opengl-oml, opengl-swc.
-b, --daemon
Run as a background daemon.
--config FILE
Read configuration from the specified file.
-i OPACITY
Inactive window opacity (0.0 to 1.0).
-e OPACITY
Opacity of window titlebars and borders.
--backend BACKEND
Rendering backend: xrender, glx.

CONFIGURATION

~/.config/compton.conf

User configuration file for compton settings.
/etc/xdg/compton.conf
System-wide default configuration.

CAVEATS

Compton development has ceased; picom is the actively maintained fork and recommended for new installations. OpenGL backend may have compatibility issues with some graphics drivers. Compositing adds GPU overhead that may affect performance on older hardware.

HISTORY

Compton was forked from xcompmgr in 2011 by Christopher Jeffrey (chjj) to add features and fix bugs. It became popular in the Linux ricing community for its configurability. Development stalled around 2017, leading to the creation of picom as an actively maintained fork.

SEE ALSO

picom(1), xcompmgr(1), i3(1)

> TERMINAL_GEAR

Curated for the Linux community

Copied to clipboard

> TERMINAL_GEAR

Curated for the Linux community