Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

services.picom.enable

Whether to enable Picom X11 compositor.

Type: boolean

Default:

false

Example:

true

Declared by:

services.picom.package

The picom package to use.

Type: package

Default:

pkgs.picom

Declared by:

services.picom.activeOpacity

Opacity of active windows.

Type: integer or floating point number between 0 and 1 (both inclusive)

Default:

1.0

Example:

0.8

Declared by:

services.picom.backend

Backend to use: egl, glx, xrender or xr_glx_hybrid.

Type: one of “egl”, “glx”, “xrender”, “xr_glx_hybrid”

Default:

"xrender"

Declared by:

services.picom.extraArgs

Extra arguments to be passed to the picom executable.

Type: list of string

Default:

[ ]

Example:

[
  "--legacy-backends"
]

Declared by:

services.picom.extraConfig

Extra configuration lines to append to the picom configuration file.

Type: strings concatenated with “\n”

Default:

""

Example:

''
  animations = (
    {
    	triggers = [ "open", "show" ];
    	preset = "slide-in";
    	direction = "up";
      duration = 0.2;
    }
  )
''

Declared by:

services.picom.fade

Fade windows in and out.

Type: boolean

Default:

false

Declared by:

services.picom.fadeDelta

Time between fade animation step (in ms).

Type: positive integer, meaning >0

Default:

10

Example:

5

Declared by:

services.picom.fadeExclude

List of conditions of windows that should not be faded. See picom(1) man page for more examples.

Type: list of string

Default:

[ ]

Example:

[
  "window_type *= 'menu'"
  "name ~= 'Firefox$'"
  "focused = 1"
]

Declared by:

services.picom.fadeSteps

Opacity change between fade steps (in and out).

Type: pair of integer or floating point number between 0.01 and 1 (both inclusive)

Default:

[
  0.028
  0.03
]

Example:

[
  0.04
  0.04
]

Declared by:

services.picom.inactiveOpacity

Opacity of inactive windows.

Type: integer or floating point number between 0.1 and 1 (both inclusive)

Default:

1.0

Example:

0.8

Declared by:

services.picom.menuOpacity

Opacity of dropdown and popup menu.

Type: integer or floating point number between 0 and 1 (both inclusive)

Default:

1.0

Example:

0.8

Declared by:

services.picom.opacityRules

Rules that control the opacity of windows, in format PERCENT:PATTERN.

Type: list of string

Default:

[ ]

Example:

[
  "95:class_g = 'URxvt' && !_NET_WM_STATE@:32a"
  "0:_NET_WM_STATE@:32a *= '_NET_WM_STATE_HIDDEN'"
]

Declared by:

services.picom.settings

Picom settings. Use this option to configure Picom settings not exposed in a NixOS option or to bypass one. For the available options see the CONFIGURATION FILES section at picom(1).

Type: libconfig configuration. The format consists of an attributes set (called a group) of settings. Each setting can be a scalar type (boolean, integer, floating point number or string), a list of scalars or a group itself

Default:

{ }

Example:

blur =
  { method = "gaussian";
    size = 10;
    deviation = 5.0;
  };

Declared by:

services.picom.shadow

Draw window shadows.

Type: boolean

Default:

false

Declared by:

services.picom.shadowExclude

List of conditions of windows that should have no shadow. See picom(1) man page for more examples.

Type: list of string

Default:

[ ]

Example:

[
  "window_type *= 'menu'"
  "name ~= 'Firefox$'"
  "focused = 1"
]

Declared by:

services.picom.shadowOffsets

Left and right offset for shadows (in pixels).

Type: pair of signed integer

Default:

[
  -15
  -15
]

Example:

[
  -10
  -15
]

Declared by:

services.picom.shadowOpacity

Window shadows opacity.

Type: integer or floating point number between 0 and 1 (both inclusive)

Default:

0.75

Example:

0.8

Declared by:

services.picom.vSync

Enable vertical synchronization.

Type: boolean

Default:

false

Declared by:

services.picom.wintypes

Rules for specific window types.

Type: attribute set

Default:

{
  popup_menu = { opacity = config.services.picom.menuOpacity; };
  dropdown_menu = { opacity = config.services.picom.menuOpacity; };
}

Example:

{ }

Declared by: