picom.conf.example 14 KB

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