summaryrefslogtreecommitdiff
path: root/picom/picom.conf
blob: 066ee1cfa3a6bbb4ac6855835c6b58879b35f7af (plain)
    1 # https://duncanlock.net/blog/2013/06/07/how-to-switch-to-compton-for-beautiful-tear-free-compositing-in-xfce/
    2 # https://git.archlinux.org/svntogit/community.git/plain/trunk/picom.conf?h=packages/picom
    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.
   12 backend = "glx";
   13 
   14 #################################
   15 #
   16 # GLX backend
   17 #
   18 #################################
   19 
   20 glx-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.
   26 glx-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.
   37 # glx-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.
   58 shadow = 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 picom 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 = 'cpt_frame_window'",
   84     "name *= 'VLC'",
   85     "name *= 'compton'",
   86     "name *= 'picom'",
   87     "name *= 'Chromium'",
   88     "name *= 'Chrome'",
   89     "class_g = 'Firefox' && argb",
   90     "class_g = 'Conky'",
   91     "class_g = 'Kupfer'",
   92     "class_g = 'Synapse'",
   93     "class_g ?= 'Notify-osd'",
   94     "class_g ?= 'Cairo-dock'",
   95     "class_g ?= 'Xfce4-notifyd'",
   96     "class_g ?= 'Xfce4-power-manager'",
   97     "_GTK_FRAME_EXTENTS@:c",
   98     "_NET_WM_STATE@:32a *= '_NET_WM_STATE_HIDDEN'"
   99 ];
  100 # Avoid drawing shadow on all shaped windows (see also: --detect-rounded-corners)
  101 shadow-ignore-shaped = false;
  102 
  103 #################################
  104 #
  105 # Opacity
  106 #
  107 #################################
  108 
  109 inactive-opacity = 1;
  110 active-opacity = 1;
  111 frame-opacity = 1;
  112 inactive-opacity-override = false;
  113 
  114 # Dim inactive windows. (0.0 - 1.0)
  115 # inactive-dim = 0.2;
  116 # Do not let dimness adjust based on window opacity.
  117 # inactive-dim-fixed = true;
  118 # Blur background of transparent windows. Bad performance with X Render backend. GLX backend is preferred.
  119 # blur-background = true;
  120 # Blur background of opaque windows with transparent frames as well.
  121 # blur-background-frame = true;
  122 # Do not let blur radius adjust based on window opacity.
  123 blur-background-fixed = false;
  124 blur-background-exclude = [
  125     "window_type = 'dock'",
  126     "window_type = 'desktop'"
  127 ];
  128 
  129 #################################
  130 #
  131 # Fading
  132 #
  133 #################################
  134 
  135 # Fade windows during opacity changes.
  136 fading = true;
  137 # The time between steps in a fade in milliseconds. (default 10).
  138 fade-delta = 4;
  139 # Opacity change between steps while fading in. (default 0.028).
  140 fade-in-step = 0.03;
  141 # Opacity change between steps while fading out. (default 0.03).
  142 fade-out-step = 0.03;
  143 # Fade windows in/out when opening/closing
  144 # no-fading-openclose = true;
  145 
  146 # Specify a list of conditions of windows that should not be faded.
  147 fade-exclude = [ ];
  148 
  149 #################################
  150 #
  151 # Other
  152 #
  153 #################################
  154 
  155 # Try to detect WM windows and mark them as active.
  156 mark-wmwin-focused = true;
  157 # Mark all non-WM but override-redirect windows active (e.g. menus).
  158 mark-ovredir-focused = true;
  159 # Use EWMH _NET_WM_ACTIVE_WINDOW to determine which window is focused instead of using FocusIn/Out events.
  160 # Usually more reliable but depends on a EWMH-compliant WM.
  161 use-ewmh-active-win = true;
  162 # Detect rounded corners and treat them as rectangular when --shadow-ignore-shaped is on.
  163 detect-rounded-corners = true;
  164 
  165 # Detect _NET_WM_OPACITY on client windows, useful for window managers not passing _NET_WM_OPACITY of client windows to frame windows.
  166 # This prevents opacity being ignored for some apps.
  167 # For example without this enabled my xfce4-notifyd is 100% opacity no matter what.
  168 detect-client-opacity = true;
  169 
  170 # Specify refresh rate of the screen.
  171 # If not specified or 0, picom will try detecting this with X RandR extension.
  172 refresh-rate = 0;
  173 
  174 # Vertical synchronization: match the refresh rate of the monitor
  175 vsync = true;
  176 
  177 # Enable DBE painting mode, intended to use with VSync to (hopefully) eliminate tearing.
  178 # Reported to have no effect, though.
  179 dbe = false;
  180 
  181 # Limit picom to repaint at most once every 1 / refresh_rate second to boost performance.
  182 # This should not be used with --vsync drm/opengl/opengl-oml as they essentially does --sw-opti's job already,
  183 # unless you wish to specify a lower refresh rate than the actual value.
  184 #sw-opti = true;
  185 
  186 # Unredirect all windows if a full-screen opaque window is detected, to maximize performance for full-screen windows, like games.
  187 # Known to cause flickering when redirecting/unredirecting windows.
  188 unredir-if-possible = false;
  189 
  190 # Specify a list of conditions of windows that should always be considered focused.
  191 focus-exclude = [ ];
  192 
  193 # Use WM_TRANSIENT_FOR to group windows, and consider windows in the same group focused at the same time.
  194 detect-transient = true;
  195 # Use WM_CLIENT_LEADER to group windows, and consider windows in the same group focused at the same time.
  196 # WM_TRANSIENT_FOR has higher priority if --detect-transient is enabled, too.
  197 detect-client-leader = true;
  198 
  199 #################################
  200 #
  201 # Window type settings
  202 #
  203 #################################
  204 
  205 wintypes:
  206 {
  207     tooltip =
  208     {
  209         # fade: Fade the particular type of windows.
  210         fade = true;
  211         # shadow: Give those windows shadow
  212         shadow = false;
  213         # opacity: Default opacity for the type of windows.
  214         opacity = 0.85;
  215         # focus: Whether to always consider windows of this type focused.
  216         focus = true;
  217     };
  218 };
  219 
  220 ######################
  221 #
  222 # XSync
  223 # See: https://github.com/yshui/picom/commit/b18d46bcbdc35a3b5620d817dd46fbc76485c20d
  224 #
  225 ######################
  226 
  227 # Use X Sync fence to sync clients' draw calls. Needed on nvidia-drivers with GLX backend for some users.
  228 xrender-sync-fence = true;

Generated by cgit