1# Thank you code_nomad: http://9m.no/ꪯ鵞
2# and Arch Wiki contributors: https://wiki.archlinux.org/index.php/Compton
3
4#################################
5#
6# Backend
7#
8#################################
9
10# Backend to use: "xrender" or "glx".
11# GLX backend is typically much faster but depends on a sane driver.
12backend = "glx";
13
14#################################
15#
16# GLX backend
17#
18#################################
19
20glx-no-stencil = true;
21
22# GLX backend: Copy unmodified regions from front buffer instead of redrawing them all.
23# My tests with nvidia-drivers show a 10% decrease in performance when the whole screen is modified,
24# but a 20% increase when only 1/4 is.
25# My tests on nouveau show terrible slowdown.
26glx-copy-from-front = false;
27
28# GLX backend: Use MESA_copy_sub_buffer to do partial screen update.
29# My tests on nouveau shows a 200% performance boost when only 1/4 of the screen is updated.
30# May break VSync and is not available on some drivers.
31# Overrides --glx-copy-from-front.
32# glx-use-copysubbuffermesa = true;
33
34# GLX backend: Avoid rebinding pixmap on window damage.
35# Probably could improve performance on rapid window content changes, but is known to break things on some drivers (LLVMpipe).
36# Recommended if it works.
37glx-no-rebind-pixmap = true;
38
39# GLX backend: GLX buffer swap method we assume.
40# Could be undefined (0), copy (1), exchange (2), 3-6, or buffer-age (-1).
41# undefined is the slowest and the safest, and the default value.
42# copy is fastest, but may fail on some drivers,
43# 2-6 are gradually slower but safer (6 is still faster than 0).
44# Usually, double buffer means 2, triple buffer means 3.
45# buffer-age means auto-detect using GLX_EXT_buffer_age, supported by some drivers.
46# Useless with --glx-use-copysubbuffermesa.
47# Partially breaks --resize-damage.
48# Defaults to undefined.
49#glx-swap-method = "undefined";
50
51#################################
52#
53# Shadows
54#
55#################################
56
57# Enabled client-side shadows on windows.
58shadow = true;
59# The blur radius for shadows. (default 12)
60# shadow-radius = 5;
61# The left offset for shadows. (default -15)
62# shadow-offset-x = -5;
63# The top offset for shadows. (default -15)
64# shadow-offset-y = -5;
65# The translucency for shadows. (default .75)
66# shadow-opacity = 0.5;
67
68# Set if you want different colour shadows
69# shadow-red = 0.0;
70# shadow-green = 0.0;
71# shadow-blue = 0.0;
72
73# The shadow exclude options are helpful if you have shadows enabled. Due to the way compton draws its shadows, certain applications will have visual glitches
74# (most applications are fine, only apps that do weird things with xshapes or argb are affected).
75# This list includes all the affected apps I found in my testing. The "! name~=''" part excludes shadows on any "Unknown" windows, this prevents a visual glitch with the XFWM alt tab switcher.
76 shadow-exclude = [
77# "! name~=''",
78# "name = 'Notification'",
79# "name = 'Plank'",
80# "name = 'Docky'",
81# "name = 'Kupfer'",
82# "name = 'xfce4-notifyd'",
83# "name *= 'VLC'",
84# "name *= 'VLC'",
85# "name *= 'compton'",
86# "name *= 'Chromium'",
87# "name *= 'Chrome'",
88 "class_g = 'Firefox'",
89# "class_g = 'Conky'",
90# "class_g = 'Kupfer'",
91# "class_g = 'Synapse'",
92# "class_g ?= 'Notify-osd'",
93# "class_g ?= 'Cairo-dock'",
94# "class_g ?= 'Xfce4-notifyd'",
95 "class_g ?= 'i3-frame'",
96# "_GTK_FRAME_EXTENTS@:c",
97# "_NET_WM_STATE@:32a *= '_NET_WM_STATE_HIDDEN'"
98 "_NET_WM_WINDOW_TYPE@:32a *= '_NET_WM_WINDOW_TYPE_DOCK'",
99 "I3_FLOATING_WINDOW@:c != 1"
100 ];
101# Avoid drawing shadow on all shaped windows (see also: --detect-rounded-corners)
102# shadow-ignore-shaped = false;
103
104#################################
105#
106# Opacity
107#
108#################################
109
110#inactive-opacity = 0.95;
111active-opacity = 1;
112frame-opacity = 1;
113inactive-opacity-override = false;
114
115# Dim inactive windows. (0.0 - 1.0)
116#inactive-dim = 0.25;
117# Do not let dimness adjust based on window opacity.
118inactive-dim-fixed = true;
119# Blur background of transparent windows. Bad performance with X Render backend. GLX backend is preferred.
120blur-background = false;
121# Blur background of opaque windows with transparent frames as well.
122blur-background-frame = true;
123# Do not let blur radius adjust based on window opacity.
124blur-background-fixed = false;
125blur-background-exclude = [
126 "class_g = 'Polybar'",
127];
128
129#blur: {
130# method = "box";
131# size = 10;
132# deviation = 5.0;
133#}
134
135#################################
136#
137# Fading
138#
139#################################
140
141# Fade windows during opacity changes.
142fading = true;
143# The time between steps in a fade in milliseconds. (default 10).
144fade-delta = 4;
145# Opacity change between steps while fading in. (default 0.028).
146fade-in-step = 0.028;
147# Opacity change between steps while fading out. (default 0.03).
148fade-out-step = 0.03;
149# Fade windows in/out when opening/closing
150# no-fading-openclose = true;
151
152# Specify a list of conditions of windows that should not be faded.
153fade-exclude = [ ];
154
155#################################
156#
157# Other
158#
159#################################
160
161# Try to detect WM windows and mark them as active.
162mark-wmwin-focused = true;
163# Mark all non-WM but override-redirect windows active (e.g. menus).
164mark-ovredir-focused = true;
165# Use EWMH _NET_WM_ACTIVE_WINDOW to determine which window is focused instead of using FocusIn/Out events.
166# Usually more reliable but depends on a EWMH-compliant WM.
167use-ewmh-active-win = true;
168# Detect rounded corners and treat them as rectangular when --shadow-ignore-shaped is on.
169detect-rounded-corners = true;
170
171# Detect _NET_WM_OPACITY on client windows, useful for window managers not passing _NET_WM_OPACITY of client windows to frame windows.
172# This prevents opacity being ignored for some apps.
173# For example without this enabled my xfce4-notifyd is 100% opacity no matter what.
174detect-client-opacity = true;
175
176# Specify refresh rate of the screen.
177# If not specified or 0, compton will try detecting this with X RandR extension.
178refresh-rate = 0;
179
180# Vertical synchronization: match the refresh rate of the monitor
181vsync = false;
182
183# Enable DBE painting mode, intended to use with VSync to (hopefully) eliminate tearing.
184# Reported to have no effect, though.
185dbe = false;
186
187# Limit compton to repaint at most once every 1 / refresh_rate second to boost performance.
188# This should not be used with --vsync drm/opengl/opengl-oml as they essentially does --sw-opti's job already,
189# unless you wish to specify a lower refresh rate than the actual value.
190#sw-opti = true;
191
192# Unredirect all windows if a full-screen opaque window is detected, to maximize performance for full-screen windows, like games.
193# Known to cause flickering when redirecting/unredirecting windows.
194unredir-if-possible = false;
195
196# Specify a list of conditions of windows that should always be considered focused.
197focus-exclude = [
198 "name *= 'mpv'",
199 "name *= 'VLC media player'",
200 "name = 'Picture-in-Picture'",
201 "name = 'scrcpy'"
202];
203
204# Use WM_TRANSIENT_FOR to group windows, and consider windows in the same group focused at the same time.
205detect-transient = false;
206# Use WM_CLIENT_LEADER to group windows, and consider windows in the same group focused at the same time.
207# WM_TRANSIENT_FOR has higher priority if --detect-transient is enabled, too.
208detect-client-leader = false;
209
210#################################
211#
212# Window type settings
213#
214#################################
215
216wintypes:
217{
218 tooltip =
219 {
220 # fade: Fade the particular type of windows.
221 fade = true;
222 # shadow: Give those windows shadow
223 shadow = true;
224 # opacity: Default opacity for the type of windows.
225 opacity = 0.85;
226 # focus: Whether to always consider windows of this type focused.
227 focus = true;
228 };
229};
230
231######################
232#
233# XSync
234# See: https://github.com/yshui/compton/commit/b18d46bcbdc35a3b5620d817dd46fbc76485c20d
235#
236######################
237
238# Use X Sync fence to sync clients' draw calls. Needed on nvidia-drivers with GLX backend for some users.
239xrender-sync-fence = true;