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

gtk.enable

Whether to enable GTK theming and configuration.

Type: boolean

Default:

false

Example:

true

Declared by:

gtk.colorScheme

Default color scheme for all GTK versions

Type: null or one of “dark”, “light”

Default:

null

Declared by:

gtk.cursorTheme

Default cursor theme for all GTK versions.

Type: null or (submodule)

Default:

null

Declared by:

gtk.cursorTheme.package

Package providing the cursor theme. This package will be installed to your profile. If null then the cursor theme is assumed to already be available in your profile.

Type: null or package

Default:

null

Example:

pkgs.vanilla-dmz

Declared by:

gtk.cursorTheme.name

The name of the cursor theme within the package.

Type: string

Example:

"Vanilla-DMZ"

Declared by:

gtk.cursorTheme.size

The size of the cursor.

Type: null or signed integer

Default:

null

Example:

16

Declared by:

gtk.font

Default font for all GTK versions.

Type: null or (submodule)

Default:

null

Declared by:

gtk.font.package

Package providing the font. This package will be installed to your profile. If null then the font is assumed to already be available in your profile.

Type: null or package

Default:

null

Example:

pkgs.dejavu_fonts

Declared by:

gtk.font.name

The family name of the font within the package.

Type: string

Example:

"DejaVu Sans"

Declared by:

gtk.font.size

The size of the font.

Type: null or signed integer or floating point number

Default:

null

Example:

"8"

Declared by:

gtk.gtk2.enable

Whether to enable GTK 2 configuration.

Type: boolean

Default:

true

Example:

true

Declared by:

gtk.gtk2.configLocation

The location of the GTK 2 configuration file.

Type: absolute path

Default:

if config.home.preferXdgDirectories then
  "${config.xdg.configHome}/gtk-2.0/gtkrc"
else
  "${config.home.homeDirectory}/.gtkrc-2.0";

Example:

"${config.xdg.configHome}/gtk-2.0/gtkrc"

Declared by:

gtk.gtk2.cursorTheme

Cursor theme for GTK 2 applications.

Type: null or (submodule)

Default:

config.gtk.cursorTheme

Declared by:

gtk.gtk2.cursorTheme.package

Package providing the cursor theme. This package will be installed to your profile. If null then the cursor theme is assumed to already be available in your profile.

Type: null or package

Default:

null

Example:

pkgs.vanilla-dmz

Declared by:

gtk.gtk2.cursorTheme.name

The name of the cursor theme within the package.

Type: string

Example:

"Vanilla-DMZ"

Declared by:

gtk.gtk2.cursorTheme.size

The size of the cursor.

Type: null or signed integer

Default:

null

Example:

16

Declared by:

gtk.gtk2.extraConfig

Extra lines to add to ~/.gtkrc-2.0.

Type: strings concatenated with “\n”

Default:

""

Example:

"gtk-can-change-accels = 1"

Declared by:

gtk.gtk2.font

Font for GTK 2 applications.

Type: null or (submodule)

Default:

config.gtk.font

Declared by:

gtk.gtk2.font.package

Package providing the font. This package will be installed to your profile. If null then the font is assumed to already be available in your profile.

Type: null or package

Default:

null

Example:

pkgs.dejavu_fonts

Declared by:

gtk.gtk2.font.name

The family name of the font within the package.

Type: string

Example:

"DejaVu Sans"

Declared by:

gtk.gtk2.font.size

The size of the font.

Type: null or signed integer or floating point number

Default:

null

Example:

"8"

Declared by:

gtk.gtk2.force

Whether to enable GTK 2 config force overwrite without creating a backup.

Type: boolean

Default:

false

Example:

true

Declared by:

gtk.gtk2.iconTheme

Icon theme for GTK 2 applications.

Type: null or (submodule)

Default:

config.gtk.iconTheme

Declared by:

gtk.gtk2.iconTheme.package

Package providing the icon theme. This package will be installed to your profile. If null then the icon theme is assumed to already be available in your profile.

Type: null or package

Default:

null

Example:

pkgs.adwaita-icon-theme

Declared by:

gtk.gtk2.iconTheme.name

The name of the icon theme within the package.

Type: string

Example:

"Adwaita"

Declared by:

