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

programs.desktoppr.enable

Whether to enable managing the desktop picture/wallpaper on macOS using desktoppr.

Type: boolean

Default:

false

Example:

true

Declared by:

programs.desktoppr.package

The desktoppr package to use.

Type: package

Default:

pkgs.desktoppr

Declared by:

programs.desktoppr.settings

The settings to set for desktoppr.

Type: open submodule of attribute set of anything

Default:

{ }

Example:

{
  picture = "/System/Library/Desktop Pictures/Solid Colors/Stone.png";
}

Declared by:

programs.desktoppr.settings.color

The background color that will be used behind the chosen picture when it does not fill the screen.

Type: string matching the pattern [0-9a-fA-F]{6}

Default:

"000000"

Example:

"2E2E2E"

Declared by:

programs.desktoppr.settings.picture

The path to the desktop picture/wallpaper to set. Can also be an HTTP or HTTPS URL to retrieve the picture from a remote URL at runtime.

Type: null or absolute path or string matching the pattern ^http(s)?://.*$

Default:

null

Example:

"/System/Library/Desktop Pictures/Solid Colors/Stone.png"

Declared by:

programs.desktoppr.settings.scale

The scaling behavior to use when using an image.

Type: one of “fill”, “stretch”, “center”, “fit”

Default:

"fill"

Example:

"fit"

Declared by:

programs.desktoppr.settings.setOnlyOnce

If false (the default), the desktop picture/wallpaper will be reset to the configured parameters on every system configuration change.

If true, the desktop picture/wallpaper will only be set when it differs from the one previously set. This allows the user to manually change the desktop picture/wallpaper after it has been set.

Type: boolean

Default:

false

Example:

true

Declared by:

programs.desktoppr.settings.sha256

An optional SHA256 checksum of the desktop picture/wallpaper. If the specified file does not match the checksum, it will not be set.

Type: null or string matching the pattern ^[a-f0-9]{64}$

Default:

null

Example:

"e1e594dec9343b721005a6bf06c48e0aac34ac9a77090e42b543bae9e1e0354a"

Declared by: