From 0f264f407f9ccd58a459cecd377296c4c608c256 Mon Sep 17 00:00:00 2001 From: teto Date: Thu, 22 Sep 2022 08:40:53 +0000 Subject: [PATCH] deploy: bd83eab6220226085c82e637931a7ae3863d9893 --- index.html | 4 +- nix-darwin-options.html | 2 +- nixos-options.html | 2 +- options.html | 626 ++++++++++++++++++++-------------------- tools.html | 14 +- 5 files changed, 324 insertions(+), 324 deletions(-) diff --git a/index.html b/index.html index 014539230..d86e0e08e 100644 --- a/index.html +++ b/index.html @@ -1,6 +1,6 @@ -Home Manager Manual

Home Manager Manual


Preface
1. Installing Home Manager
1.1. Standalone installation
1.2. NixOS module
1.3. nix-darwin module
2. Using Home Manager
2.1. Configuration Example
2.2. Rollbacks
2.3. Keeping your ~ safe from harm
2.4. Graphical services
2.5. Updating
3. Nix Flakes
3.1. Prerequisties
3.2. Standalone setup
3.3. NixOS module
3.4. nix-darwin module
4. Writing Home Manager Modules
4.1. Option Types
5. Contributing
5.1. Getting started
5.2. Guidelines
5.2.1. Maintain backward compatibility
5.2.2. Keep forward compatibility in mind
5.2.3. Add only valuable options
5.2.4. Add relevant tests
5.2.5. Add relevant documentation
5.2.6. Add yourself as a module maintainer
5.2.7. Format your code
5.2.8. Format your commit messages
5.2.9. Format your news entries
5.2.10. Use conditional modules and news
5.2.11. Mind the license
5.3. Commits
5.4. Code Style
5.5. News
5.6. Tests
6. Frequently Asked Questions (FAQ)
6.1. Why is there a collision error when switching generation?
6.2. Why are the session variables not set?
6.3. How to set up a configuration for multiple users/machines?
6.4. Why do I get an error message about ca.desrt.dconf or dconf.service?
6.5. How do I install packages from Nixpkgs unstable?
6.6. How do I override the package used by a module?
A. Configuration Options
B. NixOS Module Options
C. nix-darwin Module Options
D. Tools
home-manager - — reconfigure a user environment
E. Release Notes
E.1. Release 22.11
E.1.1. Highlights
E.1.2. State Version Changes
E.2. Release 22.05
E.2.1. Highlights
E.2.2. State Version Changes
E.3. Release 21.11
E.3.1. Highlights
E.3.2. State Version Changes
E.4. Release 21.05
E.4.1. Highlights
E.4.2. State Version Changes
E.5. Release 20.09
E.5.1. Highlights
E.5.2. State Version Changes
E.6. Release 20.03
E.6.1. Highlights
E.6.2. State Version Changes
E.7. Release 19.09
E.7.1. Highlights
E.7.2. State Version Changes
E.8. Release 19.03
E.8.1. Highlights
E.8.2. State Version Changes
E.9. Release 18.09

Preface

+Home Manager Manual

Home Manager Manual


Preface
1. Installing Home Manager
1.1. Standalone installation
1.2. NixOS module
1.3. nix-darwin module
2. Using Home Manager
2.1. Configuration Example
2.2. Rollbacks
2.3. Keeping your ~ safe from harm
2.4. Graphical services
2.5. Updating
3. Nix Flakes
3.1. Prerequisties
3.2. Standalone setup
3.3. NixOS module
3.4. nix-darwin module
4. Writing Home Manager Modules
4.1. Option Types
5. Contributing
5.1. Getting started
5.2. Guidelines
5.2.1. Maintain backward compatibility
5.2.2. Keep forward compatibility in mind
5.2.3. Add only valuable options
5.2.4. Add relevant tests
5.2.5. Add relevant documentation
5.2.6. Add yourself as a module maintainer
5.2.7. Format your code
5.2.8. Format your commit messages
5.2.9. Format your news entries
5.2.10. Use conditional modules and news
5.2.11. Mind the license
5.3. Commits
5.4. Code Style
5.5. News
5.6. Tests
6. Frequently Asked Questions (FAQ)
6.1. Why is there a collision error when switching generation?
6.2. Why are the session variables not set?
6.3. How to set up a configuration for multiple users/machines?
6.4. Why do I get an error message about ca.desrt.dconf or dconf.service?
6.5. How do I install packages from Nixpkgs unstable?
6.6. How do I override the package used by a module?
A. Configuration Options
B. NixOS Module Options
C. nix-darwin Module Options
D. Tools
home-manager + — reconfigure a user environment
E. Release Notes
E.1. Release 22.11
E.1.1. Highlights
E.1.2. State Version Changes
E.2. Release 22.05
E.2.1. Highlights
E.2.2. State Version Changes
E.3. Release 21.11
E.3.1. Highlights
E.3.2. State Version Changes
E.4. Release 21.05
E.4.1. Highlights
E.4.2. State Version Changes
E.5. Release 20.09
E.5.1. Highlights
E.5.2. State Version Changes
E.6. Release 20.03
E.6.1. Highlights
E.6.2. State Version Changes
E.7. Release 19.09
E.7.1. Highlights
E.7.2. State Version Changes
E.8. Release 19.03
E.8.1. Highlights
E.8.2. State Version Changes
E.9. Release 18.09

Preface

This manual will eventually describe how to install, use, and extend Home Manager.

diff --git a/nix-darwin-options.html b/nix-darwin-options.html index 9118f2677..39c0c3224 100644 --- a/nix-darwin-options.html +++ b/nix-darwin-options.html @@ -30,7 +30,7 @@ options nixpkgs.* .

Type: boolean

Default: false

Example: true

Declared by:

<home-manager/nixos/common.nix>
home-manager.users

Per-user Home Manager configuration. -

Type: attribute set of Home Manager module

Default: +

Type: attribute set of (Home Manager module)

Default: { } diff --git a/nixos-options.html b/nixos-options.html index 25f4efc74..148a7d96a 100644 --- a/nixos-options.html +++ b/nixos-options.html @@ -30,7 +30,7 @@ options nixpkgs.* .

Type: boolean

Default: false

Example: true

Declared by:

<home-manager/nixos/common.nix>
home-manager.users

Per-user Home Manager configuration. -

Type: attribute set of Home Manager module

Default: +

Type: attribute set of (Home Manager module)

Default: { } diff --git a/options.html b/options.html index 5a26110e6..6756d2c17 100644 --- a/options.html +++ b/options.html @@ -1,7 +1,7 @@ Appendix A. Configuration Options

Appendix A. Configuration Options

_module.args

Type: lazy attribute set of raw value

Declared by:

<home-manager/lib/modules.nix> -
accounts.email.accounts

List of email accounts.

Type: attribute set of submodule

Default: +

accounts.email.accounts

List of email accounts.

Type: attribute set of (submodule)

Default: { } @@ -42,7 +42,7 @@

accounts.email.accounts.<name>.aerc.extraAccounts

Extra config added to the configuration of this account in $HOME/.config/aerc/accounts.conf. See aerc-config(5). -

Type: attribute set of values (null, bool, int, string of float) or a list of values, that will be joined with a comma

Default: +

Type: attribute set of (values (null, bool, int, string of float) or a list of values, that will be joined with a comma)

Default: { } @@ -51,7 +51,7 @@ See aerc-config(5).

accounts.email.accounts.<name>.aerc.extraBinds

Extra bindings specific to this account, added to $HOME/.config/aerc/accounts.conf. See aerc-config(5). -

Type: attribute set of attribute set of values (null, bool, int, string of float) or a list of values, that will be joined with a comma

Default: +

Type: attribute set of attribute set of (values (null, bool, int, string of float) or a list of values, that will be joined with a comma)

Default: { } @@ -60,7 +60,7 @@ See aerc-config(5).

accounts.email.accounts.<name>.aerc.extraConfig

Extra config specific to this account, added to $HOME/.config/aerc/aerc.conf. See aerc-config(5). -

Type: attribute set of attribute set of values (null, bool, int, string of float) or a list of values, that will be joined with a comma

Default: +

Type: attribute set of attribute set of (values (null, bool, int, string of float) or a list of values, that will be joined with a comma)

Default: { } @@ -162,7 +162,7 @@ users should either enable delete or disable <home-manager/modules/programs/getmail.nix>

accounts.email.accounts.<name>.getmail.mailboxes

A non-empty list of mailboxes. To download all mail you can use the ALL mailbox. -

Type: non-empty list of string

Default: +

Type: non-empty (list of string)

Default: [ ] @@ -178,7 +178,7 @@ disable readAll.

Type: boolean

Default: true

Declared by:

<home-manager/modules/programs/getmail.nix>
accounts.email.accounts.<name>.gpg

GPG configuration. -

Type: null or submodule

Default: null

Declared by:

+

Type: null or (submodule)

Default: null

Declared by:

<home-manager/modules/accounts/email.nix>
accounts.email.accounts.<name>.gpg.encryptByDefault

Encrypt outgoing messages by default.

Type: boolean

Default: false

Declared by:

<home-manager/modules/accounts/email.nix> @@ -202,7 +202,7 @@ account configuration.

Declared by:

<home-manager/modules/programs/himalaya.nix>
accounts.email.accounts.<name>.imap

The IMAP configuration to use for this account. -

Type: null or submodule

Default: null

Declared by:

+

Type: null or (submodule)

Default: null

Declared by:

<home-manager/modules/accounts/email.nix>
accounts.email.accounts.<name>.imap.host

Hostname of IMAP server.

Type: string

Example: "imap.example.org"

Declared by:

@@ -225,7 +225,7 @@ account configuration. be used to validate the connection authenticity. If null then the system default is used. Note, if set then the system default may still be accepted. -

Type: null or path

Default: "config.accounts.email.certificatesFile"

Declared by:

+

Type: null or (path)

Default: "config.accounts.email.certificatesFile"

Declared by:

<home-manager/modules/accounts/email.nix>
accounts.email.accounts.<name>.imap.tls.useStartTls

Whether to use STARTTLS.

Type: boolean

Default: false

Declared by:

@@ -242,7 +242,7 @@ Note, if set then the system default may still be accepted. ]

Declared by:

<home-manager/modules/services/imapnotify.nix> -
accounts.email.accounts.<name>.imapnotify.extraConfig

Additional configuration to add for this account.

Type: attribute set of boolean or signed integer or string

Default: +

accounts.email.accounts.<name>.imapnotify.extraConfig

Additional configuration to add for this account.

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

Default: { } @@ -261,7 +261,7 @@ Note, if set then the system default may still be accepted.

Declared by:

<home-manager/modules/services/imapnotify.nix>
accounts.email.accounts.<name>.jmap

The JMAP configuration to use for this account. -

Type: null or submodule

Default: null

Declared by:

+

Type: null or (submodule)

Default: null

Declared by:

<home-manager/modules/accounts/email.nix>
accounts.email.accounts.<name>.jmap.host

Hostname of JMAP server.

@@ -351,7 +351,7 @@ for more information about the format.

Type: string

Default: "*:0/5"

Declared by:

<home-manager/modules/programs/lieer.nix>
accounts.email.accounts.<name>.maildir

Maildir configuration for this account. -

Type: null or submodule

Default: +

Type: null or (submodule)

Default: { path = "\${name}"; } @@ -372,7 +372,7 @@ the given mail store.

Type: one of "none", "maildir", "imap", "both"

Default: "none"

Example: "both"

Declared by:

<home-manager/modules/programs/mbsync.nix>
accounts.email.accounts.<name>.mbsync.extraConfig.account

Account section extra configuration. -

Type: attribute set of string or signed integer or boolean or list of string

Default: +

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

Default: { } @@ -383,7 +383,7 @@ the given mail store.

Declared by:

<home-manager/modules/programs/mbsync.nix>
accounts.email.accounts.<name>.mbsync.extraConfig.channel

Per channel extra configuration. -

Type: attribute set of string or signed integer or boolean or list of string

Default: +

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

Default: { } @@ -394,14 +394,14 @@ the given mail store.

Declared by:

<home-manager/modules/programs/mbsync.nix>
accounts.email.accounts.<name>.mbsync.extraConfig.local

Local store extra configuration. -

Type: attribute set of string or signed integer or boolean or list of string

Default: +

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

Default: { }

Declared by:

<home-manager/modules/programs/mbsync.nix>
accounts.email.accounts.<name>.mbsync.extraConfig.remote

Remote store extra configuration. -

Type: attribute set of string or signed integer or boolean or list of string

Default: +

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

Default: { } @@ -419,7 +419,7 @@ the [Gmail]/ directory.

This option allows you to specify a group, and subsequently channels that will allow you to sync your mail into an arbitrary hierarchy. -

Type: attribute set of submodule

Default: +

Type: attribute set of (submodule)

Default: { } @@ -431,7 +431,7 @@ the individual channels.

Using these channels and then grouping them together allows for you to define the maildir hierarchy as you see fit. -

Type: attribute set of submodule

Default: +

Type: attribute set of (submodule)

Default: { } @@ -439,7 +439,7 @@ define the maildir hierarchy as you see fit. <home-manager/modules/programs/mbsync.nix>

accounts.email.accounts.<name>.mbsync.groups.<name>.channels.<name>.extraConfig

Extra configuration lines to add to THIS channel's configuration. -

Type: attribute set of string or signed integer or boolean or list of string

Default: +

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

Default: { } @@ -669,7 +669,7 @@ attribute name of the account configuration.

accounts.email.accounts.<name>.neomutt.extraConfig

Extra lines to add to the folder hook for this account.

Type: strings concatenated with "\n"

Default: ""

Example: "color status cyan default"

Declared by:

<home-manager/modules/programs/neomutt.nix> -
accounts.email.accounts.<name>.neomutt.extraMailboxes

List of extra mailboxes

Type: list of string or submodule

Default: +

accounts.email.accounts.<name>.neomutt.extraMailboxes

List of extra mailboxes

Type: list of (string or (submodule))

Default: [ ] @@ -689,7 +689,7 @@ else

accounts.email.accounts.<name>.offlineimap.enable

Whether to enable OfflineIMAP.

Type: boolean

Default: false

Example: true

Declared by:

<home-manager/modules/programs/offlineimap.nix>
accounts.email.accounts.<name>.offlineimap.extraConfig.account

Extra configuration options to add to the account section. -

Type: attribute set of string or signed integer or boolean

Default: +

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

Default: { } @@ -701,7 +701,7 @@ else <home-manager/modules/programs/offlineimap.nix>

accounts.email.accounts.<name>.offlineimap.extraConfig.local

Extra configuration options to add to the local account section. -

Type: attribute set of string or signed integer or boolean

Default: +

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

Default: { } @@ -713,7 +713,7 @@ section. <home-manager/modules/programs/offlineimap.nix>

accounts.email.accounts.<name>.offlineimap.extraConfig.remote

Extra configuration options to add to the remote account section. -

Type: attribute set of string or signed integer or boolean

Default: +

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

Default: { } @@ -742,7 +742,7 @@ set as primary. }

Declared by:

<home-manager/modules/accounts/email.nix> -
accounts.email.accounts.<name>.signature.command

A command that generates a signature.

Type: null or path

Default: null

Example:

pkgs.writeScript "signature" "echo This is my signature"
+                
accounts.email.accounts.<name>.signature.command

A command that generates a signature.

Type: null or (path)

Default: null

Example:

pkgs.writeScript "signature" "echo This is my signature"
 

Declared by:

<home-manager/modules/accounts/email.nix>
accounts.email.accounts.<name>.signature.showSignature

Method to communicate the signature.

Type: one of "append", "attach", "none"

Default: "none"

Declared by:

@@ -755,7 +755,7 @@ May the force be with you. ''

Declared by:

<home-manager/modules/accounts/email.nix>
accounts.email.accounts.<name>.smtp

The SMTP configuration to use for this account. -

Type: null or submodule

Default: null

Declared by:

+

Type: null or (submodule)

Default: null

Declared by:

<home-manager/modules/accounts/email.nix>
accounts.email.accounts.<name>.smtp.host

Hostname of SMTP server.

Type: string

Example: "smtp.example.org"

Declared by:

@@ -778,7 +778,7 @@ May the force be with you. be used to validate the connection authenticity. If null then the system default is used. Note, if set then the system default may still be accepted. -

Type: null or path

Default: "config.accounts.email.certificatesFile"

Declared by:

+

Type: null or (path)

Default: "config.accounts.email.certificatesFile"

Declared by:

<home-manager/modules/accounts/email.nix>
accounts.email.accounts.<name>.smtp.tls.useStartTls

Whether to use STARTTLS.

Type: boolean

Default: false

Declared by:

@@ -790,7 +790,7 @@ the SMTP, IMAP, and JMAP user name.
accounts.email.certificatesFile

Path to default file containing certificate authorities that should be used to validate the connection authenticity. This path may be overridden on a per-account basis. -

Type: null or path

Default: "/etc/ssl/certs/ca-certificates.crt"

Declared by:

+

Type: null or (path)

Default: "/etc/ssl/certs/ca-certificates.crt"

Declared by:

<home-manager/modules/accounts/email.nix>
accounts.email.maildirBasePath

The base directory for account maildir directories. May be a relative path, in which case it is relative the home @@ -798,7 +798,7 @@ directory.

Type: string

Default: "$HOME/Maildir"

Declared by:

<home-manager/modules/accounts/email.nix>
dconf.settings

Settings to write to the dconf configuration system. -

Type: attribute set of attribute set of GVariant value

Default: +

Type: attribute set of attribute set of (GVariant value)

Default: { } @@ -819,7 +819,7 @@ directory. root = true is automatically added to the file, it must not be added here. See https://editorconfig.org for documentation. -

Type: attribute set of attribute set of INI atom (null, bool, int, float or string)

Default: +

Type: attribute set of attribute set of (INI atom (null, bool, int, float or string))

Default: { } @@ -845,7 +845,7 @@ configurations installed through <home-manager/modules/misc/fontconfig.nix>

gtk.enable

Whether to enable GTK 2/3 configuration.

Type: boolean

Default: false

Example: true

Declared by:

<home-manager/modules/misc/gtk.nix> -
gtk.cursorTheme

The cursor theme to use.

Type: null or submodule

Default: null

Declared by:

+
gtk.cursorTheme

The cursor theme to use.

Type: null or (submodule)

Default: null

Declared by:

<home-manager/modules/misc/gtk.nix>
gtk.cursorTheme.package

Package providing the cursor theme. This package will be installed to your profile. If null then the theme @@ -858,7 +858,7 @@ is assumed to already be available in your profile.

Type: null or signed integer

Default: null

Example: 16

Declared by:

<home-manager/modules/misc/gtk.nix>
gtk.font

The font to use in GTK+ 2/3 applications. -

Type: null or submodule

Default: null

Declared by:

+

Type: null or (submodule)

Default: null

Declared by:

<home-manager/modules/misc/gtk.nix>
gtk.font.package

Package providing the font. This package will be installed to your profile. If null then the font @@ -890,7 +890,7 @@ is assumed to already be available in your profile. <home-manager/modules/misc/gtk.nix>

gtk.gtk3.extraConfig

Extra configuration options to add to $XDG_CONFIG_HOME/gtk-3.0/settings.ini. -

Type: attribute set of boolean or signed integer or string

Default: +

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

Default: { } @@ -906,7 +906,7 @@ is assumed to already be available in your profile. <home-manager/modules/misc/gtk.nix>

gtk.gtk4.extraConfig

Extra configuration options to add to $XDG_CONFIG_HOME/gtk-4.0/settings.ini. -

Type: attribute set of boolean or signed integer or string

Default: +

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

Default: { } @@ -916,7 +916,7 @@ is assumed to already be available in your profile. }

Declared by:

<home-manager/modules/misc/gtk.nix> -
gtk.iconTheme

The icon theme to use.

Type: null or submodule

Default: null

Declared by:

+
gtk.iconTheme

The icon theme to use.

Type: null or (submodule)

Default: null

Declared by:

<home-manager/modules/misc/gtk.nix>
gtk.iconTheme.package

Package providing the icon theme. This package will be installed to your profile. If null then the theme @@ -925,7 +925,7 @@ is assumed to already be available in your profile. <home-manager/modules/misc/gtk.nix>

gtk.iconTheme.name

The name of the icon theme within the package.

Type: string

Example: "Adwaita"

Declared by:

<home-manager/modules/misc/gtk.nix> -
gtk.theme

The GTK+2/3 theme to use.

Type: null or submodule

Default: null

Declared by:

+
gtk.theme

The GTK+2/3 theme to use.

Type: null or (submodule)

Default: null

Declared by:

<home-manager/modules/misc/gtk.nix>
gtk.theme.package

Package providing the theme. This package will be installed to your profile. If null then the theme @@ -1016,7 +1016,7 @@ the user environment. ]

Declared by:

<home-manager/modules/home-environment.nix> -
home.file

Attribute set of files to link into the user home.

Type: attribute set of submodule

Default: +

home.file

Attribute set of files to link into the user home.

Type: attribute set of (submodule)

Default: { } @@ -1068,7 +1068,7 @@ undefined for state version ≥ 20.09 <home-manager/modules/home-environment.nix>

home.keyboard

Keyboard configuration. Set to null to disable Home Manager keyboard management. -

Type: null or submodule

Default:

"{ }"  for state version < 21.11,
+

Type: null or (submodule)

Default:

"{ }"  for state version < 21.11,
 "null" for state version ≥ 21.11
 

Declared by:

<home-manager/modules/home-environment.nix> @@ -1151,7 +1151,7 @@ configurations are generated. If you need configurations for specific backends, you can toggle them via the enable option. For example, home.pointerCursor.x11.enable will enable x11 cursor configurations. -

Type: null or submodule

Default: null

Declared by:

+

Type: null or (submodule)

Default: null

Declared by:

<home-manager/modules/config/home-cursor.nix>
home.pointerCursor.package

Package providing the cursor theme.

Type: package

Example: pkgs.vanilla-dmz

Declared by:

<home-manager/modules/config/home-cursor.nix> @@ -1331,7 +1331,7 @@ for details on supported values. of launchd's LaunchAgents.

Type: boolean

Default: pkgs.stdenv.hostPlatform.isDarwin

Declared by:

<home-manager/modules/launchd/default.nix> -
launchd.agents

Define LaunchAgents.

Type: attribute set of submodule

Default: +

launchd.agents

Define LaunchAgents.

Type: attribute set of (submodule)

Default: { } @@ -1391,7 +1391,7 @@ send the SIGKILL signal. <home-manager/modules/launchd/default.nix>

launchd.agents.<name>.config.EnvironmentVariables

This optional key is used to specify additional environment variables to be set before running the job. -

Type: null or attribute set of string

Default: null

Declared by:

+

Type: null or (attribute set of string)

Default: null

Declared by:

<home-manager/modules/launchd/default.nix>
launchd.agents.<name>.config.ExitTimeOut

The amount of time launchd waits before sending a SIGKILL signal. The default value is 20 seconds. The value zero is interpreted as infinity. @@ -1404,7 +1404,7 @@ group of the user. <home-manager/modules/launchd/default.nix>

launchd.agents.<name>.config.HardResourceLimits

Resource limits to be imposed on the job. These adjust variables set with setrlimit(2). The following keys apply: -

Type: null or submodule

Default: null

Example: +

Type: null or (submodule)

Default: null

Example: { NumberOfFiles = 4096; } @@ -1457,7 +1457,7 @@ multiple keys are provided, launchd ORs them, thus providing maximum flexibility the logic and stall if necessary. If launchd finds no reason to restart the job, it falls back on demand based invocation. Jobs that exit quickly and frequently when configured to be kept alive will be throttled to converve system resources. -

Type: null or boolean or submodule

Default: null

Declared by:

+

Type: null or boolean or (submodule)

Default: null

Declared by:

<home-manager/modules/launchd/default.nix>
launchd.agents.<name>.config.Label

This required key uniquely identifies the job to launchd.

Type: string

Declared by:

<home-manager/modules/launchd/default.nix> @@ -1467,11 +1467,11 @@ job cannot be safely respawned without a full machine reboot, then set this key <home-manager/modules/launchd/default.nix>
launchd.agents.<name>.config.LimitLoadFromHosts

This configuration file only applies to hosts NOT listed with this key. Note: One should set kern.host-name kern.hostname name in sysctl.conf(5) for this feature to work reliably. -

Type: null or list of string

Default: null

Declared by:

+

Type: null or (list of string)

Default: null

Declared by:

<home-manager/modules/launchd/default.nix>
launchd.agents.<name>.config.LimitLoadToHosts

This configuration file only applies to the hosts listed with this key. Note: One should set kern.host-name kern.hostname name in sysctl.conf(5) for this feature to work reliably. -

Type: null or list of string

Default: null

Declared by:

+

Type: null or (list of string)

Default: null

Declared by:

<home-manager/modules/launchd/default.nix>
launchd.agents.<name>.config.LimitLoadToSessionType

This configuration file only applies to sessions of the type specified. This key is used in concert with the -S flag to launchctl. @@ -1487,7 +1487,7 @@ be a boolean and set to true. Alternatively, a dictionary can be used instead o Finally, for the job itself, the values will be replaced with Mach ports at the time of check-in with launchd. -

Type: null or submodule

Default: null

Example: +

Type: null or (submodule)

Default: null

Example: { ResetAtClose = true; } @@ -1538,15 +1538,15 @@ resource limits to the job, throttling its CPU usage and I/O bandwidth. The foll

launchd.agents.<name>.config.Program

This key maps to the first argument of execvp(3). If this key is missing, then the first element of the array of strings provided to the ProgramArguments will be used instead. This key is required in the absence of the ProgramArguments key. -

Type: null or path

Default: null

Declared by:

+

Type: null or (path)

Default: null

Declared by:

<home-manager/modules/launchd/default.nix>
launchd.agents.<name>.config.ProgramArguments

This key maps to the second argument of execvp(3). This key is required in the absence of the Program key. Please note: many people are confused by this key. Please read execvp(3) very carefully! -

Type: null or list of string

Default: null

Declared by:

+

Type: null or (list of string)

Default: null

Declared by:

<home-manager/modules/launchd/default.nix>
launchd.agents.<name>.config.QueueDirectories

Much like the WatchPaths option, this key will watch the paths for modifications. The difference being that the job will only be started if the path is a directory and the directory is not empty. -

Type: null or list of string

Default: null

Declared by:

+

Type: null or (list of string)

Default: null

Declared by:

<home-manager/modules/launchd/default.nix>
launchd.agents.<name>.config.RootDirectory

This optional key is used to specify a directory to chroot(2) to before running the job.

Type: null or string

Default: null

Declared by:

@@ -1565,7 +1565,7 @@ to be effectively equivalent, even though each file descriptor likely represents protocol which conforms to the criteria specified in the job configuration file. The parameters below are used as inputs to call getaddrinfo(3). -

Type: null or attribute set of submodule

Default: null

Declared by:

+

Type: null or (attribute set of (submodule))

Default: null

Declared by:

<home-manager/modules/launchd/default.nix>
launchd.agents.<name>.config.Sockets.<name>.Bonjour

This optional key can be used to request that the service be registered with the mDNSResponder(8). If the value is boolean, the service name is inferred from the SockService-Name. SockServiceName. @@ -1599,7 +1599,7 @@ octal, so please convert the value to decimal. <home-manager/modules/launchd/default.nix>

launchd.agents.<name>.config.Sockets.<name>.SockPathName

This optional key implies SockFamily is set to "Unix". It specifies the path to connect(2) or bind(2) to. -

Type: null or path

Default: null

Declared by:

+

Type: null or (path)

Default: null

Declared by:

<home-manager/modules/launchd/default.nix>
launchd.agents.<name>.config.Sockets.<name>.SockProtocol

This optional key specifies the protocol to be passed to socket(2). The only value understood by this key at the moment is "TCP". @@ -1614,7 +1614,7 @@ other valid values for this key are "dgram" and "seqpacket" respectively. <home-manager/modules/launchd/default.nix>

launchd.agents.<name>.config.SoftResourceLimits

Resource limits to be imposed on the job. These adjust variables set with setrlimit(2). The following keys apply: -

Type: null or submodule

Default: null

Declared by:

+

Type: null or (submodule)

Default: null

Declared by:

<home-manager/modules/launchd/default.nix>
launchd.agents.<name>.config.SoftResourceLimits.CPU

The maximum amount of cpu time (in seconds) to be used by each process.

Type: null or signed integer

Default: null

Declared by:

@@ -1652,21 +1652,21 @@ stack segment may be extended. Stack extension is performed automatically by th

Type: null or signed integer

Default: null

Declared by:

<home-manager/modules/launchd/default.nix>
launchd.agents.<name>.config.StandardErrorPath

This optional key specifies what file should be used for data being sent to stderr when using stdio(3). -

Type: null or path

Default: null

Declared by:

+

Type: null or (path)

Default: null

Declared by:

<home-manager/modules/launchd/default.nix>
launchd.agents.<name>.config.StandardInPath

This optional key specifies what file should be used for data being supplied to stdin when using stdio(3). -

Type: null or path

Default: null

Declared by:

+

Type: null or (path)

Default: null

Declared by:

<home-manager/modules/launchd/default.nix>
launchd.agents.<name>.config.StandardOutPath

This optional key specifies what file should be used for data being sent to stdout when using stdio(3). -

Type: null or path

Default: null

Declared by:

+

Type: null or (path)

Default: null

Declared by:

<home-manager/modules/launchd/default.nix>
launchd.agents.<name>.config.StartCalendarInterval

This optional key causes the job to be started every calendar interval as specified. Missing arguments are considered to be wildcard. The semantics are much like crontab(5). Unlike cron which skips job invocations when the computer is asleep, launchd will start the job the next time the computer wakes up. If multiple intervals transpire before the computer is woken, those events will be coalesced into one event upon wake from sleep. -

Type: null or list of submodule

Default: null

Example: +

Type: null or (list of (submodule))

Default: null

Example: { Hour = 2; Minute = 30; } @@ -1719,13 +1719,13 @@ to attach before any code in the job is executed.

Type: null or boolean

Default: null

Declared by:

<home-manager/modules/launchd/default.nix>
launchd.agents.<name>.config.WatchPaths

This optional key causes the job to be started if any one of the listed paths are modified. -

Type: null or list of path

Default: null

Declared by:

+

Type: null or (list of (path))

Default: null

Declared by:

<home-manager/modules/launchd/default.nix>
launchd.agents.<name>.config.WorkingDirectory

This optional key is used to specify a directory to chdir(2) to before running the job.

Type: null or string

Default: null

Declared by:

<home-manager/modules/launchd/default.nix>
launchd.agents.<name>.config.inetdCompatibility

The presence of this key specifies that the daemon expects to be run as if it were launched from inetd. -

Type: null or submodule

Default: null

Example: +

Type: null or (submodule)

Default: null

Example: { Wait = true; } @@ -1738,7 +1738,7 @@ called on behalf of the job, and the result is passed via the standard in/out/er <home-manager/modules/launchd/default.nix>

lib

This option allows modules to define helper functions, constants, etc. -

Type: attribute set of attribute set

Default: +

Type: attribute set of (attribute set)

Default: { } @@ -1799,7 +1799,7 @@ keep-derivations = true ''

Declared by:

<home-manager/modules/misc/nix.nix>
nix.registry

User level flake registry. -

Type: attribute set of submodule

Default: +

Type: attribute set of (submodule)

Default: { } @@ -1811,15 +1811,15 @@ match with a reference like nixpkgs/nixos-20.03.

Type: boolean

Default: true

Declared by:

<home-manager/modules/misc/nix.nix>
nix.registry.<name>.flake

The flake input to which from> is to be rewritten. -

Type: null or attribute set

Default: null

Example: nixpkgs

Declared by:

+

Type: null or (attribute set)

Default: null

Example: nixpkgs

Declared by:

<home-manager/modules/misc/nix.nix> -
nix.registry.<name>.from

The flake reference to be rewritten.

Type: attribute set of string or signed integer or boolean or package

Example: +

nix.registry.<name>.from

The flake reference to be rewritten.

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

Example: { id = "nixpkgs"; type = "indirect"; }

Declared by:

<home-manager/modules/misc/nix.nix> -
nix.registry.<name>.to

The flake reference to which from> is to be rewritten.

Type: attribute set of string or signed integer or boolean or package

Example: +

nix.registry.<name>.to

The flake reference to which from> is to be rewritten.

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

Example: { owner = "my-org"; repo = "my-nixpkgs"; type = "github"; } @@ -1832,7 +1832,7 @@ The value declared here will be translated directly to the key-value pairs Nix e

Configuration specified in nix.extraOptions which will be appended verbatim to the resulting config file. -

Type: attribute set of Nix config atom (null, bool, int, float, str, path or package) or list of Nix config atom (null, bool, int, float, str, path or package)

Default: +

Type: attribute set of (Nix config atom (null, bool, int, float, str, path or package) or list of (Nix config atom (null, bool, int, float, str, path or package)))

Default: { } @@ -1867,7 +1867,7 @@ file and include something like

in your Home Manager configuration. -

Type: null or nixpkgs config

Default: null

Example: +

Type: null or (nixpkgs config)

Default: null

Example: { allowBroken = true; } @@ -1892,7 +1892,7 @@ Like nixpkgs.config this option only applies within the Home Manager configuration. See nixpkgs.config for a suggested setup that works both internally and externally. -

Type: null or list of nixpkgs overlay

Default: null

Example:

[ (self: super: {
+

Type: null or (list of (nixpkgs overlay))

Default: null

Example:

[ (self: super: {
     openssh = super.openssh.override {
       hpnSupport = true;
       withKerberos = true;
@@ -1946,7 +1946,7 @@ set autosave=true
                     <home-manager/modules/programs/aerc.nix>
                 
programs.aerc.extraAccounts

Extra lines added to $HOME/.config/aerc/accounts.conf. See aerc-config(5). -

Type: strings concatenated with "\n" or attribute set of attribute set of values (null, bool, int, string of float) or a list of values, that will be joined with a comma

Default: +

Type: strings concatenated with "\n" or attribute set of attribute set of (values (null, bool, int, string of float) or a list of values, that will be joined with a comma)

Default: { } @@ -1955,7 +1955,7 @@ See aerc-config(5).

programs.aerc.extraBinds

Extra lines added to $HOME/.config/aerc/binds.conf. Global keybindings can be set in the `global` section. See aerc-config(5). -

Type: strings concatenated with "\n" or attribute set of attribute set of values (null, bool, int, string of float) or a list of values, that will be joined with a comma

Default: +

Type: strings concatenated with "\n" or attribute set of attribute set of (values (null, bool, int, string of float) or a list of values, that will be joined with a comma)

Default: { } @@ -1963,7 +1963,7 @@ See aerc-config(5). <home-manager/modules/programs/aerc.nix>

programs.aerc.extraConfig

Extra lines added to $HOME/.config/aerc/aerc.conf. See aerc-config(5). -

Type: strings concatenated with "\n" or attribute set of attribute set of values (null, bool, int, string of float) or a list of values, that will be joined with a comma

Default: +

Type: strings concatenated with "\n" or attribute set of attribute set of (values (null, bool, int, string of float) or a list of values, that will be joined with a comma)

Default: { } @@ -1971,7 +1971,7 @@ See aerc-config(5). <home-manager/modules/programs/aerc.nix>

programs.aerc.stylesets

Stylesets added to $HOME/.config/aerc/stylesets/. See aerc-stylesets(7). -

Type: attribute set of attribute set of values (null, bool, int, string of float) or a list of values, that will be joined with a comma or strings concatenated with "\n"

Default: +

Type: attribute set of ((attribute set of (values (null, bool, int, string of float) or a list of values, that will be joined with a comma)) or strings concatenated with "\n")

Default: { } @@ -2091,7 +2091,7 @@ enabled for each email account that is managed by Notmuch.

Type: strings concatenated with "\n"

Default: ""

Declared by:

<home-manager/modules/programs/alot.nix>
programs.alot.settings

Configuration options added to alot configuration file. -

Type: attribute set of string or signed integer or boolean or floating point number

Default: +

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

Default: { auto_remove_unread = true; handle_mouse = true; initial_command = "search tag:inbox AND NOT tag:killed"; prefer_plaintext = true; } @@ -2102,7 +2102,7 @@ enabled for each email account that is managed by Notmuch. }

Declared by:

<home-manager/modules/programs/alot.nix> -
programs.alot.tags

How to display the tags.

Type: attribute set of submodule

Default: +

programs.alot.tags

How to display the tags.

Type: attribute set of (submodule)

Default: { } @@ -2133,7 +2133,7 @@ compute the string representation on the fly using See aria2c(1) for options. -

Type: attribute set of boolean or floating point number or signed integer or string

Default: +

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

Default: { } @@ -2265,7 +2265,7 @@ of options. }

Declared by:

<home-manager/modules/programs/autorandr.nix> -
programs.autorandr.profiles

Autorandr profiles specification.

Type: attribute set of submodule

Default: +

programs.autorandr.profiles

Autorandr profiles specification.

Type: attribute set of (submodule)

Default: { } @@ -2293,7 +2293,7 @@ of options. }

Declared by:

<home-manager/modules/programs/autorandr.nix> -
programs.autorandr.profiles.<name>.config

Per output profile configuration.

Type: attribute set of submodule

Default: +

programs.autorandr.profiles.<name>.config

Per output profile configuration.

Type: attribute set of (submodule)

Default: { } @@ -2331,7 +2331,7 @@ will be used.

This option is a shortcut version of the transform option and they are mutually exclusive. -

Type: null or submodule

Default: null

Example:

{
+

Type: null or (submodule)

Default: null

Example:

{
   x = 1.25;
   y = 1.25;
 }
@@ -2346,7 +2346,7 @@ exclusive.
                 
programs.autorandr.profiles.<name>.config.<name>.transform

Refer to xrandr(1) for the documentation of the transform matrix. -

Type: null or 3×3 matrix of floating point numbers

Default: null

Example:

[
+

Type: null or (3×3 matrix of floating point numbers)

Default: null

Example:

[
   [ 0.6 0.0 0.0 ]
   [ 0.0 0.6 0.0 ]
   [ 0.0 0.0 1.0 ]
@@ -2401,7 +2401,7 @@ directory.
 Note that these commands will be run even in non-interactive shells.
 

Type: strings concatenated with "\n"

Default: ""

Declared by:

<home-manager/modules/programs/bash.nix> -
programs.bash.historyControl

Controlling how commands are saved on the history list.

Type: list of one of "erasedups", "ignoredups", "ignorespace"

Default: +

programs.bash.historyControl

Controlling how commands are saved on the history list.

Type: list of (one of "erasedups", "ignoredups", "ignorespace")

Default: [ ] @@ -2481,7 +2481,7 @@ for explanation about possible values.

programs.bat.enable

Whether to enable bat, a cat clone with wings.

Type: boolean

Default: false

Example: true

Declared by:

<home-manager/modules/programs/bat.nix>
programs.bat.config

Bat configuration. -

Type: attribute set of string or list of string

Default: +

Type: attribute set of (string or list of string)

Default: { } @@ -2609,7 +2609,7 @@ The possible attributes are: (default: true)

from_shell (optional)

whether the verb must be executed from the parent shell (default: false)

-

Type: list of attribute set of boolean or string

Default: +

Type: list of attribute set of (boolean or string)

Default: [ { @@ -2644,7 +2644,7 @@ The possible attributes are: <home-manager/modules/programs/broot.nix>

programs.browserpass.enable

Whether to enable the browserpass extension host application.

Type: boolean

Default: false

Example: true

Declared by:

<home-manager/modules/programs/browserpass.nix> -
programs.browserpass.browsers

Which browsers to install browserpass for

Type: list of one of "brave", "chrome", "chromium", "firefox", "vivaldi"

Default: +

programs.browserpass.browsers

Which browsers to install browserpass for

Type: list of (one of "brave", "chrome", "chromium", "firefox", "vivaldi")

Default: [ "brave" "chrome" "chromium" "firefox" "vivaldi" ] @@ -2664,7 +2664,7 @@ The possible attributes are:

programs.btop.settings

Options to add to btop.conf file. See https://github.com/aristocratos/btop#configurability for options. -

Type: attribute set of boolean or floating point number or signed integer or string

Default: +

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

Default: { } @@ -2707,7 +2707,7 @@ To install extensions outside of the Chrome Web Store set version as explained in the Chrome documentation. -

Type: list of submodule or string convertible to it

Default: +

Type: list of ((submodule) or string convertible to it)

Default: [ ] @@ -2726,7 +2726,7 @@ documentation.

Declared by:

<home-manager/modules/programs/chromium.nix>
programs.chromium.extensions.*.crxPath

Path to the extension's crx file. Linux only. -

Type: null or path

Default: null

Declared by:

+

Type: null or (path)

Default: null

Declared by:

<home-manager/modules/programs/chromium.nix>
programs.chromium.extensions.*.id

The extension's ID from the Chome Web Store url or the unpacked crx.

Type: string matching the pattern [a-zA-Z]{32}

Default: ""

Declared by:

@@ -2876,7 +2876,7 @@ action, set its value to null. If you want to bind multiple buttons to an action, set its value to a list. See https://man.finalrewind.org/1/feh/#x425554544f4e53 for default bindings and available commands. -

Type: attribute set of null or string or signed integer or list of string or signed integer

Default: +

Type: attribute set of (null or string or signed integer or list of (string or signed integer))

Default: { } @@ -2895,7 +2895,7 @@ set its value to null. If you want to bind multiple keys to an action, set its value to a list. See https://man.finalrewind.org/1/feh/#x4b455953 for default bindings and available commands. -

Type: attribute set of null or string or list of string

Default: +

Type: attribute set of (null or string or list of string)

Default: { } @@ -2964,7 +2964,7 @@ handles extension side-loading. ]

Declared by:

<home-manager/modules/programs/firefox.nix> -
programs.firefox.profiles

Attribute set of Firefox profiles.

Type: attribute set of submodule

Default: +

programs.firefox.profiles

Attribute set of Firefox profiles.

Type: attribute set of (submodule)

Default: { } @@ -2972,7 +2972,7 @@ handles extension side-loading. <home-manager/modules/programs/firefox.nix>

programs.firefox.profiles.<name>.bookmarks

Preloaded bookmarks. Note, this may silently overwrite any previously existing bookmarks! -

Type: list of bookmark submodule or directory submodule or attribute set of bookmark submodule or directory submodule convertible to it

Default: +

Type: (list of ((bookmark submodule) or (directory submodule))) or (attribute set of ((bookmark submodule) or (directory submodule))) convertible to it

Default: [ ] @@ -3014,7 +3014,7 @@ previously existing bookmarks! <home-manager/modules/programs/firefox.nix>

programs.firefox.profiles.<name>.path

Profile path.

Type: string

Default: "‹name›"

Declared by:

<home-manager/modules/programs/firefox.nix> -
programs.firefox.profiles.<name>.settings

Attribute set of Firefox preferences.

Type: attribute set of boolean or signed integer or string

Default: +

programs.firefox.profiles.<name>.settings

Attribute set of Firefox preferences.

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

Default: { } @@ -3054,7 +3054,7 @@ previously existing bookmarks! <home-manager/modules/programs/fish.nix>

programs.fish.functions

Basic functions to add to fish. For more information see https://fishshell.com/docs/current/cmds/function.html. -

Type: attribute set of strings concatenated with "\n" or submodule

Default: +

Type: attribute set of (strings concatenated with "\n" or (submodule))

Default: { } @@ -3078,7 +3078,7 @@ initialisation. <home-manager/modules/programs/fish.nix>

programs.fish.plugins

The plugins to source in conf.d/99plugins.fish. -

Type: list of submodule

Default: +

Type: list of (submodule)

Default: [ ] @@ -3156,7 +3156,7 @@ initialisation.

programs.foot.settings

Configuration written to $XDG_CONFIG_HOME/foot/foot.ini. See https://codeberg.org/dnkl/foot/src/branch/master/foot.ini for a list of available options. -

Type: attribute set of attribute set of INI atom (null, bool, int, float or string)

Default: +

Type: attribute set of attribute set of (INI atom (null, bool, int, float or string))

Default: { } @@ -3348,7 +3348,7 @@ See htt

Type: boolean

Default: false

Example: true

Declared by:

<home-manager/modules/programs/git.nix>
programs.git.delta.options

Options to configure delta. -

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

Default: +

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

Default: { } @@ -3402,7 +3402,7 @@ for syntax highlithing. <home-manager/modules/programs/git.nix>

programs.git.extraConfig

Additional configuration to add. The use of string values is deprecated and will be removed in the future. -

Type: strings concatenated with "\n" or attribute set of attribute set of string or boolean or signed integer or list of string or boolean or signed integer or attribute set of string or boolean or signed integer or list of string or boolean or signed integer

Default: +

Type: strings concatenated with "\n" or attribute set of attribute set of (string or boolean or signed integer or list of (string or boolean or signed integer) or attribute set of (string or boolean or signed integer or list of (string or boolean or signed integer)))

Default: { } @@ -3427,7 +3427,7 @@ deprecated and will be removed in the future.

programs.git.hooks

Configuration helper for Git hooks. See https://git-scm.com/docs/githooks for reference. -

Type: attribute set of path

Default: +

Type: attribute set of (path)

Default: { } @@ -3446,7 +3446,7 @@ for reference. ]

Declared by:

<home-manager/modules/programs/git.nix> -
programs.git.includes

List of configuration files to include.

Type: list of submodule

Default: +

programs.git.includes

List of configuration files to include.

Type: list of (submodule)

Default: [ ] @@ -3488,7 +3488,7 @@ This follows the configuration structure as described in };

Declared by:

<home-manager/modules/programs/git.nix> -
programs.git.includes.*.path

Path of the configuration file to include.

Type: string or path

Declared by:

+
programs.git.includes.*.path

Path of the configuration file to include.

Type: string or (path)

Declared by:

<home-manager/modules/programs/git.nix>
programs.git.lfs.enable

Whether to enable Git Large File Storage.

Type: boolean

Default: false

Example: true

Declared by:

<home-manager/modules/programs/git.nix> @@ -3497,7 +3497,7 @@ This requires a manual git lfs pull

Type: boolean

Default: false

Declared by:

<home-manager/modules/programs/git.nix> -
programs.git.signing

Options related to signing commits using GnuPG.

Type: null or submodule

Default: null

Declared by:

+
programs.git.signing

Options related to signing commits using GnuPG.

Type: null or (submodule)

Default: null

Declared by:

<home-manager/modules/programs/git.nix>
programs.git.signing.gpgPath

Path to GnuPG binary to use.

Type: string

Default: "\${pkgs.gnupg}/bin/gpg2"

Declared by:

<home-manager/modules/programs/git.nix> @@ -3519,7 +3519,7 @@ to use depending on commit’s author. <home-manager/modules/programs/gitui.nix>
programs.gitui.keyConfig

Key config in Ron file format. This is written to $XDG_CONFIG_HOME/gitui/key_config.ron. -

Type: path or strings concatenated with "\n"

Default: ""

Example:

''
+

Type: (path) or strings concatenated with "\n"

Default: ""

Example:

''
 exit: Some(( code: Char('c'), modifiers: ( bits: 2,),)),
 quit: Some(( code: Char('q'), modifiers: ( bits: 0,),)),
 exit_popup: Some(( code: Esc, modifiers: ( bits: 0,),)),
@@ -3527,7 +3527,7 @@ exit_popup: Some(( code: Esc, modifiers: ( bits: 0,),)),
                     <home-manager/modules/programs/gitui.nix>
                 
programs.gitui.theme

Theme in Ron file format. This is written to $XDG_CONFIG_HOME/gitui/theme.ron. -

Type: path or strings concatenated with "\n"

Default:

''
+

Type: (path) or strings concatenated with "\n"

Default:

''
 (
   selected_tab: Reset,
   command_fg: White,
@@ -3551,7 +3551,7 @@ exit_popup: Some(( code: Esc, modifiers: ( bits: 0,),)),
                     <home-manager/modules/programs/gitui.nix>
                 
programs.gnome-terminal.enable

Whether to enable Gnome Terminal.

Type: boolean

Default: false

Example: true

Declared by:

<home-manager/modules/programs/gnome-terminal.nix> -
programs.gnome-terminal.profile

A set of Gnome Terminal profiles.

Type: attribute set of submodule

Default: +

programs.gnome-terminal.profile

A set of Gnome Terminal profiles.

Type: attribute set of (submodule)

Default: { } @@ -3581,13 +3581,13 @@ presses the Backspace key. <home-manager/modules/programs/gnome-terminal.nix>

programs.gnome-terminal.profile.<name>.boldIsBright

Whether bold text is shown in bright colors.

Type: null or boolean

Default: null

Declared by:

<home-manager/modules/programs/gnome-terminal.nix> -
programs.gnome-terminal.profile.<name>.colors

The terminal colors, null to use system default.

Type: null or submodule

Default: null

Declared by:

+
programs.gnome-terminal.profile.<name>.colors

The terminal colors, null to use system default.

Type: null or (submodule)

Default: null

Declared by:

<home-manager/modules/programs/gnome-terminal.nix>
programs.gnome-terminal.profile.<name>.colors.backgroundColor

The background color.

Type: string

Declared by:

<home-manager/modules/programs/gnome-terminal.nix>
programs.gnome-terminal.profile.<name>.colors.boldColor

The bold color, null to use same as foreground.

Type: null or string

Default: null

Declared by:

<home-manager/modules/programs/gnome-terminal.nix> -
programs.gnome-terminal.profile.<name>.colors.cursor

The color for the terminal cursor.

Type: null or submodule

Default: null

Declared by:

+
programs.gnome-terminal.profile.<name>.colors.cursor

The color for the terminal cursor.

Type: null or (submodule)

Default: null

Declared by:

<home-manager/modules/programs/gnome-terminal.nix>
programs.gnome-terminal.profile.<name>.colors.cursor.background

The background color.

Type: string

Declared by:

<home-manager/modules/programs/gnome-terminal.nix> @@ -3595,7 +3595,7 @@ presses the Backspace key. <home-manager/modules/programs/gnome-terminal.nix>
programs.gnome-terminal.profile.<name>.colors.foregroundColor

The foreground color.

Type: string

Declared by:

<home-manager/modules/programs/gnome-terminal.nix> -
programs.gnome-terminal.profile.<name>.colors.highlight

The colors for the terminal’s highlighted area.

Type: null or submodule

Default: null

Declared by:

+
programs.gnome-terminal.profile.<name>.colors.highlight

The colors for the terminal’s highlighted area.

Type: null or (submodule)

Default: null

Declared by:

<home-manager/modules/programs/gnome-terminal.nix>
programs.gnome-terminal.profile.<name>.colors.highlight.background

The background color.

Type: string

Declared by:

<home-manager/modules/programs/gnome-terminal.nix> @@ -3651,7 +3651,7 @@ presses the Delete key. <home-manager/modules/programs/go.nix>
programs.go.package

The Go package to use.

Type: package

Default: pkgs.go

Declared by:

<home-manager/modules/programs/go.nix> -
programs.go.packages

Packages to add to GOPATH.

Type: attribute set of path

Default: +

programs.go.packages

Packages to add to GOPATH.

Type: attribute set of (path)

Default: { } @@ -3722,7 +3722,7 @@ any unmanaged keys. Be careful to make a backup of your old <home-manager/modules/programs/gpg.nix>

programs.gpg.publicKeys

A list of public keys to be imported into GnuPG. Note, these key files will be copied into the world-readable Nix store. -

Type: list of submodule

Default: +

Type: list of (submodule)

Default: [ ] @@ -3746,7 +3746,7 @@ for more.

programs.gpg.scdaemonSettings

SCdaemon configuration options. Available options are described in the gpg scdaemon manpage: https://www.gnupg.org/documentation/manuals/gnupg/Scdaemon-Options.html. -

Type: attribute set of string or boolean or list of string

Example:

{
+

Type: attribute set of (string or boolean or list of string)

Example:

{
   disable-ccid = true;
 }
 

Declared by:

@@ -3756,7 +3756,7 @@ in the gpg manpage: https://gnupg.org/documentation/manpage.html.

Note that lists are converted to duplicate keys. -

Type: attribute set of string or boolean or list of string

Example:

{
+

Type: attribute set of (string or boolean or list of string)

Example:

{
   no-comments = false;
   s2k-cipher-algo = "AES128";
 }
@@ -3771,7 +3771,7 @@ Note that lists are converted to duplicate keys.
 

See https://docs.helix-editor.com/languages.html for more information. -

Type: list of TOML value

Default: +

Type: list of (TOML value)

Default: [ ] @@ -3811,7 +3811,7 @@ Where the name of each attribute is the theme-name (in the example "base16").

See https://docs.helix-editor.com/themes.html for the full list of options. -

Type: attribute set of TOML value

Default: +

Type: attribute set of (TOML value)

Default: { } @@ -3875,7 +3875,7 @@ for the full list of options.

programs.hexchat.enable

Whether to enable HexChat, a graphical IRC client.

Type: boolean

Default: false

Example: true

Declared by:

<home-manager/modules/programs/hexchat.nix>
programs.hexchat.channels

Configures $XDG_CONFIG_HOME/hexchat/servlist.conf. -

Type: attribute set of submodule

Default: +

Type: attribute set of (submodule)

Default: { } @@ -3941,7 +3941,7 @@ commands = [ "/msg NickServ IDENTIFY my_password" ] <home-manager/modules/programs/hexchat.nix>

programs.hexchat.channels.<name>.nickname2

Secondary nickname.

Type: null or string

Default: null

Declared by:

<home-manager/modules/programs/hexchat.nix> -
programs.hexchat.channels.<name>.options

Channel options.

Type: null or submodule

Default: null

Example: +

programs.hexchat.channels.<name>.options

Channel options.

Type: null or (submodule)

Default: null

Example: { autoconnect = true; useGlobalUserInformation = true; } @@ -4001,7 +4001,7 @@ configuration files, causing:

programs.hexchat.settings

Configuration for $XDG_CONFIG_HOME/hexchat/hexchat.conf, see https://hexchat.readthedocs.io/en/latest/settings.html#list-of-settings for supported values. -

Type: null or attribute set of string

Default: null

Example:

{
+

Type: null or (attribute set of string)

Default: null

Example:

{
   irc_nick1 = "mynick";
   irc_username = "bob";
   irc_realname = "Bart Simpson";
@@ -4115,7 +4115,7 @@ the default configuration.
 See
 i3status(1)
 for options.
-

Type: attribute set of boolean or signed integer or string

Default: +

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

Default: { } @@ -4132,7 +4132,7 @@ for options. See i3status(1) for options. -

Type: attribute set of submodule

Default: +

Type: attribute set of (submodule)

Default: { } @@ -4164,7 +4164,7 @@ for options. See i3status(1) for options. -

Type: attribute set of boolean or signed integer or string

Default: +

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

Default: { } @@ -4190,7 +4190,7 @@ top and a bottom bar. See i3status-rust(1) for options. -

Type: attribute set of submodule

Default: +

Type: attribute set of (submodule)

Default: { default = { @@ -4391,7 +4391,7 @@ in this option) to command strings or directly to build outputs. <home-manager/modules/programs/irssi.nix>

programs.irssi.extraConfig

These lines are appended to the Irssi configuration.

Type: strings concatenated with "\n"

Default: ""

Declared by:

<home-manager/modules/programs/irssi.nix> -
programs.irssi.networks

An attribute set of chat networks.

Type: attribute set of submodule

Default: +

programs.irssi.networks

An attribute set of chat networks.

Type: attribute set of (submodule)

Default: { } @@ -4416,7 +4416,7 @@ in this option) to command strings or directly to build outputs. ]

Declared by:

<home-manager/modules/programs/irssi.nix> -
programs.irssi.networks.<name>.channels

Channels for the given network.

Type: attribute set of submodule

Default: +

programs.irssi.networks.<name>.channels

Channels for the given network.

Type: attribute set of (submodule)

Default: { } @@ -4436,7 +4436,7 @@ in this option) to command strings or directly to build outputs. <home-manager/modules/programs/irssi.nix>

programs.irssi.networks.<name>.server.ssl.certificateFile

Path to a file containing the certificate used for client authentication to the server. -

Type: null or path

Default: null

Declared by:

+

Type: null or (path)

Default: null

Declared by:

<home-manager/modules/programs/irssi.nix>
programs.irssi.networks.<name>.server.ssl.verify

Whether the SSL certificate should be verified.

Type: boolean

Default: true

Declared by:

<home-manager/modules/programs/irssi.nix> @@ -4482,7 +4482,7 @@ variable. <home-manager/modules/programs/just.nix>
programs.kakoune.enable

Whether to enable the kakoune text editor.

Type: boolean

Default: false

Example: true

Declared by:

<home-manager/modules/programs/kakoune.nix> -
programs.kakoune.config

kakoune configuration options.

Type: null or submodule

Default: +

programs.kakoune.config

kakoune configuration options.

Type: null or (submodule)

Default: { } @@ -4493,11 +4493,11 @@ variable. <home-manager/modules/programs/kakoune.nix>

programs.kakoune.config.autoComplete

Modes in which to display possible completions. The kakoune default is [ "insert" "prompt" ]. -

Type: null or list of one of "insert", "prompt"

Default: null

Declared by:

+

Type: null or (list of (one of "insert", "prompt"))

Default: null

Declared by:

<home-manager/modules/programs/kakoune.nix>
programs.kakoune.config.autoInfo

Contexts in which to display automatic information box. The kakoune default is [ "command" "onkey" ]. -

Type: null or list of one of "command", "onkey", "normal"

Default: null

Example: +

Type: null or (list of (one of "command", "onkey", "normal"))

Default: null

Example: [ "command" "normal" ] @@ -4513,7 +4513,7 @@ The kakoune default is "ask". <home-manager/modules/programs/kakoune.nix>

programs.kakoune.config.hooks

Global hooks. For documentation, see https://github.com/mawww/kakoune/blob/master/doc/pages/hooks.asciidoc. -

Type: list of submodule

Default: +

Type: list of (submodule)

Default: [ ] @@ -4545,7 +4545,7 @@ If 0, a tab will be used instead. <home-manager/modules/programs/kakoune.nix>

programs.kakoune.config.keyMappings

User-defined key mappings. For documentation, see https://github.com/mawww/kakoune/blob/master/doc/pages/mapping.asciidoc. -

Type: list of submodule

Default: +

Type: list of (submodule)

Default: [ ] @@ -4566,7 +4566,7 @@ for possible values.

Type: string

Example: "user"

Declared by:

<home-manager/modules/programs/kakoune.nix>
programs.kakoune.config.numberLines

Settings for the number lines highlighter. -

Type: null or submodule

Default: null

Declared by:

+

Type: null or (submodule)

Default: null

Declared by:

<home-manager/modules/programs/kakoune.nix>
programs.kakoune.config.numberLines.enable

Whether to enable the number lines highlighter.

Type: boolean

Default: false

Example: true

Declared by:

<home-manager/modules/programs/kakoune.nix> @@ -4582,7 +4582,7 @@ buffer contents. The kakoune default is

Type: null or string

Default: null

Declared by:

<home-manager/modules/programs/kakoune.nix>
programs.kakoune.config.scrollOff

How many lines and columns to keep visible around the cursor. -

Type: null or submodule

Default: null

Declared by:

+

Type: null or (submodule)

Default: null

Declared by:

<home-manager/modules/programs/kakoune.nix>
programs.kakoune.config.scrollOff.columns

The number of columns to keep visible around the cursor.

Type: unsigned integer, meaning >=0

Default: 0

Declared by:

@@ -4596,7 +4596,7 @@ face.

Type: boolean

Default: false

Declared by:

<home-manager/modules/programs/kakoune.nix>
programs.kakoune.config.showWhitespace

Settings for the show whitespaces highlighter. -

Type: null or submodule

Default: null

Declared by:

+

Type: null or (submodule)

Default: null

Declared by:

<home-manager/modules/programs/kakoune.nix>
programs.kakoune.config.showWhitespace.enable

Whether to enable the show whitespace highlighter.

Type: boolean

Default: false

Example: true

Declared by:

<home-manager/modules/programs/kakoune.nix> @@ -4625,7 +4625,7 @@ The kakoune default is " ".

Type: null or unsigned integer, meaning >=0

Default: null

Declared by:

<home-manager/modules/programs/kakoune.nix>
programs.kakoune.config.ui

Settings for the ncurses interface. -

Type: null or submodule

Default: null

Declared by:

+

Type: null or (submodule)

Default: null

Declared by:

<home-manager/modules/programs/kakoune.nix>
programs.kakoune.config.ui.enableMouse

Whether to enable mouse support.

Type: boolean

Default: false

Declared by:

@@ -4657,7 +4657,7 @@ should be 12.

Type: null or string

Default: null

Declared by:

<home-manager/modules/programs/kakoune.nix>
programs.kakoune.config.wrapLines

Settings for the wrap lines highlighter. -

Type: null or submodule

Default: null

Declared by:

+

Type: null or (submodule)

Default: null

Declared by:

<home-manager/modules/programs/kakoune.nix>
programs.kakoune.config.wrapLines.enable

Whether to enable the wrap lines highlighter.

Type: boolean

Default: false

Example: true

Declared by:

<home-manager/modules/programs/kakoune.nix> @@ -4734,7 +4734,7 @@ supported plugins run:
programs.kitty.package

Kitty package to install.

Type: package

Default: pkgs.kitty

Declared by:

<home-manager/modules/programs/kitty.nix> -
programs.kitty.darwinLaunchOptions

Command-line options to use when launched by Mac OS GUI

Type: null or list of string

Default: null

Example:

[
+                
programs.kitty.darwinLaunchOptions

Command-line options to use when launched by Mac OS GUI

Type: null or (list of string)

Default: null

Example:

[
   "--single-instance"
   "--directory=/tmp/my-dir"
   "--listen-on=unix:/tmp/my-socket"
@@ -4752,7 +4752,7 @@ supported plugins run:
                     <home-manager/modules/programs/kitty.nix>
                 
programs.kitty.extraConfig

Additional configuration to add.

Type: strings concatenated with "\n"

Default: ""

Declared by:

<home-manager/modules/programs/kitty.nix> -
programs.kitty.font

The font to use.

Type: null or submodule

Default: null

Declared by:

+
programs.kitty.font

The font to use.

Type: null or (submodule)

Default: null

Declared by:

<home-manager/modules/programs/kitty.nix>
programs.kitty.font.package

Package providing the font. This package will be installed to your profile. If null then the font @@ -4779,7 +4779,7 @@ is assumed to already be available in your profile. $XDG_CONFIG_HOME/kitty/kitty.conf. See https://sw.kovidgoyal.net/kitty/conf.html for the documentation. -

Type: attribute set of string or boolean or signed integer

Default: +

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

Default: { } @@ -4809,7 +4809,7 @@ settings as lower level key/value pairs. Kodi will still show the settings of plugins configured via this mechanism in the GUI and they appear to be mutable. This however is not the case and the settings will stay as specified via Home Manager. -

Type: null or attribute set of attribute set of string

Default: null

Example:

{ "service.xbmc.versioncheck".versioncheck_enable = "false"; }
+

Type: null or (attribute set of attribute set of string)

Default: null

Example:

{ "service.xbmc.versioncheck".versioncheck_enable = "false"; }
 

Declared by:

<home-manager/modules/programs/kodi.nix>
programs.kodi.datadir

Directory to store configuration and metadata.

Type: path

Default: "${config.home.homeDirectory}/.kodi"

Example: "${config.xdg.dataHome}/kodi"

Declared by:

@@ -4882,7 +4882,7 @@ t forw-line <home-manager/modules/programs/lf.nix>
programs.lf.cmdKeybindings

Keys to bind to command line commands which can only be one of the builtin commands. Keys set to null or an empty string are deleted. -

Type: attribute set of null or string

Default: +

Type: attribute set of (null or string)

Default: { } @@ -4890,7 +4890,7 @@ builtin commands. Keys set to null or an empty string are deleted. <home-manager/modules/programs/lf.nix>

programs.lf.commands

Commands to declare. Commands set to null or an empty string are deleted. -

Type: attribute set of null or string

Default: +

Type: attribute set of (null or string)

Default: { } @@ -4904,7 +4904,7 @@ deleted. $mkdir -p ~/.trash ''

Declared by:

<home-manager/modules/programs/lf.nix> -
programs.lf.keybindings

Keys to bind. Keys set to null or an empty string are deleted.

Type: attribute set of null or string

Default: +

programs.lf.keybindings

Keys to bind. Keys set to null or an empty string are deleted.

Type: attribute set of (null or string)

Default: { } @@ -4920,7 +4920,7 @@ pipe through less. Setting to null will not bind any key. <home-manager/modules/programs/lf.nix>

programs.lf.previewer.source

Script or executable to use to preview files. Sets lf's previewer option. -

Type: null or path

Default: null

Example:

pkgs.writeShellScript "pv.sh" ''
+

Type: null or (path)

Default: null

Example:

pkgs.writeShellScript "pv.sh" ''
   #!/bin/sh
 
   case "$1" in
@@ -4961,7 +4961,7 @@ All string options are quoted with double quotes.
                 
programs.librewolf.settings

Attribute set of LibreWolf settings and overrides. Refer to https://librewolf.net/docs/settings/ for details on supported values. -

Type: attribute set of boolean or signed integer or string

Default: +

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

Default: { } @@ -5158,7 +5158,7 @@ MangoHud is started on any application that supports it. $XDG_CONFIG_HOME/MangoHud/MangoHud.conf. See https://github.com/flightlessmango/MangoHud/blob/master/bin/MangoHud.conf for the default configuration. -

Type: attribute set of boolean or signed integer or floating point number or string or path or list of signed integer or string

Default: +

Type: attribute set of (boolean or signed integer or floating point number or string or (path) or list of (signed integer or string))

Default: { } @@ -5173,7 +5173,7 @@ Configuration written to $XDG_CONFIG_HOME/MangoHud/{application_name}.conf. See https://github.com/flightlessmango/MangoHud/blob/master/bin/MangoHud.conf for the default configuration. -

Type: attribute set of attribute set of boolean or signed integer or floating point number or string or path or list of signed integer or string

Default: +

Type: attribute set of attribute set of (boolean or signed integer or floating point number or string or (path) or list of (signed integer or string))

Default: { } @@ -5259,7 +5259,7 @@ Values in the 2-5 range get good results so far. }

Declared by:

<home-manager/modules/programs/mercurial.nix> -
programs.mercurial.extraConfig

Additional configuration to add.

Type: attribute set of anything or strings concatenated with "\n"

Default: +

programs.mercurial.extraConfig

Additional configuration to add.

Type: (attribute set of anything) or strings concatenated with "\n"

Default: { } @@ -5329,7 +5329,7 @@ for the full list of options. $XDG_CONFIG_HOME/mpv/mpv.conf. See mpv(1) for the full list of options. -

Type: attribute set of string or signed integer or boolean or floating point number or list of string or signed integer or boolean or floating point number

Default: +

Type: attribute set of (string or signed integer or boolean or floating point number or list of (string or signed integer or boolean or floating point number))

Default: { } @@ -5356,7 +5356,7 @@ by options set in

programs.mpv.profiles

Sub-configuration options for specific profiles written to $XDG_CONFIG_HOME/mpv/mpv.conf. See programs.mpv.config for more information. -

Type: attribute set of attribute set of string or signed integer or boolean or floating point number or list of string or signed integer or boolean or floating point number

Default: +

Type: attribute set of attribute set of (string or signed integer or boolean or floating point number or list of (string or signed integer or boolean or floating point number))

Default: { } @@ -5434,7 +5434,7 @@ for more information.

programs.ncmpcpp.package

Package providing the ncmpcpp command.

Type: package

Default: pkgs.ncmpcpp

Example: pkgs.ncmpcpp.override { visualizerSupport = true; }

Declared by:

<home-manager/modules/programs/ncmpcpp.nix> -
programs.ncmpcpp.bindings

List of keybindings.

Type: list of submodule

Default: +

programs.ncmpcpp.bindings

List of keybindings.

Type: list of (submodule)

Default: [ ] @@ -5454,7 +5454,7 @@ for more information. value of services.mpd.musicDirectory is used as the default if services.mpd.enable is true. -

Type: null or path

Default:

if pkgs.stdenv.hostPlatform.isLinux && config.services.mpd.enable then
+

Type: null or (path)

Default:

if pkgs.stdenv.hostPlatform.isLinux && config.services.mpd.enable then
   config.services.mpd.musicDirectory
 else
   null
@@ -5463,7 +5463,7 @@ else
                 
programs.ncmpcpp.settings

Attribute set from name of a setting to its value. For available options see ncmpcpp(1). -

Type: attribute set of boolean or signed integer or string

Default: +

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

Default: { } @@ -5532,7 +5532,7 @@ csh 1 ^#!\s*/.*\b(csh|tcsh)\s* <home-manager/modules/programs/neomutt.nix>

programs.neomutt.package

The neomutt package to use.

Type: package

Default: pkgs.neomutt

Declared by:

<home-manager/modules/programs/neomutt.nix> -
programs.neomutt.binds

List of keybindings.

Type: list of submodule

Default: +

programs.neomutt.binds

List of keybindings.

Type: list of (submodule)

Default: [ ] @@ -5542,7 +5542,7 @@ csh 1 ^#!\s*/.*\b(csh|tcsh)\s* <home-manager/modules/programs/neomutt.nix>

programs.neomutt.binds.*.key

The key to bind.

Type: string

Example: "<left>"

Declared by:

<home-manager/modules/programs/neomutt.nix> -
programs.neomutt.binds.*.map

Select the menu to bind the command to.

Type: one of "alias", "attach", "browser", "compose", "editor", "generic", "index", "mix", "pager", "pgp", "postpone", "query", "smime" or list of one of "alias", "attach", "browser", "compose", "editor", "generic", "index", "mix", "pager", "pgp", "postpone", "query", "smime"

Default: "index"

Declared by:

+
programs.neomutt.binds.*.map

Select the menu to bind the command to.

Type: one of "alias", "attach", "browser", "compose", "editor", "generic", "index", "mix", "pager", "pgp", "postpone", "query", "smime" or list of (one of "alias", "attach", "browser", "compose", "editor", "generic", "index", "mix", "pager", "pgp", "postpone", "query", "smime")

Default: "index"

Declared by:

<home-manager/modules/programs/neomutt.nix>
programs.neomutt.changeFolderWhenSourcingAccount

Whether to enable changing the folder when sourcing an account.

Type: boolean

Default: true

Example: true

Declared by:

<home-manager/modules/programs/neomutt.nix> @@ -5552,7 +5552,7 @@ csh 1 ^#!\s*/.*\b(csh|tcsh)\s* <home-manager/modules/programs/neomutt.nix>
programs.neomutt.extraConfig

Extra configuration appended to the end.

Type: strings concatenated with "\n"

Default: ""

Declared by:

<home-manager/modules/programs/neomutt.nix> -
programs.neomutt.macros

List of macros.

Type: list of submodule

Default: +

programs.neomutt.macros

List of macros.

Type: list of (submodule)

Default: [ ] @@ -5562,7 +5562,7 @@ csh 1 ^#!\s*/.*\b(csh|tcsh)\s* <home-manager/modules/programs/neomutt.nix>

programs.neomutt.macros.*.key

The key to bind.

Type: string

Example: "<left>"

Declared by:

<home-manager/modules/programs/neomutt.nix> -
programs.neomutt.macros.*.map

Select the menu to bind the command to.

Type: one of "alias", "attach", "browser", "compose", "editor", "generic", "index", "mix", "pager", "pgp", "postpone", "query", "smime" or list of one of "alias", "attach", "browser", "compose", "editor", "generic", "index", "mix", "pager", "pgp", "postpone", "query", "smime"

Default: "index"

Declared by:

+
programs.neomutt.macros.*.map

Select the menu to bind the command to.

Type: one of "alias", "attach", "browser", "compose", "editor", "generic", "index", "mix", "pager", "pgp", "postpone", "query", "smime" or list of (one of "alias", "attach", "browser", "compose", "editor", "generic", "index", "mix", "pager", "pgp", "postpone", "query", "smime")

Default: "index"

Declared by:

<home-manager/modules/programs/neomutt.nix>
programs.neomutt.settings

Extra configuration appended to the end.

Type: attribute set of string

Default: { @@ -5639,7 +5639,7 @@ set nobackup <home-manager/modules/programs/neovim.nix>

programs.neovim.extraLuaPackages

A function in lua5_1.withPackages format, which returns a list of Lua packages required for your plugins to work. -

Type: lua5.1 packages in lua5_1.withPackages format or list of package

Default: [ ]

Example: (ps: with ps; [ luautf8 ])

Declared by:

+

Type: (lua5.1 packages in lua5_1.withPackages format) or list of package

Default: [ ]

Example: (ps: with ps; [ luautf8 ])

Declared by:

<home-manager/modules/programs/neovim.nix>
programs.neovim.extraPackages

Extra packages available to nvim.

Type: list of package

Default: [ @@ -5649,7 +5649,7 @@ list of Lua packages required for your plugins to work. <home-manager/modules/programs/neovim.nix>

programs.neovim.extraPython3Packages

A function in python.withPackages format, which returns a list of Python 3 packages required for your plugins to work. -

Type: python3 packages in python.withPackages format or list of package

Default: ps: [ ]

Example: (ps: with ps; [ python-language-server ])

Declared by:

+

Type: (python3 packages in python.withPackages format) or list of package

Default: ps: [ ]

Example: (ps: with ps; [ python-language-server ])

Declared by:

<home-manager/modules/programs/neovim.nix>
programs.neovim.generatedConfigViml

Generated vimscript config.

Type: strings concatenated with "\n" (read only)

Declared by:

@@ -5673,7 +5673,7 @@ configuration to be placed in init.vim.

This option is mutually exclusive with configure. -

Type: list of package or submodule

Default: +

Type: list of (package or (submodule))

Default: [ ] @@ -5732,7 +5732,7 @@ use Python 3 plugins. <home-manager/modules/programs/newsboat.nix>

programs.newsboat.reloadTime

Time in minutes between reloads.

Type: null or signed integer

Default: 60

Declared by:

<home-manager/modules/programs/newsboat.nix> -
programs.newsboat.urls

List of news feeds.

Type: list of submodule

Default: +

programs.newsboat.urls

List of news feeds.

Type: list of (submodule)

Default: [ ] @@ -5783,7 +5783,7 @@ correct functionality of the application. This a temporary inconvenience, however, as nheko has plans to move the authentication stuff into the local database they currently use. Once this happens, this will no longer be an issue. -

Type: attribute set of attribute set of INI atom (null, bool, int, float or string)

Default: +

Type: attribute set of attribute set of (INI atom (null, bool, int, float or string))

Default: { } @@ -5860,7 +5860,7 @@ this happens, this will no longer be an issue.

Declared by:

<home-manager/modules/programs/nnn.nix>
programs.nnn.plugins.src

Path to the plugin folder. -

Type: null or path

Default: null

Example:

(pkgs.fetchFromGitHub {
+

Type: null or (path)

Default: null

Example:

(pkgs.fetchFromGitHub {
   owner = "jarun";
   repo = "nnn";
   rev = "v4.0";
@@ -5965,7 +5965,7 @@ exclusion.
                 
programs.nushell.configFile

The configuration file to be used for nushell.

See https://www.nushell.sh/book/configuration.html#configuration for more information. -

Type: null or submodule

Default: null

Example:

{ text = ''
+

Type: null or (submodule)

Default: null

Example:

{ text = ''
     let $config = {
       filesize_metric: false
       table_mode: rounded
@@ -5976,7 +5976,7 @@ See Declared by:

<home-manager/modules/programs/nushell.nix>
programs.nushell.configFile.source

Path of the nushell config.nu file to use. -

Type: null or path

Default: file containing text

Declared by:

+

Type: null or (path)

Default: file containing text

Declared by:

<home-manager/modules/programs/nushell.nix>
programs.nushell.configFile.text

Text of the nushell config.nu file. If unset then the source option will be preferred. @@ -5985,12 +5985,12 @@ If unset then the source option will be preferred.

programs.nushell.envFile

The environment variables file to be used for nushell.

See https://www.nushell.sh/book/configuration.html#configuration for more information. -

Type: null or submodule

Default: null

Example:

''
+

Type: null or (submodule)

Default: null

Example:

''
 let-env FOO = 'BAR'
 ''

Declared by:

<home-manager/modules/programs/nushell.nix>
programs.nushell.envFile.source

Path of the nushell env.nu file to use. -

Type: null or path

Default: file containing text

Declared by:

+

Type: null or (path)

Default: file containing text

Declared by:

<home-manager/modules/programs/nushell.nix>
programs.nushell.envFile.text

Text of the nushell env.nu file. If unset then the source option will be preferred. @@ -6021,7 +6021,7 @@ If unset then the source option will be preferred. <home-manager/modules/programs/offlineimap.nix>

programs.offlineimap.extraConfig.default

Extra configuration options added to the DEFAULT section. -

Type: attribute set of string or signed integer or boolean

Default: +

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

Default: { } @@ -6033,7 +6033,7 @@ If unset then the source option will be preferred. <home-manager/modules/programs/offlineimap.nix>

programs.offlineimap.extraConfig.general

Extra configuration options added to the general section. -

Type: attribute set of string or signed integer or boolean

Default: +

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

Default: { } @@ -6045,7 +6045,7 @@ If unset then the source option will be preferred. <home-manager/modules/programs/offlineimap.nix>

programs.offlineimap.extraConfig.mbnames

Extra configuration options added to the mbnames section. -

Type: attribute set of string or signed integer or boolean

Default: +

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

Default: { } @@ -6081,7 +6081,7 @@ def get_pass(service, cmd): <home-manager/modules/programs/pandoc.nix>

programs.pandoc.package

The pandoc package to use.

Type: package

Default: pkgs.pandoc

Declared by:

<home-manager/modules/programs/pandoc.nix> -
programs.pandoc.citationStyles

List of .csl files to install.

Type: list of path

Default: +

programs.pandoc.citationStyles

List of .csl files to install.

Type: list of (path)

Default: [ ] @@ -6107,7 +6107,7 @@ file (see Default files in pandoc documentation). <home-manager/modules/programs/pandoc.nix>

programs.pandoc.finalPackage

Resulting package.

Type: package (read only)

Declared by:

<home-manager/modules/programs/pandoc.nix> -
programs.pandoc.templates

Custom templates.

Type: attribute set of path

Default: +

programs.pandoc.templates

Custom templates.

Type: attribute set of (path)

Default: { } @@ -6162,7 +6162,7 @@ documentation for details.

Declared by:

<home-manager/modules/programs/pet.nix>
programs.pet.snippets

The snippets. -

Type: list of submodule

Default: +

Type: list of (submodule)

Default: [ ] @@ -6188,7 +6188,7 @@ documentation for details. <home-manager/modules/programs/pidgin.nix>

programs.pidgin.package

The Pidgin package to use.

Type: package

Default: pkgs.pidgin

Declared by:

<home-manager/modules/programs/pidgin.nix> -
programs.pidgin.plugins

Plugins that should be available to Pidgin.

Type: unspecified

Default: +

programs.pidgin.plugins

Plugins that should be available to Pidgin.

Type: unspecified value

Default: [ ] @@ -6236,7 +6236,7 @@ PS1=$PS1"NixOS> ";

programs.powerline-go.modules

List of module names to load. The list of all available modules as well as the choice of default ones are at https://github.com/justjanne/powerline-go. -

Type: null or list of string

Default: null

Example: +

Type: null or (list of string)

Default: null

Example: [ "host" "ssh" "cwd" "gitlite" "jobs" "exit" ] @@ -6246,7 +6246,7 @@ modules as well as the choice of default ones are at Currently not supported by bash. Specifying a value for this option will force powerline-go to use the eval format to set the prompt. -

Type: null or list of string

Default: null

Example: +

Type: null or (list of string)

Default: null

Example: [ "host" "venv" "git" ] @@ -6258,12 +6258,12 @@ the prompt.

programs.powerline-go.pathAliases

Pairs of full-path and corresponding desired short name. You may use '~' to represent your home directory but you should protect it to avoid shell substitution. -

Type: null or attribute set of string

Default: null

Example:

{ "\\~/projects/home-manager" = "prj:home-manager"; }
+

Type: null or (attribute set of string)

Default: null

Example:

{ "\\~/projects/home-manager" = "prj:home-manager"; }
 

Declared by:

<home-manager/modules/programs/powerline-go.nix>
programs.powerline-go.settings

This can be any key/value pair as described in https://github.com/justjanne/powerline-go. -

Type: attribute set of boolean or signed integer or string or list of string

Default: +

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

Default: { } @@ -6307,7 +6307,7 @@ force_color = False <home-manager/modules/programs/pylint.nix>

programs.pylint.package

The pylint package to use.

Type: package

Default: pkgs.python3Packages.pylint

Declared by:

<home-manager/modules/programs/pylint.nix> -
programs.pylint.settings

The pylint configuration.

Type: attribute set of attribute set of INI atom (null, bool, int, float or string) or a non-empty list of them

Default: {}

Declared by:

+
programs.pylint.settings

The pylint configuration.

Type: attribute set of attribute set of (INI atom (null, bool, int, float or string) or a non-empty list of them)

Default: {}

Declared by:

<home-manager/modules/programs/pylint.nix>
programs.pywal.enable

Whether to enable pywal.

Type: boolean

Default: false

Example: true

Declared by:

<home-manager/modules/programs/pywal.nix> @@ -6483,7 +6483,7 @@ for options. <home-manager/modules/programs/rbw.nix>
programs.rbw.settings

rbw configuration, if not defined the configuration will not be managed by Home Manager. -

Type: null or JSON value

Default: null

Example:

{
+

Type: null or (JSON value)

Default: null

Example:

{
   email = "name@example.com";
   lock_timeout = 300;
   pinentry = "gnome3";
@@ -6526,7 +6526,7 @@ now.
                 
programs.readline.includeSystemConfig

Whether to include the system-wide configuration.

Type: boolean

Default: true

Declared by:

<home-manager/modules/programs/readline.nix>
programs.readline.variables

Readline customization variable assignments. -

Type: attribute set of string or signed integer or boolean

Default: +

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

Default: { } @@ -6546,7 +6546,7 @@ now. <home-manager/modules/programs/rofi.nix>

programs.rofi.cycle

Whether to cycle through the results list.

Type: null or boolean

Default: null

Declared by:

<home-manager/modules/programs/rofi.nix> -
programs.rofi.extraConfig

Additional configuration to add.

Type: attribute set of string or signed integer or boolean or Rasi literal string or list of string or signed integer or boolean or Rasi literal string or string

Default: +

programs.rofi.extraConfig

Additional configuration to add.

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

Default: { } @@ -6595,7 +6595,7 @@ AUTOTYPE_field='autotype'

programs.rofi.theme

Name of theme or path to theme file in rasi format or attribute set with theme configuration. Available named themes can be viewed using the rofi-theme-selector tool. -

Type: null or string or path or attribute set of attribute set of string or signed integer or boolean or Rasi literal string or list of string or signed integer or boolean or Rasi literal string or string

Default: null

Example:

let
+

Type: null or string or (path) or attribute set of ((attribute set of (string or signed integer or boolean or (Rasi literal string) or list of (string or signed integer or boolean or (Rasi literal string)))) or string)

Default: null

Example:

let
   # Use `mkLiteral` for string-like values that should show without
   # quotes, e.g.:
   # {
@@ -6662,7 +6662,7 @@ but our default is to follow XDG.
                 
programs.sbt.baseConfigPath

Where the plugins and credentials should be located.

Type: string

Default: ".sbt/1.0"

Declared by:

<home-manager/modules/programs/sbt.nix>
programs.sbt.credentials

A list of credentials to define in the sbt configuration directory. -

Type: list of submodule

Default: +

Type: list of (submodule)

Default: [ ] @@ -6685,7 +6685,7 @@ the repository.

programs.sbt.credentials.*.user

The user you're using to authenticate.

Type: string

Declared by:

<home-manager/modules/programs/sbt.nix>
programs.sbt.plugins

A list of plugins to place in the sbt configuration directory. -

Type: list of submodule

Default: +

Type: list of (submodule)

Default: [ ] @@ -6853,12 +6853,12 @@ CTRL-T keybinding. <home-manager/modules/programs/sm64ex.nix>

programs.sm64ex.package

The sm64ex package to use.

Type: package

Default: (build of sm64ex-0.pre+date=2021-11-30)

Declared by:

<home-manager/modules/programs/sm64ex.nix> -
programs.sm64ex.baserom

The path to the Super Mario 64 baserom to extract assets from.

Type: null or path

Default: null

Example: /home/foo/baserom.us.z64

Declared by:

+
programs.sm64ex.baserom

The path to the Super Mario 64 baserom to extract assets from.

Type: null or (path)

Default: null

Example: /home/foo/baserom.us.z64

Declared by:

<home-manager/modules/programs/sm64ex.nix>
programs.sm64ex.extraCompileFlags

Extra flags to pass to the compiler. See https://github.com/sm64pc/sm64ex/wiki/Build-options for more information. -

Type: null or list of string

Default: null

Example:

[
+

Type: null or (list of string)

Default: null

Example:

[
   "BETTERCAMERA=1"
   "NODRAWINGDISTANCE=1"
 ];
@@ -6867,7 +6867,7 @@ for more information.
                 
programs.sm64ex.region

Your baserom's region. Note that only "us", "eu", and "jp" are supported.

Type: null or one of "us", "eu", "jp"

Default: us

Example: jp

Declared by:

<home-manager/modules/programs/sm64ex.nix> -
programs.sm64ex.settings

Settings for sm64ex's $XDG_DATA_HOME/sm64pc/sm64config.txt file.

Type: null or attribute set of string or signed integer or boolean or list of string

Default: null

Example:

{
+                
programs.sm64ex.settings

Settings for sm64ex's $XDG_DATA_HOME/sm64pc/sm64config.txt file.

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

Default: null

Example:

{
   fullscreen = false;
   window_x = 0;
   window_y = 0;
@@ -6993,7 +6993,7 @@ for more information.
 

Type: null or one of "any", "inet", "inet6"

Default: null

Declared by:

<home-manager/modules/programs/ssh.nix>
programs.ssh.matchBlocks.<name>.certificateFile

Specifies files from which the user certificate is read. -

Type: list of string or null or string

Default: +

Type: (list of string) or null or string

Default: [ ] @@ -7009,7 +7009,7 @@ block when null. <home-manager/modules/programs/ssh.nix>

programs.ssh.matchBlocks.<name>.dynamicForwards

Specify dynamic port forwardings. See ssh_config(5) for DynamicForward. -

Type: list of submodule

Default: +

Type: list of (submodule)

Default: [ ] @@ -7052,7 +7052,7 @@ offers more identities. <home-manager/modules/programs/ssh.nix>

programs.ssh.matchBlocks.<name>.identityFile

Specifies files from which the user identity is read. Identities will be tried in the given order. -

Type: list of string or null or string

Default: +

Type: (list of string) or null or string

Default: [ ] @@ -7060,7 +7060,7 @@ Identities will be tried in the given order. <home-manager/modules/programs/ssh.nix>

programs.ssh.matchBlocks.<name>.localForwards

Specify local port forwardings. See ssh_config(5) for LocalForward. -

Type: list of submodule

Default: +

Type: list of (submodule)

Default: [ ] @@ -7089,7 +7089,7 @@ Identities will be tried in the given order. <home-manager/modules/programs/ssh.nix>

programs.ssh.matchBlocks.<name>.remoteForwards

Specify remote port forwardings. See ssh_config(5) for RemoteForward. -

Type: list of submodule

Default: +

Type: list of (submodule)

Default: [ ] @@ -7181,7 +7181,7 @@ of options. <home-manager/modules/programs/starship.nix>

programs.swaylock.settings

Default arguments to swaylock. An empty set disables configuration generation. -

Type: attribute set of boolean or floating point number or signed integer or string

Default: +

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

Default: { } @@ -7195,7 +7195,7 @@ disables configuration generation. <home-manager/modules/programs/taskwarrior.nix>

programs.taskwarrior.colorTheme

Either one of the default provided theme as string, or a path to a theme configuration file. -

Type: null or string or path

Default: null

Example: "dark-blue-256"

Declared by:

+

Type: null or string or (path)

Default: null

Example: "dark-blue-256"

Declared by:

<home-manager/modules/programs/taskwarrior.nix>
programs.taskwarrior.config

Key-value configuration written to $XDG_CONFIG_HOME/task/taskrc. @@ -7374,9 +7374,9 @@ Requires a window manager that respects scroll hints. <home-manager/modules/programs/texlive.nix>

programs.texlive.package

Resulting customized TeX Live package.

Type: package (read only)

Declared by:

<home-manager/modules/programs/texlive.nix> -
programs.texlive.packageSet

TeX Live package set to use.

Type: unspecified

Default: pkgs.texlive

Declared by:

+
programs.texlive.packageSet

TeX Live package set to use.

Type: unspecified value

Default: pkgs.texlive

Declared by:

<home-manager/modules/programs/texlive.nix> -
programs.texlive.extraPackages

Extra packages available to TeX Live.

Type: unspecified

Default: "tpkgs: { inherit (tpkgs) collection-basic; }"

Example:

tpkgs: { inherit (tpkgs) collection-fontsrecommended algorithms; }
+                
programs.texlive.extraPackages

Extra packages available to TeX Live.

Type: unspecified value

Default: "tpkgs: { inherit (tpkgs) collection-basic; }"

Example:

tpkgs: { inherit (tpkgs) collection-fontsrecommended algorithms; }
 

Declared by:

<home-manager/modules/programs/texlive.nix>
programs.timidity.enable

Whether to enable timidity, a software MIDI renderer.

Type: boolean

Default: false

Example: true

Declared by:

@@ -7615,7 +7615,7 @@ set nobackup

Note: String values are deprecated, please use actual packages. -

Type: list of string or package

Default: +

Type: list of (string or package)

Default: [ (build of vimplugin-vim-sensible-2022-08-26) ] @@ -7670,7 +7670,7 @@ overlay or set this option. Example overlay configuration: <home-manager/modules/programs/vscode/haskell.nix>

programs.vscode.keybindings

Keybindings written to Visual Studio Code's keybindings.json. -

Type: list of submodule

Default: +

Type: list of (submodule)

Default: [ ] @@ -7745,7 +7745,7 @@ or by Visual Studio Code.

See https://github.com/TailorDev/Watson/blob/master/docs/user-guide/configuration.md for an example configuration. -

Type: attribute set of attribute set of INI atom (null, bool, int, float or string)

Default: +

Type: attribute set of attribute set of (INI atom (null, bool, int, float or string))

Default: { } @@ -7776,7 +7776,7 @@ for an example configuration. <home-manager/modules/programs/waybar.nix>

programs.waybar.settings

Configuration for Waybar, see https://github.com/Alexays/Waybar/wiki/Configuration for supported values. -

Type: list of JSON value or attribute set of JSON value

Default: +

Type: (list of (JSON value)) or attribute set of (JSON value)

Default: [ ] @@ -7815,7 +7815,7 @@ See

If the value is set to a path literal, then the path will be used as the css file. -

Type: null or path or string

Default: null

Example:

''
+

Type: null or (path) or string

Default: null

Example:

''
 * {
   border: none;
   border-radius: 0;
@@ -7848,7 +7848,7 @@ otherwise the service may never be started.
 taken as the name of the corresponding color scheme. See
 https://wezfurlong.org/wezterm/config/appearance.html#defining-a-color-scheme-in-a-separate-file
 for more details of the TOML color scheme format.
-

Type: attribute set of TOML value

Default: +

Type: attribute set of (TOML value)

Default: { } @@ -7942,7 +7942,7 @@ example, update = true; instead of Short options can be specified in the extraConfig option. See https://github.com/yt-dlp/yt-dlp#configuration for explanation about possible values. -

Type: attribute set of boolean or signed integer or string

Default: +

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

Default: { } @@ -8005,7 +8005,7 @@ for the full list of possible mappings. them permanent. See zathurarc(5) for the full list of options. -

Type: attribute set of string or boolean or signed integer

Default: +

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

Default: { } @@ -8062,7 +8062,7 @@ list of options. <home-manager/modules/programs/zoxide.nix>

programs.zsh.enable

Whether to enable Z shell (Zsh).

Type: boolean

Default: false

Example: true

Declared by:

<home-manager/modules/programs/zsh.nix> -
programs.zsh.enableAutosuggestions

Enable zsh autosuggestions

Type: unspecified

Default: false

Declared by:

+
programs.zsh.enableAutosuggestions

Enable zsh autosuggestions

Type: unspecified value

Default: false

Declared by:

<home-manager/modules/programs/zsh.nix>
programs.zsh.enableCompletion

Enable zsh completion. Don't forget to add

@@ -8071,7 +8071,7 @@ list of options.
 to your system configuration to get completion for system packages (e.g. systemd).
 

Type: boolean

Default: true

Declared by:

<home-manager/modules/programs/zsh.nix> -
programs.zsh.enableSyntaxHighlighting

Enable zsh syntax highlighting

Type: unspecified

Default: false

Declared by:

+
programs.zsh.enableSyntaxHighlighting

Enable zsh syntax highlighting

Type: unspecified value

Default: false

Declared by:

<home-manager/modules/programs/zsh.nix>
programs.zsh.enableVteIntegration

Whether to enable integration with terminals using the VTE library. This will let the terminal track the current working @@ -8220,7 +8220,7 @@ zstyle :omz:plugins:ssh-agent identities id_rsa id_rsa2 id_github

programs.zsh.oh-my-zsh.theme

Name of the theme to be used by oh-my-zsh.

Type: string

Default: ""

Example: "robbyrussell"

Declared by:

<home-manager/modules/programs/zsh.nix> -
programs.zsh.plugins

Plugins to source in .zshrc.

Type: list of submodule

Default: +

programs.zsh.plugins

Plugins to source in .zshrc.

Type: list of (submodule)

Default: [ ] @@ -8326,7 +8326,7 @@ Will be added to fpath and PATH

programs.zsh.prezto.macOS.dashKeyword

Set the keyword used by `mand` to open man pages in Dash.app

Type: null or string

Default: null

Example: "manpages"

Declared by:

<home-manager/modules/programs/zsh/prezto.nix> -
programs.zsh.prezto.pmoduleDirs

Add additional directories to load prezto modules from

Type: list of path

Default: +

programs.zsh.prezto.pmoduleDirs

Add additional directories to load prezto modules from

Type: list of (path)

Default: [ ] @@ -8461,7 +8461,7 @@ but are substituted anywhere on a line. <home-manager/modules/programs/zsh.nix>

programs.zsh.zplug.enable

Whether to enable zplug - a zsh plugin manager.

Type: boolean

Default: false

Example: true

Declared by:

<home-manager/modules/programs/zplug.nix> -
programs.zsh.zplug.plugins

List of zplug plugins.

Type: list of submodule

Default: +

programs.zsh.zplug.plugins

List of zplug plugins.

Type: list of (submodule)

Default: [ ] @@ -8598,7 +8598,7 @@ written to $XDG_CONFIG_HOME/dunst/dunstrc regardless. This allows using a mutable configuration file generated from the immutable one, useful in scenarios where live reloading is desired. -

Type: string or path

Default: "$XDG_CONFIG_HOME/dunst/dunstrc"

Declared by:

+

Type: string or (path)

Default: "$XDG_CONFIG_HOME/dunst/dunstrc"

Declared by:

<home-manager/modules/services/dunst.nix>
services.dunst.iconTheme

Set the icon theme.

Type: submodule

Default: { @@ -8612,7 +8612,7 @@ desired. <home-manager/modules/services/dunst.nix>

services.dunst.iconTheme.size

The desired icon size.

Type: string

Default: "32x32"

Example: "16x16"

Declared by:

<home-manager/modules/services/dunst.nix> -
services.dunst.settings

Configuration written to $XDG_CONFIG_HOME/dunst/dunstrc.

Type: attribute set of attribute set of string or boolean or signed integer or list of string

Default: +

services.dunst.settings

Configuration written to $XDG_CONFIG_HOME/dunst/dunstrc.

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

Default: { } @@ -8660,7 +8660,7 @@ desired. }

Declared by:

<home-manager/modules/services/dwm-status.nix> -
services.dwm-status.order

List of enabled features in order.

Type: list of one of "audio", "backlight", "battery", "cpu_load", "network", "time"

Declared by:

+
services.dwm-status.order

List of enabled features in order.

Type: list of (one of "audio", "backlight", "battery", "cpu_load", "network", "time")

Declared by:

<home-manager/modules/services/dwm-status.nix>
services.easyeffects.enable

Whether to enable Easyeffects daemon. Note, it is necessary to add @@ -8758,7 +8758,7 @@ for a description of available options.

services.etesync-dav.serverUrl

The URL to the etesync server.

Type: string

Default: "https://api.etesync.com/"

Declared by:

<home-manager/modules/services/etesync-dav.nix>
services.etesync-dav.settings

Settings for etesync-dav, passed as environment variables. -

Type: attribute set of string or signed integer

Default: +

Type: attribute set of (string or signed integer)

Default: { } @@ -8775,7 +8775,7 @@ for a description of available options.

services.flameshot.settings

Configuration to use for Flameshot. See https://github.com/flameshot-org/flameshot/blob/master/flameshot.example.ini for available options. -

Type: attribute set of attribute set of INI atom (null, bool, int, float or string)

Default: +

Type: attribute set of attribute set of (INI atom (null, bool, int, float or string))

Default: { } @@ -8823,7 +8823,7 @@ The configuration specified under written to $XDG_CONFIG_HOME/fnott/fnott.ini regardless of this option. This allows using a mutable configuration file generated from the immutable one, useful in scenarios where live reloading is desired. -

Type: string or path

Default: "$XDG_CONFIG_HOME/fnott/fnott.ini"

Declared by:

+

Type: string or (path)

Default: "$XDG_CONFIG_HOME/fnott/fnott.ini"

Declared by:

<home-manager/modules/services/fnott.nix>
services.fnott.extraFlags

Extra arguments to use for executing fnott.

Type: list of string

Default: @@ -8842,7 +8842,7 @@ generated from the immutable one, useful in scenarios where live reloading is de See fnott.ini(5) for a list of avaliable options and https://codeberg.org/dnkl/fnott/src/branch/master/fnott.ini for an example configuration. -

Type: attribute set of attribute set of INI atom (null, bool, int, float or string)

Default: +

Type: attribute set of attribute set of (INI atom (null, bool, int, float or string))

Default: { } @@ -8918,7 +8918,7 @@ geoclue2 service.

services.gammastep.settings

The configuration to pass to Gammastep. Available options for Gammastep described in gammastep(1). -

Type: attribute set of attribute set of INI atom (null, bool, int, float or string)

Default: +

Type: attribute set of attribute set of (INI atom (null, bool, int, float or string))

Default: { } @@ -8959,7 +8959,7 @@ permanently for a password.

Type: package

Default: pkgs.git-sync

Declared by:

<home-manager/modules/services/git-sync.nix>
services.git-sync.repositories

The repositories that should be synchronized. -

Type: attribute set of submodule

Declared by:

+

Type: attribute set of (submodule)

Declared by:

<home-manager/modules/services/git-sync.nix>
services.git-sync.repositories.<name>.interval

The interval, specified in seconds, at which the synchronization will be triggered even without filesystem changes. @@ -8977,7 +8977,7 @@ for the supported URIs. <home-manager/modules/services/gnome-keyring.nix>

services.gnome-keyring.components

The GNOME keyring components to start. If empty then the default set of components will be started. -

Type: list of one of "pkcs11", "secrets", "ssh"

Default: +

Type: list of (one of "pkcs11", "secrets", "ssh")

Default: [ ] @@ -9052,7 +9052,7 @@ now.

Type: null or one of "curses", "tty", "gtk2", "emacs", "gnome3", "qt"

Default: "gtk2"

Example: "gnome3"

Declared by:

<home-manager/modules/services/gpg-agent.nix>
services.gpg-agent.sshKeys

Which GPG keys (by keygrip) to expose as SSH keys. -

Type: null or list of string

Default: null

Declared by:

+

Type: null or (list of string)

Default: null

Declared by:

<home-manager/modules/services/gpg-agent.nix>
services.gpg-agent.verbose

Whether to produce verbose output.

Type: boolean

Default: false

Declared by:

@@ -9080,7 +9080,7 @@ the first matching rule is applied and processing stops. See for more information. The Nix value declared here will be translated to JSON and written to the rules key in $XDG_CONFIG_HOME/grobi.conf. -

Type: list of attribute set of string or boolean or signed integer or list of string

Default: +

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

Default: [ ] @@ -9123,7 +9123,7 @@ manually using the command line.

services.gromit-mpx.opacity

Opacity of the drawing overlay.

Type: float between 0.0 and 1.0 (inclusive)

Default:

Example:

Declared by:

<home-manager/modules/services/gromit-mpx.nix>
services.gromit-mpx.tools

Tool definitions for gromit-mpx to use. -

Type: list of submodule

Default: +

Type: list of (submodule)

Default: [ { @@ -9176,7 +9176,7 @@ the name default works with any input.

Type: string

Example: "default"

Declared by:

<home-manager/modules/services/gromit-mpx.nix>
services.gromit-mpx.tools.*.modifiers

Only activate this tool if the given modifiers are also active. -

Type: list of one of "1", "2", "3", "4", "5", "SHIFT", "CONTROL", "ALT", "META"

Default: +

Type: list of (one of "1", "2", "3", "4", "5", "SHIFT", "CONTROL", "ALT", "META")

Default: [ ] @@ -9214,7 +9214,7 @@ The format is described in <home-manager/modules/services/hound.nix>

services.hound.maxConcurrentIndexers

Limit the amount of concurrent indexers.

Type: positive integer, meaning >0

Default: 2

Declared by:

<home-manager/modules/services/hound.nix> -
services.hound.repositories

The repository configuration.

Type: attribute set of JSON value

Default: +

services.hound.repositories

The repository configuration.

Type: attribute set of (JSON value)

Default: { } @@ -9239,7 +9239,7 @@ configuration file.

Type: strings concatenated with "\n"

Default: ""

Declared by:

<home-manager/modules/services/kanshi.nix>
services.kanshi.profiles

List of profiles. -

Type: attribute set of submodule

Default: +

Type: attribute set of (submodule)

Default: { } @@ -9266,14 +9266,14 @@ docked = {

services.kanshi.profiles.<name>.exec

Commands executed after the profile is succesfully applied. Note that if you provide multiple commands, they will be executed asynchronously with no guaranteed ordering. -

Type: list of string or string convertible to it

Default: +

Type: (list of string) or string convertible to it

Default: [ ]

Example: "[ \${pkg.sway}/bin/swaymsg workspace 1, move workspace to eDP-1 ]"

Declared by:

<home-manager/modules/services/kanshi.nix>
services.kanshi.profiles.<name>.outputs

Outputs configuration. -

Type: list of submodule

Default: +

Type: list of (submodule)

Default: [ ] @@ -9352,7 +9352,7 @@ space. <home-manager/modules/services/mbsync.nix>

services.mbsync.configFile

Optional configuration file to link to use instead of the default file (~/.mbsyncrc). -

Type: null or path

Default: null

Declared by:

+

Type: null or (path)

Default: null

Declared by:

<home-manager/modules/services/mbsync.nix>
services.mbsync.frequency

How often to run mbsync. This value is passed to the systemd timer configuration as the onCalendar option. See @@ -9383,7 +9383,7 @@ useful for creating the directories mbsync is going to use.

services.mopidy.extraConfigFiles

Extra configuration files read by Mopidy when the service starts. Later files in the list override earlier configuration files and structured settings. -

Type: list of path

Default: +

Type: list of (path)

Default: [ ] @@ -9394,7 +9394,7 @@ structured settings.

See https://docs.mopidy.com/en/latest/config/ for more details. -

Type: attribute set of attribute set of Mopidy config value

Default: +

Type: attribute set of attribute set of (Mopidy config value)

Default: { } @@ -9450,7 +9450,7 @@ beginning of the file. For available options see If xdg.userDirs.enable is true then the defined XDG music directory is used. Otherwise, you must explicitly specify a value. -

Type: path or string

Default:

${home.homeDirectory}/music    if state version < 22.11
+

Type: (path) or string

Default:

${home.homeDirectory}/music    if state version < 22.11
 ${xdg.userDirs.music}          if xdg.userDirs.enable == true
 undefined                      otherwise
 

Declared by:

@@ -9494,7 +9494,7 @@ For available options see services.mpdris2.mpd.host

The address where MPD is listening for connections.

Type: string

Default: "config.services.mpd.network.listenAddress"

Example: "192.168.1.1"

Declared by:

<home-manager/modules/services/mpdris2.nix>
services.mpdris2.mpd.musicDirectory

If set, mpDris2 will use this directory to access music artwork. -

Type: null or path

Default: "config.services.mpd.musicDirectory"

Declared by:

+

Type: null or (path)

Default: "config.services.mpd.musicDirectory"

Declared by:

<home-manager/modules/services/mpdris2.nix>
services.mpdris2.mpd.password

The password to connect to MPD.

Type: null or string

Default: null

Declared by:

@@ -9509,7 +9509,7 @@ For available options see services.mpris-proxy.enable

Whether to enable a proxy forwarding Bluetooth MIDI controls via MPRIS2 to control media players.

Type: boolean

Default: false

Example: true

Declared by:

<home-manager/modules/services/mpris-proxy.nix>
services.muchsync.remotes

Muchsync remotes to synchronise with. -

Type: attribute set of submodule

Default: +

Type: attribute set of (submodule)

Default: { } @@ -9612,7 +9612,7 @@ special characters including spaces may need to be escaped. See https://github.com/matrix-org/pantalaimon/blob/master/docs/manpantalaimon.5.md or pantalaimon(5) for options. -

Type: attribute set of attribute set of INI atom (null, bool, int, float or string)

Default: { }

Example:

{
+

Type: attribute set of attribute set of (INI atom (null, bool, int, float or string))

Default: { }

Example:

{
   Default = {
     LogLevel = "Debug";
     SSL = true;
@@ -9821,7 +9821,7 @@ for the configuration documentation.
                 
services.polybar.config

Polybar configuration. Can be either path to a file, or set of attributes that will be used to create the final configuration. See also services.polybar.settings for a more nix-friendly format. -

Type: attribute set of attribute set of string or boolean or signed integer or list of string or path convertible to it

Default: +

Type: (attribute set of attribute set of (string or boolean or signed integer or list of string)) or (path) convertible to it

Default: { } @@ -9980,7 +9980,7 @@ as RECOLL_CONFDIR. See recoll(5) for more details about the configuration. -

Type: attribute set of Recoll config value

Default: +

Type: attribute set of (Recoll config value)

Default: { } @@ -10036,7 +10036,7 @@ geoclue2 service.

services.redshift.settings

The configuration to pass to Redshift. Available options for Redshift described in redshift(1). -

Type: attribute set of attribute set of INI atom (null, bool, int, float or string)

Default: +

Type: attribute set of attribute set of (INI atom (null, bool, int, float or string))

Default: { } @@ -10139,7 +10139,7 @@ Can be used to specify extensions.

services.stalonetray.package

The package to use for the Stalonetray binary.

Type: package

Default: pkgs.stalonetray

Example: pkgs.stalonetray

Declared by:

<home-manager/modules/services/stalonetray.nix>
services.stalonetray.config

Stalonetray configuration as a set of attributes. -

Type: attribute set of null or string or boolean or signed integer

Default: +

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

Default: { } @@ -10165,7 +10165,7 @@ background "#cccccc" <home-manager/modules/services/swayidle.nix>

services.swayidle.package

Swayidle package to install.

Type: package

Default: pkgs.swayidle

Declared by:

<home-manager/modules/services/swayidle.nix> -
services.swayidle.events

Run command on occurence of a event.

Type: list of submodule

Default: +

services.swayidle.events

Run command on occurence of a event.

Type: list of (submodule)

Default: [ ] @@ -10188,7 +10188,7 @@ background "#cccccc"

services.swayidle.systemdTarget

Systemd target to bind to.

Type: string

Default: "sway-session.target"

Declared by:

<home-manager/modules/services/swayidle.nix> -
services.swayidle.timeouts

List of commands to run after idle timeout.

Type: list of submodule

Default: +

services.swayidle.timeouts

List of commands to run after idle timeout.

Type: list of (submodule)

Default: [ ] @@ -10217,7 +10217,7 @@ background "#cccccc" ]

Example: [ "-m 1" ]

Declared by:

<home-manager/modules/services/sxhkd.nix> -
services.sxhkd.keybindings

An attribute set that assigns hotkeys to commands.

Type: attribute set of null or string

Default: +

services.sxhkd.keybindings

An attribute set that assigns hotkeys to commands.

Type: attribute set of (null or string)

Default: { } @@ -10240,7 +10240,7 @@ background "#cccccc" ]

Declared by:

<home-manager/modules/services/syncthing.nix> -
services.syncthing.tray

Syncthing tray service configuration.

Type: boolean or submodule

Default: +

services.syncthing.tray

Syncthing tray service configuration.

Type: boolean or (submodule)

Default: { enable = false; } @@ -10271,7 +10271,7 @@ for more information about the format. found at https://github.com/sargon/trayer-srg.

Property NameTypeValuesDefault
SetDockTypebooleantrue|falsetrue
SetPartialStrutbooleantrue|falsetrue
alignstringleft|right|centercenter
alphasigned integernumber127
distancesigned integernumber0
distancefromstringleft|right|top|bottomtop
edgestringleft|right|top|bottom|nonebottom
expandbooleantrue|falsetrue
heightsigned integernumber26
heighttypestringrequest|pixelpixel
iconspacingsigned integernumber0
marginsigned integernumber0
monitorstringnumber|primary0
paddingsigned integernumber0
tintstringint0xFFFFFFFF
transparentbooleantrue|falsefalse
widthsigned integernumber100
widthtypestringrequest|pixel|percentpercent

-

Type: attribute set of null or string or boolean or signed integer

Default: +

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

Default: { } @@ -10299,11 +10299,11 @@ for details. <home-manager/modules/services/twmn.nix>

services.twmn.host

Host address to listen on for notifications.

Type: string

Default: "127.0.0.1"

Example: "laptop.lan"

Declared by:

<home-manager/modules/services/twmn.nix> -
services.twmn.icons.critical

Path to the critical notifications' icon.

Type: null or path

Default: null

Declared by:

+
services.twmn.icons.critical

Path to the critical notifications' icon.

Type: null or (path)

Default: null

Declared by:

<home-manager/modules/services/twmn.nix> -
services.twmn.icons.info

Path to the informative notifications' icon.

Type: null or path

Default: null

Declared by:

+
services.twmn.icons.info

Path to the informative notifications' icon.

Type: null or (path)

Default: null

Declared by:

<home-manager/modules/services/twmn.nix> -
services.twmn.icons.warning

Path to the warning notifications' icon.

Type: null or path

Default: null

Declared by:

+
services.twmn.icons.warning

Path to the warning notifications' icon.

Type: null or (path)

Default: null

Declared by:

<home-manager/modules/services/twmn.nix>
services.twmn.port

UDP port to listen on for notifications.

Type: 16 bit unsigned integer; between 0 and 65535 (both inclusive)

Default: 9797

Declared by:

<home-manager/modules/services/twmn.nix> @@ -10448,7 +10448,7 @@ The options are
services.unison.enable

Whether to enable Unison synchronisation.

Type: boolean

Default: false

Example: true

Declared by:

<home-manager/modules/services/unison.nix>
services.unison.pairs

Unison root pairs to keep synchronised. -

Type: attribute set of submodule

Default: +

Type: attribute set of (submodule)

Default: { } @@ -10580,7 +10580,7 @@ The commands specified in command and environment section. -

Type: list of submodule

Default: +

Type: list of (submodule)

Default: [ ] @@ -10617,7 +10617,7 @@ The command is automatically escaped.

services.xscreensaver.enable

Whether to enable XScreenSaver.

Type: boolean

Default: false

Example: true

Declared by:

<home-manager/modules/services/xscreensaver.nix>
services.xscreensaver.settings

The settings to use for XScreenSaver. -

Type: attribute set of boolean or signed integer or string

Default: +

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

Default: { } @@ -10635,7 +10635,7 @@ The command is automatically escaped.

services.xsettingsd.settings

Xsettingsd options for configuration file. See https://github.com/derat/xsettingsd/wiki/Settings for documentation on these values. -

Type: attribute set of boolean or signed integer or string

Default: +

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

Default: { } @@ -10693,7 +10693,7 @@ If false just the exec scripts are run. <home-manager/modules/services/xsuspender.nix>

services.xsuspender.defaults.suspendSubtreePattern

Also suspend descendant processes that match this regex.

Type: null or string

Default: null

Declared by:

<home-manager/modules/services/xsuspender.nix> -
services.xsuspender.rules

Attribute set of XSuspender rules.

Type: attribute set of submodule

Default: +

services.xsuspender.rules

Attribute set of XSuspender rules.

Type: attribute set of (submodule)

Default: { } @@ -10777,7 +10777,7 @@ then run WARNING! Since this option is experimental, the activation process may change in backwards incompatible ways. -

Type: attribute set of submodule

Default: +

Type: attribute set of (submodule)

Default: { } @@ -10893,7 +10893,7 @@ considered successful. The value 0 indicates no timeout.

systemd.user.sessionVariables

Environment variables that will be set for the user session. The variable values must be as described in environment.d(5). -

Type: attribute set of signed integer or string

Default: +

Type: attribute set of (signed integer or string)

Default: { } @@ -11090,7 +11090,7 @@ ignored. }

Declared by:

<home-manager/modules/targets/darwin/user-defaults> -
targets.darwin.defaults.NSGlobalDomain.AppleLanguages

Sets the language to use in the preferred order.

Type: null or list of string

Default: null

Example: +

targets.darwin.defaults.NSGlobalDomain.AppleLanguages

Sets the language to use in the preferred order.

Type: null or (list of string)

Default: null

Example: [ "en" ] @@ -11215,7 +11215,7 @@ path. This should be done if you want to use the NixOS Sway module to install Sway.

Type: null or package

Default: ${pkgs.sway}

Declared by:

<home-manager/modules/services/window-managers/i3-sway/sway.nix> -
wayland.windowManager.sway.config

Sway configuration options.

Type: null or submodule

Default: +

wayland.windowManager.sway.config

Sway configuration options.

Type: null or (submodule)

Default: { } @@ -11223,7 +11223,7 @@ module to install Sway. <home-manager/modules/services/window-managers/i3-sway/sway.nix>

wayland.windowManager.sway.config.assigns

An attribute set that assigns applications to workspaces based on criteria. -

Type: attribute set of list of attribute set of string or boolean

Default: +

Type: attribute set of list of attribute set of (string or boolean)

Default: { } @@ -11234,7 +11234,7 @@ on criteria.

Declared by:

<home-manager/modules/services/window-managers/i3-sway/sway.nix>
wayland.windowManager.sway.config.bars

Sway bars settings blocks. Set to empty list to remove bars completely. -

Type: list of submodule

Default: see code

Declared by:

+

Type: list of (submodule)

Default: see code

Declared by:

<home-manager/modules/services/window-managers/i3-sway/sway.nix>
wayland.windowManager.sway.config.bars.*.colors

Bar color settings. All color classes can be specified using submodules with 'border', 'background', 'text', fields and RGB color hex-codes as values. @@ -11249,7 +11249,7 @@ See Declared by:

<home-manager/modules/services/window-managers/i3-sway/sway.nix>
wayland.windowManager.sway.config.bars.*.colors.activeWorkspace

Border, background and text color for a workspace button when the workspace is active. -

Type: null or submodule

Default:

null for state version ≥ 20.09, as example otherwise
+

Type: null or (submodule)

Default:

null for state version ≥ 20.09, as example otherwise
 

Example: { background = "#5f676a"; border = "#333333"; text = "#ffffff"; @@ -11259,7 +11259,7 @@ See wayland.windowManager.sway.config.bars.*.colors.background

Background color of the bar.

Type: null or string

Default:

null for state version ≥ 20.09, as example otherwise
 

Example: "#000000"

Declared by:

<home-manager/modules/services/window-managers/i3-sway/sway.nix> -
wayland.windowManager.sway.config.bars.*.colors.bindingMode

Border, background and text color for the binding mode indicator

Type: null or submodule

Default:

null for state version ≥ 20.09, as example otherwise
+                
wayland.windowManager.sway.config.bars.*.colors.bindingMode

Border, background and text color for the binding mode indicator

Type: null or (submodule)

Default:

null for state version ≥ 20.09, as example otherwise
 

Example: { background = "#900000"; border = "#2f343a"; text = "#ffffff"; @@ -11273,7 +11273,7 @@ See wayland.windowManager.sway.config.bars.*.colors.focusedStatusline

Text color to be used for the statusline on the currently focused monitor output.

Type: null or string

Default: null

Example: "#ffffff"

Declared by:

<home-manager/modules/services/window-managers/i3-sway/sway.nix>
wayland.windowManager.sway.config.bars.*.colors.focusedWorkspace

Border, background and text color for a workspace button when the workspace has focus. -

Type: null or submodule

Default:

null for state version ≥ 20.09, as example otherwise
+

Type: null or (submodule)

Default:

null for state version ≥ 20.09, as example otherwise
 

Example: { background = "#285577"; border = "#4c7899"; text = "#ffffff"; @@ -11282,7 +11282,7 @@ See wayland.windowManager.sway.config.bars.*.colors.inactiveWorkspace

Border, background and text color for a workspace button when the workspace does not have focus and is not active. -

Type: null or submodule

Default:

null for state version ≥ 20.09, as example otherwise
+

Type: null or (submodule)

Default:

null for state version ≥ 20.09, as example otherwise
 

Example: { background = "#222222"; border = "#333333"; text = "#888888"; @@ -11297,7 +11297,7 @@ have focus and is not active. <home-manager/modules/services/window-managers/i3-sway/sway.nix>

wayland.windowManager.sway.config.bars.*.colors.urgentWorkspace

Border, background and text color for a workspace button when the workspace contains a window with the urgency hint set. -

Type: null or submodule

Default:

null for state version ≥ 20.09, as example otherwise
+

Type: null or (submodule)

Default:

null for state version ≥ 20.09, as example otherwise
 

Example: { background = "#900000"; border = "#2f343a"; text = "#ffffff"; @@ -11308,7 +11308,7 @@ a window with the urgency hint set. <home-manager/modules/services/window-managers/i3-sway/sway.nix>

wayland.windowManager.sway.config.bars.*.extraConfig

Extra configuration lines for this bar.

Type: strings concatenated with "\n"

Default: ""

Declared by:

<home-manager/modules/services/window-managers/i3-sway/sway.nix> -
wayland.windowManager.sway.config.bars.*.fonts

Font configuration for this bar.

Type: list of string or submodule

Default: +

wayland.windowManager.sway.config.bars.*.fonts

Font configuration for this bar.

Type: (list of string) or (submodule)

Default: { } @@ -11412,7 +11412,7 @@ This must to correspond to the value of the keybinding of the default workspace. <home-manager/modules/services/window-managers/i3-sway/sway.nix>

wayland.windowManager.sway.config.floating.border

Floating windows border width.

Type: signed integer

Default: 2

Declared by:

<home-manager/modules/services/window-managers/i3-sway/sway.nix> -
wayland.windowManager.sway.config.floating.criteria

List of criteria for windows that should be opened in a floating mode.

Type: list of attribute set of string or boolean

Default: +

wayland.windowManager.sway.config.floating.criteria

List of criteria for windows that should be opened in a floating mode.

Type: list of attribute set of (string or boolean)

Default: [ ] @@ -11456,7 +11456,7 @@ to a window on a different output. See https://i3wm.org/docs/userguide.html#focus_on_window_activation

Type: one of "smart", "urgent", "focus", "none"

Default: "smart"

Example: "none"

Declared by:

<home-manager/modules/services/window-managers/i3-sway/sway.nix> -
wayland.windowManager.sway.config.fonts

Font configuration for window titles, nagbar...

Type: list of string or submodule

Default: +

wayland.windowManager.sway.config.fonts

Font configuration for window titles, nagbar...

Type: (list of string) or (submodule)

Default: { } @@ -11468,7 +11468,7 @@ See Declared by:

<home-manager/modules/services/window-managers/i3-sway/sway.nix>
wayland.windowManager.sway.config.gaps

Gaps related settings. -

Type: null or submodule

Default: null

Declared by:

+

Type: null or (submodule)

Default: null

Declared by:

<home-manager/modules/services/window-managers/i3-sway/sway.nix>
wayland.windowManager.sway.config.gaps.bottom

Bottom gaps value.

Type: null or signed integer

Default: null

Example: 5

Declared by:

<home-manager/modules/services/window-managers/i3-sway/sway.nix> @@ -11516,7 +11516,7 @@ See

Consider to use lib.mkOptionDefault function to extend or override default keybindings instead of specifying all of them from scratch. -

Type: attribute set of null or string

Default: "Default sway keybindings."

Example:

let
+

Type: attribute set of (null or string)

Default: "Default sway keybindings."

Example:

let
   modifier = config.wayland.windowManager.sway.config.modifier;
 in lib.mkOptionDefault {
   "${modifier}+Return" = "exec ${pkgs.rxvt-unicode-unwrapped}/bin/urxvt";
@@ -11527,7 +11527,7 @@ in lib.mkOptionDefault {
                     <home-manager/modules/services/window-managers/i3-sway/sway.nix>
                 
wayland.windowManager.sway.config.keycodebindings

An attribute set that assigns keypress to an action using key code. See https://i3wm.org/docs/userguide.html#keybindings. -

Type: attribute set of null or string

Default: +

Type: attribute set of (null or string)

Default: { } @@ -11597,7 +11597,7 @@ for options.

wayland.windowManager.sway.config.startup

Commands that should be executed at startup. See https://i3wm.org/docs/userguide.html#_automatically_starting_applications_on_i3_startup. -

Type: list of submodule

Default: +

Type: list of (submodule)

Default: [ ] @@ -11626,7 +11626,7 @@ See wayland.windowManager.sway.config.window.commands

List of commands that should be executed on specific windows. See for_window swaywm option documentation. -

Type: list of submodule

Default: +

Type: list of (submodule)

Default: [ ] @@ -11650,7 +11650,7 @@ See for_window swaywm option documentation.

A value of true is equivalent to using an empty criteria (which is different from an empty string criteria). -

Type: attribute set of string or boolean

Example:

{
+

Type: attribute set of (string or boolean)

Example:

{
   title = "x200: ~/work";
   floating = true;
 };
@@ -11670,7 +11670,7 @@ back to "1: www".
 start.
 

Type: one of "default", "stacking", "tabbed"

Default: "default"

Example: "tabbed"

Declared by:

<home-manager/modules/services/window-managers/i3-sway/sway.nix> -
wayland.windowManager.sway.config.workspaceOutputAssign

Assign workspaces to outputs.

Type: list of submodule

Default: +

wayland.windowManager.sway.config.workspaceOutputAssign

Assign workspaces to outputs.

Type: list of (submodule)

Default: [ ] @@ -11721,7 +11721,7 @@ See for a list of avaliable options and an example configuration. Note, configurations declared under <config> will override the default type values of swaynag. -

Type: attribute set of attribute set of Swaynag config atom (null, bool, int, float, str)

Default: +

Type: attribute set of attribute set of (Swaynag config atom (null, bool, int, float, str))

Default: { } @@ -11778,7 +11778,7 @@ variables for GTK applications. <home-manager/modules/misc/xdg.nix>

xdg.configFile

Attribute set of files to link into the user's XDG configuration home. -

Type: attribute set of submodule

Default: +

Type: attribute set of (submodule)

Default: { } @@ -11829,7 +11829,7 @@ must be set. <home-manager/modules/misc/xdg.nix>

xdg.dataFile

Attribute set of files to link into the user's XDG data home. -

Type: attribute set of submodule

Default: +

Type: attribute set of (submodule)

Default: { } @@ -11881,7 +11881,7 @@ must be set.

xdg.desktopEntries

Desktop Entries allow applications to be shown in your desktop environment's app launcher.

You can define entries for programs without entries or override existing entries.

See https://specifications.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html#recognized-keys for more information on options. -

Type: attribute set of submodule

Default: +

Type: attribute set of (submodule)

Default: { } @@ -11897,7 +11897,7 @@ See Declared by:

<home-manager/modules/misc/xdg-desktop-entries.nix> -
xdg.desktopEntries.<name>.actions

The set of actions made available to application launchers.

Type: attribute set of submodule

Default: { }

Example:

{
+                
xdg.desktopEntries.<name>.actions

The set of actions made available to application launchers.

Type: attribute set of (submodule)

Default: { }

Example:

{
   "New Window" = {
     exec = "${pkgs.firefox}/bin/firefox --new-window %u";
   };
@@ -11906,11 +11906,11 @@ See xdg.desktopEntries.<name>.actions.<name>.exec

Program to execute, possibly with arguments.

Type: null or string

Declared by:

<home-manager/modules/misc/xdg-desktop-entries.nix> -
xdg.desktopEntries.<name>.actions.<name>.icon

Icon to display in file manager, menus, etc.

Type: null or string or path

Default: null

Declared by:

+
xdg.desktopEntries.<name>.actions.<name>.icon

Icon to display in file manager, menus, etc.

Type: null or string or (path)

Default: null

Declared by:

<home-manager/modules/misc/xdg-desktop-entries.nix>
xdg.desktopEntries.<name>.actions.<name>.name

Name of the action.

Type: string

Default: <name>

Declared by:

<home-manager/modules/misc/xdg-desktop-entries.nix> -
xdg.desktopEntries.<name>.categories

Categories in which the entry should be shown in a menu.

Type: null or list of string

Default: null

Declared by:

+
xdg.desktopEntries.<name>.categories

Categories in which the entry should be shown in a menu.

Type: null or (list of string)

Default: null

Declared by:

<home-manager/modules/misc/xdg-desktop-entries.nix>
xdg.desktopEntries.<name>.comment

Tooltip for the entry.

Type: null or string

Default: null

Declared by:

<home-manager/modules/misc/xdg-desktop-entries.nix> @@ -11918,9 +11918,9 @@ See xdg.desktopEntries.<name>.genericName

Generic name of the application.

Type: null or string

Default: null

Declared by:

<home-manager/modules/misc/xdg-desktop-entries.nix> -
xdg.desktopEntries.<name>.icon

Icon to display in file manager, menus, etc.

Type: null or string or path

Default: null

Declared by:

+
xdg.desktopEntries.<name>.icon

Icon to display in file manager, menus, etc.

Type: null or string or (path)

Default: null

Declared by:

<home-manager/modules/misc/xdg-desktop-entries.nix> -
xdg.desktopEntries.<name>.mimeType

The MIME type(s) supported by this application.

Type: null or list of string

Default: null

Declared by:

+
xdg.desktopEntries.<name>.mimeType

The MIME type(s) supported by this application.

Type: null or (list of string)

Default: null

Declared by:

<home-manager/modules/misc/xdg-desktop-entries.nix>
xdg.desktopEntries.<name>.name

Specific name of the application.

Type: string

Declared by:

<home-manager/modules/misc/xdg-desktop-entries.nix> @@ -11969,7 +11969,7 @@ The generated file is read-only.
xdg.mimeApps.associations.added

Defines additional associations of applications with mimetypes, as if the .desktop file was listing this mimetype in the first place. -

Type: attribute set of list of string or list of string or string convertible to it

Default: +

Type: attribute set of ((list of string) or ((list of string) or string) convertible to it)

Default: { } @@ -11982,7 +11982,7 @@ in the first place.

xdg.mimeApps.associations.removed

Removes associations of applications with mimetypes, as if the .desktop file was not listing this mimetype in the first place. -

Type: attribute set of list of string or list of string or string convertible to it

Default: +

Type: attribute set of ((list of string) or ((list of string) or string) convertible to it)

Default: { } @@ -11997,7 +11997,7 @@ is, for instance, the one that will be started when double-clicking on a file in a file manager. If the application is no longer installed, the next application in the list is attempted, and so on. -

Type: attribute set of list of string or list of string or string convertible to it

Default: +

Type: attribute set of ((list of string) or ((list of string) or string) convertible to it)

Default: { } @@ -12032,26 +12032,26 @@ The generated file is read-only. <home-manager/modules/misc/xdg-user-dirs.nix>

xdg.userDirs.createDirectories

Whether to enable automatic creation of the XDG user directories.

Type: boolean

Default: false

Example: true

Declared by:

<home-manager/modules/misc/xdg-user-dirs.nix> -
xdg.userDirs.desktop

The Desktop directory.

Type: string or path convertible to it

Default: "${config.home.homeDirectory}/Desktop"

Declared by:

+
xdg.userDirs.desktop

The Desktop directory.

Type: string or (path) convertible to it

Default: "${config.home.homeDirectory}/Desktop"

Declared by:

<home-manager/modules/misc/xdg-user-dirs.nix> -
xdg.userDirs.documents

The Documents directory.

Type: string or path convertible to it

Default: "${config.home.homeDirectory}/Documents"

Declared by:

+
xdg.userDirs.documents

The Documents directory.

Type: string or (path) convertible to it

Default: "${config.home.homeDirectory}/Documents"

Declared by:

<home-manager/modules/misc/xdg-user-dirs.nix> -
xdg.userDirs.download

The Downloads directory.

Type: string or path convertible to it

Default: "${config.home.homeDirectory}/Downloads"

Declared by:

+
xdg.userDirs.download

The Downloads directory.

Type: string or (path) convertible to it

Default: "${config.home.homeDirectory}/Downloads"

Declared by:

<home-manager/modules/misc/xdg-user-dirs.nix> -
xdg.userDirs.extraConfig

Other user directories.

Type: attribute set of string or path convertible to it

Default: { }

Example:

{
+                
xdg.userDirs.extraConfig

Other user directories.

Type: attribute set of (string or (path) convertible to it)

Default: { }

Example:

{
   XDG_MISC_DIR = "${config.home.homeDirectory}/Misc";
 }
 

Declared by:

<home-manager/modules/misc/xdg-user-dirs.nix> -
xdg.userDirs.music

The Music directory.

Type: string or path convertible to it

Default: "${config.home.homeDirectory}/Music"

Declared by:

+
xdg.userDirs.music

The Music directory.

Type: string or (path) convertible to it

Default: "${config.home.homeDirectory}/Music"

Declared by:

<home-manager/modules/misc/xdg-user-dirs.nix> -
xdg.userDirs.pictures

The Pictures directory.

Type: string or path convertible to it

Default: "${config.home.homeDirectory}/Pictures"

Declared by:

+
xdg.userDirs.pictures

The Pictures directory.

Type: string or (path) convertible to it

Default: "${config.home.homeDirectory}/Pictures"

Declared by:

<home-manager/modules/misc/xdg-user-dirs.nix> -
xdg.userDirs.publicShare

The Public share directory.

Type: string or path convertible to it

Default: "${config.home.homeDirectory}/Public"

Declared by:

+
xdg.userDirs.publicShare

The Public share directory.

Type: string or (path) convertible to it

Default: "${config.home.homeDirectory}/Public"

Declared by:

<home-manager/modules/misc/xdg-user-dirs.nix> -
xdg.userDirs.templates

The Templates directory.

Type: string or path convertible to it

Default: "${config.home.homeDirectory}/Templates"

Declared by:

+
xdg.userDirs.templates

The Templates directory.

Type: string or (path) convertible to it

Default: "${config.home.homeDirectory}/Templates"

Declared by:

<home-manager/modules/misc/xdg-user-dirs.nix> -
xdg.userDirs.videos

The Videos directory.

Type: string or path convertible to it

Default: "${config.home.homeDirectory}/Videos"

Declared by:

+
xdg.userDirs.videos

The Videos directory.

Type: string or (path) convertible to it

Default: "${config.home.homeDirectory}/Videos"

Declared by:

<home-manager/modules/misc/xdg-user-dirs.nix>
xresources.extraConfig

Additional X server resources contents. If this and all other xresources options are @@ -12077,7 +12077,7 @@ Note, that 2-dimensional lists are not supported and specifying one will throw a If this and all other xresources options are null, then this feature is disabled and no ~/.Xresources link is produced. -

Type: null or attribute set of boolean or signed integer or string or list of boolean or signed integer or string

Default: null

Example:

{
+

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

Default: null

Example:

{
   "Emacs*toolBar" = 0;
   "XTerm*faceName" = "dejavu sans mono";
   "XTerm*charClass" = [ "37:48" "45-47:48" "58:48" "64:48" "126:48" ];
@@ -12161,7 +12161,7 @@ bspc subscribe all > ~/bspc-report.log &
         }
     

Declared by:

<home-manager/modules/services/window-managers/bspwm/default.nix> -
xsession.windowManager.bspwm.rules

Rule configuration. The keys of the attribute set are the targets of the rules.

Type: attribute set of attribute set of boolean or signed integer or floating point number or string

Default: +

xsession.windowManager.bspwm.rules

Rule configuration. The keys of the attribute set are the targets of the rules.

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

Default: { } @@ -12225,7 +12225,7 @@ the desktop. <home-manager/modules/services/window-managers/bspwm/default.nix>

xsession.windowManager.bspwm.rules.<name>.sticky

Whether the node should stay on the focused desktop.

Type: null or boolean

Default: null

Example: true

Declared by:

<home-manager/modules/services/window-managers/bspwm/default.nix> -
xsession.windowManager.bspwm.settings

General settings given to bspc config.

Type: attribute set of boolean or signed integer or floating point number or string or list of boolean or signed integer or floating point number or string

Default: +

xsession.windowManager.bspwm.settings

General settings given to bspc config.

Type: attribute set of (boolean or signed integer or floating point number or string or list of (boolean or signed integer or floating point number or string))

Default: { } @@ -12349,7 +12349,7 @@ herbstclient detect_monitors ]

Declared by:

<home-manager/modules/services/window-managers/herbstluftwm.nix> -
xsession.windowManager.herbstluftwm.settings

Herbstluftwm settings.

Type: attribute set of boolean or signed integer or string

Default: +

xsession.windowManager.herbstluftwm.settings

Herbstluftwm settings.

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

Default: { } @@ -12373,7 +12373,7 @@ herbstclient detect_monitors If 'i3.config.gaps' settings are specified, 'pkgs.i3-gaps' will be set as a default package.

Type: package

Default: pkgs.i3

Example: pkgs.i3-gaps

Declared by:

<home-manager/modules/services/window-managers/i3-sway/i3.nix> -
xsession.windowManager.i3.config

i3 configuration options.

Type: null or submodule

Default: +

xsession.windowManager.i3.config

i3 configuration options.

Type: null or (submodule)

Default: { } @@ -12381,7 +12381,7 @@ If 'i3.config.gaps' settings are specified, 'pkgs.i3-gaps' will be set as a defa <home-manager/modules/services/window-managers/i3-sway/i3.nix>

xsession.windowManager.i3.config.assigns

An attribute set that assigns applications to workspaces based on criteria. -

Type: attribute set of list of attribute set of string or boolean

Default: +

Type: attribute set of list of attribute set of (string or boolean)

Default: { } @@ -12392,7 +12392,7 @@ on criteria.

Declared by:

<home-manager/modules/services/window-managers/i3-sway/i3.nix>
xsession.windowManager.i3.config.bars

i3 bars settings blocks. Set to empty list to remove bars completely. -

Type: list of submodule

Default: see code

Declared by:

+

Type: list of (submodule)

Default: see code

Declared by:

<home-manager/modules/services/window-managers/i3-sway/i3.nix>
xsession.windowManager.i3.config.bars.*.colors

Bar color settings. All color classes can be specified using submodules with 'border', 'background', 'text', fields and RGB color hex-codes as values. @@ -12407,7 +12407,7 @@ See Declared by:

<home-manager/modules/services/window-managers/i3-sway/i3.nix>
xsession.windowManager.i3.config.bars.*.colors.activeWorkspace

Border, background and text color for a workspace button when the workspace is active. -

Type: null or submodule

Default:

null for state version ≥ 20.09, as example otherwise
+

Type: null or (submodule)

Default:

null for state version ≥ 20.09, as example otherwise
 

Example: { background = "#5f676a"; border = "#333333"; text = "#ffffff"; @@ -12417,7 +12417,7 @@ See xsession.windowManager.i3.config.bars.*.colors.background

Background color of the bar.

Type: null or string

Default:

null for state version ≥ 20.09, as example otherwise
 

Example: "#000000"

Declared by:

<home-manager/modules/services/window-managers/i3-sway/i3.nix> -
xsession.windowManager.i3.config.bars.*.colors.bindingMode

Border, background and text color for the binding mode indicator

Type: null or submodule

Default:

null for state version ≥ 20.09, as example otherwise
+                
xsession.windowManager.i3.config.bars.*.colors.bindingMode

Border, background and text color for the binding mode indicator

Type: null or (submodule)

Default:

null for state version ≥ 20.09, as example otherwise
 

Example: { background = "#900000"; border = "#2f343a"; text = "#ffffff"; @@ -12431,7 +12431,7 @@ See xsession.windowManager.i3.config.bars.*.colors.focusedStatusline

Text color to be used for the statusline on the currently focused monitor output.

Type: null or string

Default: null

Example: "#ffffff"

Declared by:

<home-manager/modules/services/window-managers/i3-sway/i3.nix>
xsession.windowManager.i3.config.bars.*.colors.focusedWorkspace

Border, background and text color for a workspace button when the workspace has focus. -

Type: null or submodule

Default:

null for state version ≥ 20.09, as example otherwise
+

Type: null or (submodule)

Default:

null for state version ≥ 20.09, as example otherwise
 

Example: { background = "#285577"; border = "#4c7899"; text = "#ffffff"; @@ -12440,7 +12440,7 @@ See xsession.windowManager.i3.config.bars.*.colors.inactiveWorkspace

Border, background and text color for a workspace button when the workspace does not have focus and is not active. -

Type: null or submodule

Default:

null for state version ≥ 20.09, as example otherwise
+

Type: null or (submodule)

Default:

null for state version ≥ 20.09, as example otherwise
 

Example: { background = "#222222"; border = "#333333"; text = "#888888"; @@ -12455,7 +12455,7 @@ have focus and is not active. <home-manager/modules/services/window-managers/i3-sway/i3.nix>

xsession.windowManager.i3.config.bars.*.colors.urgentWorkspace

Border, background and text color for a workspace button when the workspace contains a window with the urgency hint set. -

Type: null or submodule

Default:

null for state version ≥ 20.09, as example otherwise
+

Type: null or (submodule)

Default:

null for state version ≥ 20.09, as example otherwise
 

Example: { background = "#900000"; border = "#2f343a"; text = "#ffffff"; @@ -12466,7 +12466,7 @@ a window with the urgency hint set. <home-manager/modules/services/window-managers/i3-sway/i3.nix>

xsession.windowManager.i3.config.bars.*.extraConfig

Extra configuration lines for this bar.

Type: strings concatenated with "\n"

Default: ""

Declared by:

<home-manager/modules/services/window-managers/i3-sway/i3.nix> -
xsession.windowManager.i3.config.bars.*.fonts

Font configuration for this bar.

Type: list of string or submodule

Default: +

xsession.windowManager.i3.config.bars.*.fonts

Font configuration for this bar.

Type: (list of string) or (submodule)

Default: { } @@ -12565,7 +12565,7 @@ This must to correspond to the value of the keybinding of the default workspace. <home-manager/modules/services/window-managers/i3-sway/i3.nix>

xsession.windowManager.i3.config.floating.border

Floating windows border width.

Type: signed integer

Default: 2

Declared by:

<home-manager/modules/services/window-managers/i3-sway/i3.nix> -
xsession.windowManager.i3.config.floating.criteria

List of criteria for windows that should be opened in a floating mode.

Type: list of attribute set of string or boolean

Default: +

xsession.windowManager.i3.config.floating.criteria

List of criteria for windows that should be opened in a floating mode.

Type: list of attribute set of (string or boolean)

Default: [ ] @@ -12609,7 +12609,7 @@ to a window on a different output. See https://i3wm.org/docs/userguide.html#focus_on_window_activation

Type: one of "smart", "urgent", "focus", "none"

Default: "smart"

Example: "none"

Declared by:

<home-manager/modules/services/window-managers/i3-sway/i3.nix> -
xsession.windowManager.i3.config.fonts

Font configuration for window titles, nagbar...

Type: list of string or submodule

Default: +

xsession.windowManager.i3.config.fonts

Font configuration for window titles, nagbar...

Type: (list of string) or (submodule)

Default: { } @@ -12621,7 +12621,7 @@ See Declared by:

<home-manager/modules/services/window-managers/i3-sway/i3.nix>
xsession.windowManager.i3.config.gaps

i3Gaps related settings. The i3-gaps package must be used for these features to work. -

Type: null or submodule

Default: null

Declared by:

+

Type: null or (submodule)

Default: null

Declared by:

<home-manager/modules/services/window-managers/i3-sway/i3.nix>
xsession.windowManager.i3.config.gaps.bottom

Bottom gaps value.

Type: null or signed integer

Default: null

Example: 5

Declared by:

<home-manager/modules/services/window-managers/i3-sway/i3.nix> @@ -12652,7 +12652,7 @@ See

Consider to use lib.mkOptionDefault function to extend or override default keybindings instead of specifying all of them from scratch. -

Type: attribute set of null or string

Default: "Default i3 keybindings."

Example:

let
+

Type: attribute set of (null or string)

Default: "Default i3 keybindings."

Example:

let
   modifier = config.xsession.windowManager.i3.config.modifier;
 in lib.mkOptionDefault {
   "${modifier}+Return" = "exec i3-sensible-terminal";
@@ -12663,7 +12663,7 @@ in lib.mkOptionDefault {
                     <home-manager/modules/services/window-managers/i3-sway/i3.nix>
                 
xsession.windowManager.i3.config.keycodebindings

An attribute set that assigns keypress to an action using key code. See https://i3wm.org/docs/userguide.html#keybindings. -

Type: attribute set of null or string

Default: +

Type: attribute set of (null or string)

Default: { } @@ -12695,7 +12695,7 @@ for more advanced setup use 'i3.extraConfig'.

xsession.windowManager.i3.config.startup

Commands that should be executed at startup. See https://i3wm.org/docs/userguide.html#_automatically_starting_applications_on_i3_startup. -

Type: list of submodule

Default: +

Type: list of (submodule)

Default: [ ] @@ -12731,7 +12731,7 @@ instead. See xsession.windowManager.i3.config.window.commands

List of commands that should be executed on specific windows. See for_window i3wm option documentation. -

Type: list of submodule

Default: +

Type: list of (submodule)

Default: [ ] @@ -12755,7 +12755,7 @@ See for_window i3wm option documentation.

A value of true is equivalent to using an empty criteria (which is different from an empty string criteria). -

Type: attribute set of string or boolean

Example:

{
+

Type: attribute set of (string or boolean)

Example:

{
   title = "x200: ~/work";
   floating = true;
 };
@@ -12775,7 +12775,7 @@ back to "1: www".
 start.
 

Type: one of "default", "stacking", "tabbed"

Default: "default"

Example: "tabbed"

Declared by:

<home-manager/modules/services/window-managers/i3-sway/i3.nix> -
xsession.windowManager.i3.config.workspaceOutputAssign

Assign workspaces to outputs.

Type: list of submodule

Default: +

xsession.windowManager.i3.config.workspaceOutputAssign

Assign workspaces to outputs.

Type: list of (submodule)

Default: [ ] @@ -12827,7 +12827,7 @@ start. }

Declared by:

<home-manager/modules/services/window-managers/spectrwm.nix> -
xsession.windowManager.spectrwm.settings

Spectrwm settings.

Type: attribute set of boolean or signed integer or string

Default: +

xsession.windowManager.spectrwm.settings

Spectrwm settings.

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

Default: { } @@ -12866,7 +12866,7 @@ by Home Manager. If this option is set to a non-null value, recompilation of xmonad outside of Home Manager (e.g. via xmonad --recompile) will fail. -

Type: null or path

Default: null

Example:

pkgs.writeText "xmonad.hs" ''
+

Type: null or (path)

Default: null

Example:

pkgs.writeText "xmonad.hs" ''
   import XMonad
   main = xmonad defaultConfig
       { terminal    = "urxvt"
@@ -12880,7 +12880,7 @@ recompilation of xmonad outside of Home Manager (e.g. via
 value must be a function which receives the attribute set
 defined in haskellPackages as the sole
 argument.
-

Type: unspecified

Default: "self: []"

Example:

haskellPackages: [
+

Type: unspecified value

Default: "self: []"

Example:

haskellPackages: [
   haskellPackages.xmonad-contrib
   haskellPackages.monad-logger
 ]
@@ -12890,13 +12890,13 @@ argument.
 and other packages. This can be used to change the GHC
 version used to build xmonad and the packages listed in
 extraPackages.
-

Type: unspecified

Default: pkgs.haskellPackages

Example: pkgs.haskell.packages.ghc784

Declared by:

+

Type: unspecified value

Default: pkgs.haskellPackages

Example: pkgs.haskell.packages.ghc784

Declared by:

<home-manager/modules/services/window-managers/xmonad.nix>
xsession.windowManager.xmonad.libFiles

Additional files that will be saved in ~/.xmonad/lib/ and included in the configuration build. The keys are the file names while the values are paths to the contents of the files. -

Type: attribute set of path

Default: +

Type: attribute set of (path)

Default: { } diff --git a/tools.html b/tools.html index cd9c74ad1..c72c3dc2b 100644 --- a/tools.html +++ b/tools.html @@ -1,6 +1,6 @@ -Appendix D. Tools

Appendix D. Tools

home-manager - — reconfigure a user environment

Name

home-manager +Appendix D. Tools

Appendix D. Tools

home-manager + — reconfigure a user environment

Name

home-manager — reconfigure a user environment

Synopsis

home-manager { build | @@ -84,7 +84,7 @@ | --verbose } - ]

Description

+ ]

Description

This command updates the user environment so that it corresponds to the configuration specified in ~/.config/nixpkgs/home.nix or ~/.config/nixpkgs/flake.nix.

@@ -153,7 +153,7 @@ available for immediate garbage collection.

-

Options

+

Options

The tool accepts the options

-A attrPath @@ -265,15 +265,15 @@ --verbose

Activates verbose output. -

Files

+

Files

$XDG_DATA_HOME/home-manager/news-read-ids

Identifiers of news items that have been shown. Can be deleted to reset the read news indicator. -

Bugs

+

Bugs

Please report any bugs on the project issue tracker. -

See also

+

See also

home-configuration.nix(5)

\ No newline at end of file