gtk.gtk2.theme

Theme for GTK 2 applications.

Type: null or (submodule)

Default:

config.gtk.theme

Declared by:

gtk.gtk2.theme.package

Package providing the theme. This package will be installed to your profile. If null then the theme is assumed to already be available in your profile.

For the theme to apply to GTK 4, this option is mandatory.

Type: null or package

Default:

null

Example:

pkgs.gnome.gnome-themes-extra

Declared by:

gtk.gtk2.theme.name

The name of the theme within the package.

Type: string

Example:

"Adwaita"

Declared by:

gtk.gtk3.enable

Whether to enable GTK 3 configuration.

Type: boolean

Default:

true

Example:

true

Declared by:

gtk.gtk3.bookmarks

File browser bookmarks.

Type: list of string

Default:

[ ]

Example:

[
  "file:///home/jane/Documents"
]

Declared by:

gtk.gtk3.colorScheme

Color scheme for GTK 3 applications.

Type: null or one of “dark”, “light”

Default:

config.gtk.colorScheme

Declared by:

gtk.gtk3.cursorTheme

Cursor theme for GTK 3 applications.

Type: null or (submodule)

Default:

config.gtk.cursorTheme

Declared by:

gtk.gtk3.cursorTheme.package

Package providing the cursor theme. This package will be installed to your profile. If null then the cursor theme is assumed to already be available in your profile.

Type: null or package

Default:

null

Example:

pkgs.vanilla-dmz

Declared by:

gtk.gtk3.cursorTheme.name

The name of the cursor theme within the package.

Type: string

Example:

"Vanilla-DMZ"

Declared by:

gtk.gtk3.cursorTheme.size

The size of the cursor.

Type: null or signed integer

Default:

null

Example:

16

Declared by:

gtk.gtk3.extraConfig

Extra settings for $XDG_CONFIG_HOME/gtk-3.0/settings.ini.

Type: attribute set of (boolean or signed integer or string)

Default:

{ }

Example:

{
  gtk-cursor-blink = false;
  gtk-recent-files-limit = 20;
}

Declared by:

gtk.gtk3.extraCss

Extra CSS for $XDG_CONFIG_HOME/gtk-3.0/gtk.css.

Type: strings concatenated with “\n”

Default:

""

Declared by:

gtk.gtk3.font

Font for GTK 3 applications.

Type: null or (submodule)

Default:

config.gtk.font

Declared by:

gtk.gtk3.font.package

Package providing the font. This package will be installed to your profile. If null then the font is assumed to already be available in your profile.

Type: null or package

Default:

null

Example:

pkgs.dejavu_fonts

Declared by:

gtk.gtk3.font.name

The family name of the font within the package.

Type: string

Example:

"DejaVu Sans"

Declared by:

gtk.gtk3.font.size

The size of the font.

Type: null or signed integer or floating point number

Default:

null

Example:

"8"

Declared by:

gtk.gtk3.iconTheme

Icon theme for GTK 3 applications.

Type: null or (submodule)

Default:

config.gtk.iconTheme

Declared by:

gtk.gtk3.iconTheme.package

Package providing the icon theme. This package will be installed to your profile. If null then the icon theme is assumed to already be available in your profile.

Type: null or package

Default:

null

Example:

pkgs.adwaita-icon-theme

Declared by:

gtk.gtk3.iconTheme.name

The name of the icon theme within the package.

Type: string

Example:

"Adwaita"

Declared by:

gtk.gtk3.theme

Theme for GTK 3 applications.

Type: null or (submodule)

Default:

config.gtk.theme

Declared by:

gtk.gtk3.theme.package

Package providing the theme. This package will be installed to your profile. If null then the theme is assumed to already be available in your profile.

For the theme to apply to GTK 4, this option is mandatory.

Type: null or package

Default:

null

Example:

pkgs.gnome.gnome-themes-extra

Declared by:

gtk.gtk3.theme.name

The name of the theme within the package.

Type: string

Example:

"Adwaita"

Declared by:

gtk.gtk4.enable

Whether to enable GTK 4 configuration.

Type: boolean

Default:

true

Example:

true

Declared by:

gtk.gtk4.colorScheme

Color scheme for GTK 4 applications.

Type: null or one of “dark”, “light”

