3 #################################
5 #################################
8 # Fade windows in/out when opening/closing and when opacity changes,
9 # unless no-fading-openclose is used.
13 # Opacity change between steps while fading in. (0.01 - 1.0, defaults to 0.028)
14 # fade-in-step = 0.028
17 # Opacity change between steps while fading out. (0.01 - 1.0, defaults to 0.03)
18 # fade-out-step = 0.03
21 # The time between steps in fade step, in milliseconds. (> 0, defaults to 10)
24 # Specify a list of conditions of windows that should not be faded.
27 # Do not fade on window open/close.
28 # no-fading-openclose = false
30 # Do not fade destroyed ARGB windows with WM frame. Workaround of bugs in Openbox, Fluxbox, etc.
31 # no-fading-destroyed-argb = false
34 #################################
35 # Transparency / Opacity #
36 #################################
39 # Opacity of inactive windows. (0.1 - 1.0, defaults to 1.0)
40 # inactive-opacity = 1
41 inactive-opacity = 1.0;
43 # Opacity of window titlebars and borders. (0.1 - 1.0, disabled by default)
47 # Let inactive opacity set by -i override the '_NET_WM_OPACITY' values of windows.
48 # inactive-opacity-override = true
49 inactive-opacity-override = false;
51 # Default opacity for active windows. (0.0 - 1.0, defaults to 1.0)
52 # active-opacity = 0.8;
54 # Dim inactive windows. (0.0 - 1.0, defaults to 0.0)
57 # Specify a list of conditions of windows that should always be considered focused.
60 # Use fixed inactive dim value, instead of adjusting according to window opacity.
61 # inactive-dim-fixed = true;
63 # Specify a list of opacity rules, in the format `PERCENT:PATTERN`,
64 # like `50:name *= "Firefox"`. picom-trans is recommended over this.
65 # Note we don't make any guarantee about possible conflicts with other
66 # programs that set '_NET_WM_WINDOW_OPACITY' on frame or client windows.
68 # opacity-rule = [ "80:class_g = 'URxvt'" ];
70 # opacity-rule = ["80:class_g = 'URxvt'"];
73 #################################
74 # Background-Blurring #
75 #################################
78 # Parameters for background blurring, see the *BLUR* section for more information.
82 # blur-deviation = false
84 # Blur background of semi-transparent / ARGB windows.
85 # Bad in performance, with driver-dependent behavior.
86 # The name of the switch may change without prior notifications.
88 blur-background = true;
90 # Blur background of windows when the window frame is not opaque.
93 # Bad in performance, with driver-dependent behavior. The name may change.
95 blur-background-frame = true;
98 # Use fixed blur strength rather than adjusting according to window opacity.
99 # blur-background-fixed = false
102 # Specify the blur convolution kernel, with the following format:
104 # 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";
107 blur-kern = "3x3box";
110 # Exclude conditions for background blur.
111 # blur-background-exclude = []
112 blur-background-exclude = [
113 "window_type = 'dock'",
114 "window_type = 'desktop'",
115 "_GTK_FRAME_EXTENTS@:c"
118 #################################
120 #################################
122 # Daemonize process. Fork to background after initialization. Causes issues with certain (badly-written) drivers.
125 # Specify the backend to use: `xrender`, `glx`, or `xr_glx_hybrid`.
126 # `xrender` is the default one.
131 # Enable/disable VSync.
134 # vsync = "opengl-swc";
136 # Enable remote control via D-Bus. See the *D-BUS API* section below for more details.
139 # Try to detect WM windows (a non-override-redirect window with no
140 # child that has 'WM_STATE') and mark them as active.
142 # mark-wmwin-focused = false
143 mark-wmwin-focused = true;
145 # Mark override-redirect windows that doesn't have a child window with 'WM_STATE' focused.
146 # mark-ovredir-focused = false
147 mark-ovredir-focused = true;
149 # Try to detect windows with rounded corners and don't consider them
150 # shaped windows. The accuracy is not very high, unfortunately.
152 # detect-rounded-corners = false
153 detect-rounded-corners = true;
155 # Detect '_NET_WM_OPACITY' on client windows, useful for window managers
156 # not passing '_NET_WM_OPACITY' of client windows to frame windows.
158 # detect-client-opacity = false
159 detect-client-opacity = true;
161 # Specify refresh rate of the screen. If not specified or 0, picom will
162 # try detecting this with X RandR extension.
167 # Limit picom to repaint at most once every 1 / 'refresh_rate' second to
168 # boost performance. This should not be used with
169 # vsync drm/opengl/opengl-oml
170 # as they essentially does sw-opti's job already,
171 # unless you wish to specify a lower refresh rate than the actual value.
175 # Use EWMH '_NET_ACTIVE_WINDOW' to determine currently focused window,
176 # rather than listening to 'FocusIn'/'FocusOut' event. Might have more accuracy,
177 # provided that the WM supports it.
179 # use-ewmh-active-win = false
181 # Unredirect all windows if a full-screen opaque window is detected,
182 # to maximize performance for full-screen windows. Known to cause flickering
183 # when redirecting/unredirecting windows.
185 # unredir-if-possible = false
187 # Delay before unredirecting the window, in milliseconds. Defaults to 0.
188 # unredir-if-possible-delay = 0
190 # Conditions of windows that shouldn't be considered full-screen for unredirecting screen.
191 # unredir-if-possible-exclude = []
193 # Use 'WM_TRANSIENT_FOR' to group windows, and consider windows
194 # in the same group focused at the same time.
196 # detect-transient = false
197 detect-transient = true
199 # Use 'WM_CLIENT_LEADER' to group windows, and consider windows in the same
200 # group focused at the same time. 'WM_TRANSIENT_FOR' has higher priority if
201 # detect-transient is enabled, too.
203 # detect-client-leader = false
204 detect-client-leader = true
206 # Resize damaged region by a specific number of pixels.
207 # A positive value enlarges it while a negative one shrinks it.
208 # If the value is positive, those additional pixels will not be actually painted
209 # to screen, only used in blur calculation, and such. (Due to technical limitations,
210 # with use-damage, those pixels will still be incorrectly painted to screen.)
211 # Primarily used to fix the line corruption issues of blur,
212 # in which case you should use the blur radius value here
213 # (e.g. with a 3x3 kernel, you should use `--resize-damage 1`,
214 # with a 5x5 one you use `--resize-damage 2`, and so on).
215 # May or may not work with *--glx-no-stencil*. Shrinking doesn't function correctly.
219 # Specify a list of conditions of windows that should be painted with inverted color.
220 # Resource-hogging, and is not well tested.
222 # invert-color-include = []
224 # GLX backend: Avoid using stencil buffer, useful if you don't have a stencil buffer.
225 # Might cause incorrect opacity when rendering transparent content (but never
226 # practically happened) and may not work with blur-background.
227 # My tests show a 15% performance boost. Recommended.
229 # glx-no-stencil = false
230 glx-no-stencil = true;
232 # GLX backend: Avoid rebinding pixmap on window damage.
233 # Probably could improve performance on rapid window content changes,
234 # but is known to break things on some drivers (LLVMpipe, xf86-video-intel, etc.).
235 # Recommended if it works.
237 # glx-no-rebind-pixmap = false
238 glx-no-rebind-pixmap = true;
240 # Disable the use of damage information.
241 # This cause the whole screen to be redrawn everytime, instead of the part of the screen
242 # has actually changed. Potentially degrades the performance, but might fix some artifacts.
243 # The opposing option is use-damage
245 # no-use-damage = false
248 # Use X Sync fence to sync clients' draw calls, to make sure all draw
249 # calls are finished before picom starts drawing. Needed on nvidia-drivers
250 # with GLX backend for some users.
252 # xrender-sync-fence = false
254 # GLX backend: Use specified GLSL fragment shader for rendering window contents.
255 # See `compton-default-fshader-win.glsl` and `compton-fake-transparency-fshader-win.glsl`
256 # in the source tree for examples.
258 # glx-fshader-win = ''
260 # Force all windows to be painted with blending. Useful if you
261 # have a glx-fshader-win that could turn opaque pixels transparent.
263 # force-win-blend = false
265 # Do not use EWMH to detect fullscreen windows.
266 # Reverts to checking if a window is fullscreen based only on its size and coordinates.
268 # no-ewmh-fullscreen = false
270 # Dimming bright windows so their brightness doesn't exceed this set value.
271 # Brightness of a window is estimated by averaging all pixels in the window,
272 # so this could comes with a performance hit.
273 # Setting this to 1.0 disables this behaviour. Requires --use-damage to be disabled. (default: 1.0)
275 # max-brightness = 1.0
277 # Make transparent windows clip other windows like non-transparent windows do,
278 # instead of blending on top of them.
280 # transparent-clipping = false
282 # Set the log level. Possible values are:
283 # "trace", "debug", "info", "warn", "error"
284 # in increasing level of importance. Case doesn't matter.
285 # If using the "TRACE" log level, it's better to log into a file
286 # using *--log-file*, since it can generate a huge stream of logs.
288 # log-level = "debug"
292 # If *--log-file* is never specified, logs will be written to stderr.
293 # Otherwise, logs will to written to the given file, though some of the early
294 # logs might still be written to the stderr.
295 # When setting this option from the config file, it is recommended to use an absolute path.
297 # log-file = '/path/to/your/log/file'
299 # Show all X errors (for debugging)
300 # show-all-xerrors = false
302 # Write process ID to a file.
303 # write-pid-path = '/path/to/your/log/file'
305 # Window type settings
307 # 'WINDOW_TYPE' is one of the 15 window types defined in EWMH standard:
308 # "unknown", "desktop", "dock", "toolbar", "menu", "utility",
309 # "splash", "dialog", "normal", "dropdown_menu", "popup_menu",
310 # "tooltip", "notification", "combo", and "dnd".
312 # Following per window-type options are available: ::
315 # Controls window-type-specific shadow and fade settings.
318 # Controls default opacity of the window type.
321 # Controls whether the window of this type is to be always considered focused.
322 # (By default, all window types except "normal" and "dialog" has this on.)
325 # Controls whether shadow is drawn under the parts of the window that you
326 # normally won't be able to see. Useful when the window has parts of it
327 # transparent, and you want shadows in those areas.
330 # Controls whether this type of windows should cause screen to become
331 # redirected again after been unredirected. If you have unredir-if-possible
332 # set, and doesn't want certain window to cause unnecessary screen redirection,
333 # you can set this to `true`.
337 tooltip = { fade = true; shadow = true; opacity = 0.75; focus = true; full-shadow = false; };
338 dock = { shadow = false; }
339 dnd = { shadow = false; }
340 popup_menu = { opacity = 0.8; }
341 dropdown_menu = { opacity = 0.8; }