a8ba5c7edef596ac180f455bc46927ec16594982
[my-dotfiles.git] / picom.conf
1 #################################
2 # Shadows #
3 #################################
4
5
6 # Enabled client-side shadows on windows. Note desktop windows
7 # (windows with '_NET_WM_WINDOW_TYPE_DESKTOP') never get shadow,
8 # unless explicitly requested using the wintypes option.
9 #
10 # shadow = false
11 shadow = true;
12
13 # The blur radius for shadows, in pixels. (defaults to 12)
14 # shadow-radius = 12
15 shadow-radius = 7;
16
17 # The opacity of shadows. (0.0 - 1.0, defaults to 0.75)
18 # shadow-opacity = .75
19
20 # The left offset for shadows, in pixels. (defaults to -15)
21 # shadow-offset-x = -15
22 shadow-offset-x = -7;
23
24 # The top offset for shadows, in pixels. (defaults to -15)
25 # shadow-offset-y = -15
26 shadow-offset-y = -7;
27
28 # Red color value of shadow (0.0 - 1.0, defaults to 0).
29 # shadow-red = 0
30
31 # Green color value of shadow (0.0 - 1.0, defaults to 0).
32 # shadow-green = 0
33
34 # Blue color value of shadow (0.0 - 1.0, defaults to 0).
35 # shadow-blue = 0
36
37 # Hex string color value of shadow (#000000 - #FFFFFF, defaults to #000000). This option will override options set shadow-(red/green/blue)
38 # shadow-color = "#000000"
39
40 # Specify a list of conditions of windows that should have no shadow.
41 #
42 # examples:
43 # shadow-exclude = "n:e:Notification";
44 #
45 # shadow-exclude = []
46 shadow-exclude = [
47 "name = 'Notification'",
48 "class_g = 'Conky'",
49 "class_g ?= 'Notify-osd'",
50 "class_g = 'Cairo-clock'",
51 "_GTK_FRAME_EXTENTS@:c"
52 ];
53
54 # Specify a list of conditions of windows that should have no shadow painted over, such as a dock window.
55 # clip-shadow-above = []
56
57 # Specify a X geometry that describes the region in which shadow should not
58 # be painted in, such as a dock window region. Use
59 # shadow-exclude-reg = "x10+0+0"
60 # for example, if the 10 pixels on the bottom of the screen should not have shadows painted on.
61 #
62 # shadow-exclude-reg = ""
63
64 # Crop shadow of a window fully on a particular Xinerama screen to the screen.
65 # xinerama-shadow-crop = false
66
67
68 #################################
69 # Fading #
70 #################################
71
72
73 # Fade windows in/out when opening/closing and when opacity changes,
74 # unless no-fading-openclose is used.
75 # fading = false
76 fading = true;
77
78 # Opacity change between steps while fading in. (0.01 - 1.0, defaults to 0.028)
79 # fade-in-step = 0.028
80 fade-in-step = 0.03;
81
82 # Opacity change between steps while fading out. (0.01 - 1.0, defaults to 0.03)
83 # fade-out-step = 0.03
84 fade-out-step = 0.03;
85
86 # The time between steps in fade step, in milliseconds. (> 0, defaults to 10)
87 # fade-delta = 10
88
89 # Specify a list of conditions of windows that should not be faded.
90 # fade-exclude = []
91
92 # Do not fade on window open/close.
93 # no-fading-openclose = false
94
95 # Do not fade destroyed ARGB windows with WM frame. Workaround of bugs in Openbox, Fluxbox, etc.
96 # no-fading-destroyed-argb = false
97
98
99 #################################
100 # Transparency / Opacity #
101 #################################
102
103
104 # Opacity of inactive windows. (0.1 - 1.0, defaults to 1.0)
105 # inactive-opacity = 1
106 inactive-opacity = 0.8;
107
108 # Opacity of window titlebars and borders. (0.1 - 1.0, disabled by default)
109 # frame-opacity = 1.0
110 frame-opacity = 0.7;
111
112 # Let inactive opacity set by -i override the '_NET_WM_WINDOW_OPACITY' values of windows.
113 # inactive-opacity-override = true
114 inactive-opacity-override = false;
115
116 # Default opacity for active windows. (0.0 - 1.0, defaults to 1.0)
117 # active-opacity = 1.0
118
119 # Dim inactive windows. (0.0 - 1.0, defaults to 0.0)
120 # inactive-dim = 0.0
121
122 # Specify a list of conditions of windows that should never be considered focused.
123 # focus-exclude = []
124 focus-exclude = [ "class_g = 'Cairo-clock'" ];
125
126 # Use fixed inactive dim value, instead of adjusting according to window opacity.
127 # inactive-dim-fixed = 1.0
128
129 # Specify a list of opacity rules, in the format `PERCENT:PATTERN`,
130 # like `50:name *= "Firefox"`. picom-trans is recommended over this.
131 # Note we don't make any guarantee about possible conflicts with other
132 # programs that set '_NET_WM_WINDOW_OPACITY' on frame or client windows.
133 # example:
134 # opacity-rule = [ "80:class_g = 'URxvt'" ];
135 #
136 # opacity-rule = []
137
138
139 #################################
140 # Corners #
141 #################################
142
143 # Sets the radius of rounded window corners. When > 0, the compositor will
144 # round the corners of windows. Does not interact well with
145 # `transparent-clipping`.
146 corner-radius = 0
147
148 # Exclude conditions for rounded corners.
149 rounded-corners-exclude = [
150 "window_type = 'dock'",
151 "window_type = 'desktop'"
152 ];
153
154
155 #################################
156 # Background-Blurring #
157 #################################
158
159
160 # Parameters for background blurring, see the *BLUR* section for more information.
161 # blur-method =
162 # blur-size = 12
163 #
164 # blur-deviation = false
165 #
166 # blur-strength = 5
167
168 # Blur background of semi-transparent / ARGB windows.
169 # Bad in performance, with driver-dependent behavior.
170 # The name of the switch may change without prior notifications.
171 #
172 # blur-background = false
173
174 # Blur background of windows when the window frame is not opaque.
175 # Implies:
176 # blur-background
177 # Bad in performance, with driver-dependent behavior. The name may change.
178 #
179 # blur-background-frame = false
180
181
182 # Use fixed blur strength rather than adjusting according to window opacity.
183 # blur-background-fixed = false
184
185
186 # Specify the blur convolution kernel, with the following format:
187 # example:
188 # blur-kern = "5,5,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1";
189 #
190 # blur-kern = ""
191 blur-kern = "3x3box";
192
193
194 # Exclude conditions for background blur.
195 # blur-background-exclude = []
196 blur-background-exclude = [
197 "window_type = 'dock'",
198 "window_type = 'desktop'",
199 "_GTK_FRAME_EXTENTS@:c"
200 ];
201
202 #################################
203 # General Settings #
204 #################################
205
206 # Enable remote control via D-Bus. See the man page for more details.
207 # dbus = true
208
209 # Daemonize process. Fork to background after initialization. Causes issues with certain (badly-written) drivers.
210 # daemon = false
211
212 # Specify the backend to use: `xrender`, `glx`, or `xr_glx_hybrid`.
213 # `xrender` is the default one.
214 #
215 # backend = "glx"
216 backend = "xrender";
217
218 # Enable/disable VSync.
219 # vsync = false
220 vsync = true;
221
222 # Enable remote control via D-Bus. See the *D-BUS API* section below for more details.
223 # dbus = false
224
225 # Try to detect WM windows (a non-override-redirect window with no
226 # child that has 'WM_STATE') and mark them as active.
227 #
228 # mark-wmwin-focused = false
229 mark-wmwin-focused = true;
230
231 # Mark override-redirect windows that doesn't have a child window with 'WM_STATE' focused.
232 # mark-ovredir-focused = false
233 mark-ovredir-focused = true;
234
235 # Try to detect windows with rounded corners and don't consider them
236 # shaped windows. The accuracy is not very high, unfortunately.
237 #
238 # detect-rounded-corners = false
239 detect-rounded-corners = true;
240
241 # Detect '_NET_WM_WINDOW_OPACITY' on client windows, useful for window managers
242 # not passing '_NET_WM_WINDOW_OPACITY' of client windows to frame windows.
243 #
244 # detect-client-opacity = false
245 detect-client-opacity = true;
246
247 # Use EWMH '_NET_ACTIVE_WINDOW' to determine currently focused window,
248 # rather than listening to 'FocusIn'/'FocusOut' event. Might have more accuracy,
249 # provided that the WM supports it.
250 #
251 # use-ewmh-active-win = false
252
253 # Unredirect all windows if a full-screen opaque window is detected,
254 # to maximize performance for full-screen windows. Known to cause flickering
255 # when redirecting/unredirecting windows.
256 #
257 # unredir-if-possible = false
258
259 # Delay before unredirecting the window, in milliseconds. Defaults to 0.
260 # unredir-if-possible-delay = 0
261
262 # Conditions of windows that shouldn't be considered full-screen for unredirecting screen.
263 # unredir-if-possible-exclude = []
264
265 # Use 'WM_TRANSIENT_FOR' to group windows, and consider windows
266 # in the same group focused at the same time.
267 #
268 # detect-transient = false
269 detect-transient = true;
270
271 # Use 'WM_CLIENT_LEADER' to group windows, and consider windows in the same
272 # group focused at the same time. This usually means windows from the same application
273 # will be considered focused or unfocused at the same time.
274 # 'WM_TRANSIENT_FOR' has higher priority if detect-transient is enabled, too.
275 #
276 # detect-client-leader = false
277
278 # Resize damaged region by a specific number of pixels.
279 # A positive value enlarges it while a negative one shrinks it.
280 # If the value is positive, those additional pixels will not be actually painted
281 # to screen, only used in blur calculation, and such. (Due to technical limitations,
282 # with use-damage, those pixels will still be incorrectly painted to screen.)
283 # Primarily used to fix the line corruption issues of blur,
284 # in which case you should use the blur radius value here
285 # (e.g. with a 3x3 kernel, you should use `--resize-damage 1`,
286 # with a 5x5 one you use `--resize-damage 2`, and so on).
287 # May or may not work with *--glx-no-stencil*. Shrinking doesn't function correctly.
288 #
289 # resize-damage = 1
290
291 # Specify a list of conditions of windows that should be painted with inverted color.
292 # Resource-hogging, and is not well tested.
293 #
294 # invert-color-include = []
295
296 # GLX backend: Avoid using stencil buffer, useful if you don't have a stencil buffer.
297 # Might cause incorrect opacity when rendering transparent content (but never
298 # practically happened) and may not work with blur-background.
299 # My tests show a 15% performance boost. Recommended.
300 #
301 # glx-no-stencil = false
302
303 # GLX backend: Avoid rebinding pixmap on window damage.
304 # Probably could improve performance on rapid window content changes,
305 # but is known to break things on some drivers (LLVMpipe, xf86-video-intel, etc.).
306 # Recommended if it works.
307 #
308 # glx-no-rebind-pixmap = false
309
310 # Disable the use of damage information.
311 # This cause the whole screen to be redrawn every time, instead of the part of the screen
312 # has actually changed. Potentially degrades the performance, but might fix some artifacts.
313 # The opposing option is use-damage
314 #
315 # no-use-damage = false
316 use-damage = true;
317
318 # Use X Sync fence to sync clients' draw calls, to make sure all draw
319 # calls are finished before picom starts drawing. Needed on nvidia-drivers
320 # with GLX backend for some users.
321 #
322 # xrender-sync-fence = false
323
324 # GLX backend: Use specified GLSL fragment shader for rendering window
325 # contents. Read the man page for a detailed explanation of the interface.
326 #
327 # window-shader-fg = "default"
328
329 # Use rules to set per-window shaders. Syntax is SHADER_PATH:PATTERN, similar
330 # to opacity-rule. SHADER_PATH can be "default". This overrides window-shader-fg.
331 #
332 # window-shader-fg-rule = [
333 # "my_shader.frag:window_type != 'dock'"
334 # ]
335
336 # Force all windows to be painted with blending. Useful if you
337 # have a glx-fshader-win that could turn opaque pixels transparent.
338 #
339 # force-win-blend = false
340
341 # Do not use EWMH to detect fullscreen windows.
342 # Reverts to checking if a window is fullscreen based only on its size and coordinates.
343 #
344 # no-ewmh-fullscreen = false
345
346 # Dimming bright windows so their brightness doesn't exceed this set value.
347 # Brightness of a window is estimated by averaging all pixels in the window,
348 # so this could comes with a performance hit.
349 # Setting this to 1.0 disables this behaviour. Requires --use-damage to be disabled. (default: 1.0)
350 #
351 # max-brightness = 1.0
352
353 # Make transparent windows clip other windows like non-transparent windows do,
354 # instead of blending on top of them.
355 #
356 # transparent-clipping = false
357
358 # Specify a list of conditions of windows that should never have transparent
359 # clipping applied. Useful for screenshot tools, where you need to be able to
360 # see through transparent parts of the window.
361 #
362 # transparent-clipping-exclude = []
363
364 # Set the log level. Possible values are:
365 # "trace", "debug", "info", "warn", "error"
366 # in increasing level of importance. Case doesn't matter.
367 # If using the "TRACE" log level, it's better to log into a file
368 # using *--log-file*, since it can generate a huge stream of logs.
369 #
370 # log-level = "debug"
371 log-level = "warn";
372
373 # Set the log file.
374 # If *--log-file* is never specified, logs will be written to stderr.
375 # Otherwise, logs will to written to the given file, though some of the early
376 # logs might still be written to the stderr.
377 # When setting this option from the config file, it is recommended to use an absolute path.
378 #
379 # log-file = "/path/to/your/log/file"
380
381 # Show all X errors (for debugging)
382 # show-all-xerrors = false
383
384 # Write process ID to a file.
385 # write-pid-path = "/path/to/your/log/file"
386
387 # Window type settings
388 #
389 # 'WINDOW_TYPE' is one of the 15 window types defined in EWMH standard:
390 # "unknown", "desktop", "dock", "toolbar", "menu", "utility",
391 # "splash", "dialog", "normal", "dropdown_menu", "popup_menu",
392 # "tooltip", "notification", "combo", and "dnd".
393 #
394 # Following per window-type options are available: ::
395 #
396 # fade, shadow:::
397 # Controls window-type-specific shadow and fade settings.
398 #
399 # opacity:::
400 # Controls default opacity of the window type.
401 #
402 # focus:::
403 # Controls whether the window of this type is to be always considered focused.
404 # (By default, all window types except "normal" and "dialog" has this on.)
405 #
406 # full-shadow:::
407 # Controls whether shadow is drawn under the parts of the window that you
408 # normally won't be able to see. Useful when the window has parts of it
409 # transparent, and you want shadows in those areas.
410 #
411 # clip-shadow-above:::
412 # Controls whether shadows that would have been drawn above the window should
413 # be clipped. Useful for dock windows that should have no shadow painted on top.
414 #
415 # redir-ignore:::
416 # Controls whether this type of windows should cause screen to become
417 # redirected again after been unredirected. If you have unredir-if-possible
418 # set, and doesn't want certain window to cause unnecessary screen redirection,
419 # you can set this to `true`.
420 #
421 wintypes:
422 {
423 tooltip = { fade = true; shadow = true; opacity = 0.75; focus = true; full-shadow = false; };
424 dock = { shadow = false; clip-shadow-above = true; }
425 dnd = { shadow = false; }
426 popup_menu = { opacity = 0.8; }
427 dropdown_menu = { opacity = 0.8; }
428 };