Default:

config.gtk.colorScheme

Declared by:

gtk.gtk4.cursorTheme

Cursor theme for GTK 4 applications.

Type: null or (submodule)

Default:

config.gtk.cursorTheme

Declared by:

gtk.gtk4.cursorTheme.package

Package providing the cursor theme. This package will be installed to your profile. If null then the cursor theme is assumed to already be available in your profile.

Type: null or package

Default:

null

Example:

pkgs.vanilla-dmz

Declared by:

gtk.gtk4.cursorTheme.name

The name of the cursor theme within the package.

Type: string

Example:

"Vanilla-DMZ"

Declared by:

gtk.gtk4.cursorTheme.size

The size of the cursor.

Type: null or signed integer

Default:

null

Example:

16

Declared by:

gtk.gtk4.extraConfig

Extra settings for $XDG_CONFIG_HOME/gtk-4.0/settings.ini.

Type: attribute set of (boolean or signed integer or string)

Default:

{ }

Example:

{
  gtk-cursor-blink = false;
  gtk-recent-files-limit = 20;
}

Declared by:

gtk.gtk4.extraCss

Extra CSS for $XDG_CONFIG_HOME/gtk-4.0/gtk.css.

Type: strings concatenated with “\n”

Default:

""

Declared by:

gtk.gtk4.font

Font for GTK 4 applications.

Type: null or (submodule)

Default:

config.gtk.font

Declared by:

gtk.gtk4.font.package

Package providing the font. This package will be installed to your profile. If null then the font is assumed to already be available in your profile.

Type: null or package

Default:

null

Example:

pkgs.dejavu_fonts

Declared by:

gtk.gtk4.font.name

The family name of the font within the package.

Type: string

Example:

"DejaVu Sans"

Declared by:

gtk.gtk4.font.size

The size of the font.

Type: null or signed integer or floating point number

Default:

null

Example:

"8"

Declared by:

gtk.gtk4.iconTheme

Icon theme for GTK 4 applications.

Type: null or (submodule)

Default:

config.gtk.iconTheme

Declared by:

gtk.gtk4.iconTheme.package

Package providing the icon theme. This package will be installed to your profile. If null then the icon theme is assumed to already be available in your profile.

Type: null or package

Default:

null

Example:

pkgs.adwaita-icon-theme

Declared by:

gtk.gtk4.iconTheme.name

The name of the icon theme within the package.

Type: string

Example:

"Adwaita"

Declared by:

gtk.gtk4.theme

Theme for GTK 4 applications.

Warning: This is not officially supported and applied using a workaround. It may cause issues with some apps.

For context, see Please don’t theme our apps and Restyling apps at scale.

Type: null or (submodule)

Default:

if lib.versionAtLeast config.home.stateVersion "26.05" then null else config.gtk.theme

Declared by:

gtk.gtk4.theme.package

Package providing the theme. This package will be installed to your profile. If null then the theme is assumed to already be available in your profile.

For the theme to apply to GTK 4, this option is mandatory.

Type: null or package

Default:

null

Example:

pkgs.gnome.gnome-themes-extra

Declared by:

gtk.gtk4.theme.name

The name of the theme within the package.

Type: string

Example:

"Adwaita"

Declared by:

gtk.iconTheme

Default icon theme for all GTK versions.

Type: null or (submodule)

Default:

null

Declared by:

gtk.iconTheme.package

Package providing the icon theme. This package will be installed to your profile. If null then the icon theme is assumed to already be available in your profile.

Type: null or package

Default:

null

Example:

pkgs.adwaita-icon-theme

Declared by:

gtk.iconTheme.name

The name of the icon theme within the package.

Type: string

Example:

"Adwaita"

Declared by:

gtk.theme

Default theme for GTK 2/3.

Type: null or (submodule)

Default:

null

Declared by:

gtk.theme.package

Package providing the theme. This package will be installed to your profile. If null then the theme is assumed to already be available in your profile.

For the theme to apply to GTK 4, this option is mandatory.

Type: null or package

Default:

null

Example:

pkgs.gnome.gnome-themes-extra

Declared by:

gtk.theme.name

The name of the theme within the package.

Type: string

Example:

"Adwaita"

Declared by: