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.random-background.enable

Whether to enable random desktop background.

Note, if you are using NixOS and have set up a custom desktop manager session for Home Manager, then the session configuration must have the bgSupport option set to true or the background image set by this module may be overwritten.

Type: boolean

Default:

false

Example:

true

Declared by:

services.random-background.enableXinerama

Will place a separate image per screen when enabled, otherwise a single image will be stretched across all screens.

Type: boolean

Default:

true

Declared by:

services.random-background.package

The feh package to use.

Type: package

Default:

pkgs.feh

Declared by:

services.random-background.display

Display background images according to this option.

Type: one of “center”, “fill”, “max”, “scale”, “tile”

Default:

"fill"

Declared by:

services.random-background.imageDirectory

The directory of images from which a background should be chosen. Should be formatted in a way understood by systemd, e.g., ‘%h’ is the home directory.

Type: string

Example:

"%h/backgrounds"

Declared by:

services.random-background.interval

The duration between changing background image, set to null to only set background when logging in. Should be formatted as a duration understood by systemd.

Type: null or string

Default:

null

Example:

"1h"

Declared by: