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