From 9e7133252fdefa8e77d85ae9984b990c56e53e89 Mon Sep 17 00:00:00 2001 From: berbiche Date: Fri, 8 Oct 2021 20:37:41 +0000 Subject: [PATCH] deploy: fd2f746016e3d99bdc3c86736d30f2ca7594929a --- index.html | 4 +- nix-darwin-options.html | 10 +- nixos-options.html | 8 +- options.html | 4176 +++++++++++++++++++++------------------ tools.html | 14 +- 5 files changed, 2330 insertions(+), 1882 deletions(-) diff --git a/index.html b/index.html index acf9a0bc..aeb2f710 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. Writing Home Manager Modules
2.1. Option Types
3. Contributing
3.1. Getting started
3.2. Guidelines
3.2.1. Maintain backward compatibility
3.2.2. Keep forward compatibility in mind
3.2.3. Add only valuable options
3.2.4. Add relevant tests
3.2.5. Add relevant documentation
3.2.6. Add yourself as a module maintainer
3.2.7. Format your code
3.2.8. Format your commit messages
3.2.9. Format your news entries
3.2.10. Use conditional modules and news
3.2.11. Mind the license
3.3. Commits
3.4. Code Style
3.5. News
3.6. Tests
4. Frequently Asked Questions (FAQ)
4.1. Why is there a collision error when switching generation?
4.2. Why are the session variables not set?
4.3. How to set up a configuration for multiple users/machines?
4.4. Why do I get an error message about ca.desrt.dconf?
4.5. How do I install packages from Nixpkgs unstable?
4.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 21.11
E.1.1. Highlights
E.1.2. State Version Changes
E.2. Release 21.05
E.2.1. Highlights
E.2.2. State Version Changes
E.3. Release 20.09
E.3.1. Highlights
E.3.2. State Version Changes
E.4. Release 20.03
E.4.1. Highlights
E.4.2. State Version Changes
E.5. Release 19.09
E.5.1. Highlights
E.5.2. State Version Changes
E.6. Release 19.03
E.6.1. Highlights
E.6.2. State Version Changes
E.7. 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. Writing Home Manager Modules
2.1. Option Types
3. Contributing
3.1. Getting started
3.2. Guidelines
3.2.1. Maintain backward compatibility
3.2.2. Keep forward compatibility in mind
3.2.3. Add only valuable options
3.2.4. Add relevant tests
3.2.5. Add relevant documentation
3.2.6. Add yourself as a module maintainer
3.2.7. Format your code
3.2.8. Format your commit messages
3.2.9. Format your news entries
3.2.10. Use conditional modules and news
3.2.11. Mind the license
3.3. Commits
3.4. Code Style
3.5. News
3.6. Tests
4. Frequently Asked Questions (FAQ)
4.1. Why is there a collision error when switching generation?
4.2. Why are the session variables not set?
4.3. How to set up a configuration for multiple users/machines?
4.4. Why do I get an error message about ca.desrt.dconf?
4.5. How do I install packages from Nixpkgs unstable?
4.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 21.11
E.1.1. Highlights
E.1.2. State Version Changes
E.2. Release 21.05
E.2.1. Highlights
E.2.2. State Version Changes
E.3. Release 20.09
E.3.1. Highlights
E.3.2. State Version Changes
E.4. Release 20.03
E.4.1. Highlights
E.4.2. State Version Changes
E.5. Release 19.09
E.5.1. Highlights
E.5.2. State Version Changes
E.6. Release 19.03
E.6.1. Highlights
E.6.2. State Version Changes
E.7. 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 5eb3bdf5..9a1e972e 100644 --- a/nix-darwin-options.html +++ b/nix-darwin-options.html @@ -14,7 +14,7 @@ file extension rather than exiting with an error. } -

Example:

{ modulesPath = ../modules; }

Declared by:

+

Declared by:

<home-manager/nix-darwin/default.nix>
home-manager.sharedModules

Extra modules added to all users.

Type: list of Home Manager moduless

Default: @@ -23,7 +23,13 @@ file extension rather than exiting with an error. ] -

Example:

[ { home.packages = [ nixpkgs-fmt ]; } ]

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "[ { home.packages = [ nixpkgs-fmt ]; } ]"; + } + +

Declared by:

<home-manager/nix-darwin/default.nix>
home-manager.useGlobalPkgs

Whether to enable using the system configuration's pkgs argument in Home Manager. This disables the Home Manager diff --git a/nixos-options.html b/nixos-options.html index e60739fc..8b43ddc5 100644 --- a/nixos-options.html +++ b/nixos-options.html @@ -23,7 +23,13 @@ file extension rather than exiting with an error. ] -

Example:

[ { home.packages = [ nixpkgs-fmt ]; } ]

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "[ { home.packages = [ nixpkgs-fmt ]; } ]"; + } + +

Declared by:

<home-manager/nixos/default.nix>
home-manager.useGlobalPkgs

Whether to enable using the system configuration's pkgs argument in Home Manager. This disables the Home Manager diff --git a/options.html b/options.html index 11eabf4f..a87709c0 100644 --- a/options.html +++ b/options.html @@ -58,13 +58,13 @@ explanation about possible values. command = "'\${pkgs.notmuch}/bin/notmuch address --format=json --output=recipients date:6M..'"; regexp = '''\[?{"name": "(?P<name>.*)", "address": "(?P<email>.+)", "name-addr": ".*"}[,\]]?'''; shellcommand_external_filtering = "False"; type = "shellcommand"; } -

Example:

{
-  type = "shellcommand";
-  command = "abook --mutt-query";
-  regexp = "'^(?P<email>[^@]+@[^\t]+)\t+(?P<name>[^\t]+)'";
-  ignorecase = "True";
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n type = \"shellcommand\";\n command = \"abook --mutt-query\";\n regexp = \"'^(?P<email>[^@]+@[^\\t]+)\\t+(?P<name>[^\\t]+)'\";\n ignorecase = \"True\";\n}\n"; + } + +

Declared by:

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

Extra settings to add to this Alot account configuration.

Type: strings concatenated with "\n"

Default: @@ -216,10 +216,13 @@ account configuration. } -

Example:

{
-  default-page-size = 50;
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n default-page-size = 50;\n}\n"; + } + +

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: @@ -451,11 +454,13 @@ the given mail store. } -

Example:

{
-  PipelineDepth = 10;
-  Timeout = 60;
-};
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n PipelineDepth = 10;\n Timeout = 60;\n};\n"; + } + +

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 booleans

Default: @@ -464,11 +469,13 @@ the given mail store. } -

Example:

{
-  MaxMessages = 10000;
-  MaxSize = "1m";
-};
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n MaxMessages = 10000;\n MaxSize = \"1m\";\n};\n"; + } + +

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 booleans

Default: @@ -705,11 +712,11 @@ attribute name of the account configuration. <home-manager/modules/programs/neomutt.nix>

accounts.email.accounts.<name>.neomutt.sendMailCommand

Command to send a mail. If not set, neomutt will be in charge of sending mails.

Type: null or string

Default: - if config.msmtp.enable then - "msmtpq --read-envelope-from --read-recipients" -else - null - + + { + _type = "literalExpression"; text = "if config.msmtp.enable then\n \"msmtpq --read-envelope-from --read-recipients\"\nelse\n null\n"; + } +

Example: "msmtpq --read-envelope-from --read-recipients"

Declared by:

@@ -889,16 +896,13 @@ directory. } -

Example:

{
-  "org/gnome/calculator" = {
-    button-mode = "programming";
-    show-thousands = true;
-    base = 10;
-    word-size = 64;
-    window-position = lib.hm.gvariant.mkTuple [100 100];
-  };
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n \"org/gnome/calculator\" = {\n button-mode = \"programming\";\n show-thousands = true;\n base = 10;\n word-size = 64;\n window-position = lib.hm.gvariant.mkTuple [100 100];\n };\n}\n"; + } + +

Declared by:

<home-manager/modules/misc/dconf.nix>
fonts.fontconfig.enable

Whether to enable fontconfig configuration. This will, for example, allow fontconfig to discover fonts and @@ -925,7 +929,13 @@ to your profile. If null then the font is assumed to already be available in your profile.

Type: null or package

Default: null -

Example:

pkgs.dejavu_fonts

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "pkgs.dejavu_fonts"; + } + +

Declared by:

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

The family name of the font within the package.

Type: string

Example: @@ -941,8 +951,18 @@ is assumed to already be available in your profile. <home-manager/modules/misc/gtk.nix>

gtk.gtk2.configLocation

The location to put the GTK configuration file.

Type: path

Default: - "${config.home.homeDirectory}/.gtkrc-2.0" -

Example:

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

Declared by:

+ + { + _type = "literalExpression"; text = ''"''${config.home.homeDirectory}/.gtkrc-2.0"''; + } + +

Example: + + { + _type = "literalExpression"; text = ''"''${config.xdg.configHome}/gtk-2.0/gtkrc"''; + } + +

Declared by:

<home-manager/modules/misc/gtk.nix>
gtk.gtk2.extraConfig

Extra configuration lines to add verbatim to ~/.gtkrc-2.0. @@ -997,7 +1017,13 @@ to your profile. If null then the theme is assumed to already be available in your profile.

Type: null or package

Default: null -

Example:

pkgs.gnome.gnome_themes_standard

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "pkgs.gnome.gnome_themes_standard"; + } + +

Declared by:

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

The name of the theme within the package.

Type: string

Example: "Adwaita" @@ -1012,7 +1038,13 @@ to your profile. If null then the theme is assumed to already be available in your profile.

Type: null or package

Default: null -

Example:

pkgs.gnome.gnome_themes_standard

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "pkgs.gnome.gnome_themes_standard"; + } + +

Declared by:

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

The name of the theme within the package.

Type: string

Example: "Adwaita" @@ -1089,13 +1121,13 @@ any issue that may arise. The variable } -

Example:

{
-  myActivationAction = lib.hm.dag.entryAfter ["writeBoundary"] ''
-    $DRY_RUN_CMD ln -s $VERBOSE_ARG \
-        ${builtins.toPath ./link-me-directly} $HOME
-  '';
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n myActivationAction = lib.hm.dag.entryAfter [\"writeBoundary\"] ''\n \$DRY_RUN_CMD ln -s \$VERBOSE_ARG \\\n \${builtins.toPath ./link-me-directly} \$HOME\n '';\n}\n"; + } + +

Declared by:

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

List of additional package outputs of the packages home.packages that should be installed into @@ -1162,7 +1194,11 @@ containing that text. <home-manager/modules/files.nix>

home.file.<name>.target

Path to target file relative to HOME.

Type: string

Default: - <name> + + { + _type = "literalExpression"; text = "<name>"; + } +

Declared by:

<home-manager/modules/files.nix>
home.file.<name>.text

Text of the file. If this option is null then @@ -1173,9 +1209,11 @@ must be set.

Declared by:

<home-manager/modules/files.nix>
home.homeDirectory

The user's home directory. Must be an absolute path.

Type: path

Default: - "$HOME" for state version < 20.09, -undefined for state version ≥ 20.09 - + + { + _type = "literalExpression"; text = "\"\$HOME\" for state version < 20.09,\nundefined for state version ≥ 20.09\n"; + } +

Example: "/home/jane.doe"

Declared by:

@@ -1196,7 +1234,11 @@ configuration will be used. This defaults to null for state version ≥ 19.09 and "us" otherwise.

Type: null or string

Default: - null + + { + _type = "literalExpression"; text = "null"; + } +

Declared by:

<home-manager/modules/home-environment.nix>
home.keyboard.model

Keyboard model. @@ -1227,7 +1269,11 @@ system configuration will be used. This defaults to null for state version ≥ 19.09 and "" otherwise.

Type: null or string

Default: - null + + { + _type = "literalExpression"; text = "null"; + } +

Example: "colemak"

Declared by:

@@ -1372,9 +1418,11 @@ conversion or moving files.

Declared by:

<home-manager/modules/misc/version.nix>
home.username

The user's username.

Type: string

Default: - "$USER" for state version < 20.09, -undefined for state version ≥ 20.09 - + + { + _type = "literalExpression"; text = "\"\$USER\" for state version < 20.09,\nundefined for state version ≥ 20.09\n"; + } +

Example: "jane.doe"

Declared by:

@@ -1413,7 +1461,13 @@ Currently the following input methods are available in Home Manager: ] -

Example:

with pkgs.fcitx-engines; [ mozc hangul ]

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "with pkgs.fcitx-engines; [ mozc hangul ]"; + } + +

Declared by:

<home-manager/modules/i18n/input-method/fcitx.nix>
i18n.inputMethod.fcitx5.addons

Enabled Fcitx5 addons.

Type: list of packages

Default: @@ -1422,7 +1476,13 @@ Currently the following input methods are available in Home Manager: ] -

Example:

with pkgs; [ fcitx5-rime ]

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "with pkgs; [ fcitx5-rime ]"; + } + +

Declared by:

<home-manager/modules/i18n/input-method/fcitx5.nix>
i18n.inputMethod.kime.config

kime configuration. Refer to https://github.com/Riey/kime/blob/develop/docs/CONFIGURATION.md @@ -1433,22 +1493,13 @@ for details on supported values. } -

Example:

{
-  daemon = {
-    modules = ["Xim" "Indicator"];
-  };
-
-  indicator = {
-    icon_color = "White";
-  };
-
-  engine = {
-    hangul = {
-      layout = "dubeolsik";
-    };
-  };
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n daemon = {\n modules = [\"Xim\" \"Indicator\"];\n };\n\n indicator = {\n icon_color = \"White\";\n };\n\n engine = {\n hangul = {\n layout = \"dubeolsik\";\n };\n };\n}\n"; + } + +

Declared by:

<home-manager/modules/i18n/input-method/kime.nix>
i18n.inputMethod.uim.toolbar

Selected UIM toolbar.

Type: one of "gtk", "gtk3", "gtk-systray", "gtk3-systray", "qt4"

Default: @@ -1576,15 +1627,13 @@ applies within the Home Manager configuration. See works both internally and externally.

Type: null or list of nixpkgs overlays

Default: null -

Example:

[ (self: super: {
-    openssh = super.openssh.override {
-      hpnSupport = true;
-      withKerberos = true;
-      kerberos = self.libkrb5;
-    };
-  };
-) ]
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "[ (self: super: {\n openssh = super.openssh.override {\n hpnSupport = true;\n withKerberos = true;\n kerberos = self.libkrb5;\n };\n };\n) ]\n"; + } + +

Declared by:

<home-manager/modules/misc/nixpkgs.nix>
pam.sessionVariables

Environment variables that will be set for the PAM session. The variable values must be as described in @@ -1656,7 +1705,11 @@ message = Message from above

Declared by:

<home-manager/modules/programs/alacritty.nix>
programs.alacritty.package

The Alacritty package to install.

Type: package

Default: - pkgs.alacritty + + { + _type = "literalExpression"; text = "pkgs.alacritty"; + } +

Declared by:

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

Configuration written to @@ -1669,20 +1722,13 @@ for the default configuration. } -

Example:

{
-  window.dimensions = {
-    lines = 3;
-    columns = 200;
-  };
-  key_bindings = [
-    {
-      key = "K";
-      mods = "Control";
-      chars = "\\x0c";
-    }
-  ];
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n window.dimensions = {\n lines = 3;\n columns = 200;\n };\n key_bindings = [\n {\n key = \"K\";\n mods = \"Control\";\n chars = \"\\\\x0c\";\n }\n ];\n}\n"; + } + +

Declared by:

<home-manager/modules/programs/alacritty.nix>
programs.alot.enable

Whether to enable the Alot mail user agent. Alot uses the Notmuch email system and will therefore be automatically @@ -1767,12 +1813,13 @@ enabled for each email account that is managed by Notmuch. auto_remove_unread = true; handle_mouse = true; initial_command = "search tag:inbox AND NOT tag:killed"; prefer_plaintext = true; } -

Example:

{
-  auto_remove_unread = true;
-  ask_subject = false;
-  thread_indent_replies = 2;
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n auto_remove_unread = true;\n ask_subject = false;\n thread_indent_replies = 2;\n}\n"; + } + +

Declared by:

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

How to display the tags.

Type: attribute set of submodules

Default: @@ -1827,14 +1874,13 @@ for options. } -

Example:

{
-  listen-port = 60000;
-  dht-listen-port = 60000;
-  seed-ratio = 1.0;
-  max-upload-limit = "50K";
-  ftp-pasv = true;
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n listen-port = 60000;\n dht-listen-port = 60000;\n seed-ratio = 1.0;\n max-upload-limit = \"50K\";\n ftp-pasv = true;\n}\n"; + } + +

Declared by:

<home-manager/modules/programs/aria2.nix>
programs.astroid.enable

Whether to enable Astroid.

Type: boolean

Default: false @@ -1859,10 +1905,13 @@ See Example:

{
-  poll.interval = 0;
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n poll.interval = 0;\n}\n"; + } + +

Declared by:

<home-manager/modules/programs/astroid.nix>
programs.astroid.pollScript

Script to run to fetch/update mails.

Type: string

Default: @@ -1894,7 +1943,11 @@ key to open the Atuin history.

Declared by:

<home-manager/modules/programs/atuin.nix>
programs.atuin.package

The package to use for atuin.

Type: package

Default: - pkgs.atuin + + { + _type = "literalExpression"; text = "pkgs.atuin"; + } +

Declared by:

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

Configuration written to @@ -1908,13 +1961,13 @@ of options. } -

Example:

{
-  auto_sync = true;
-  sync_frequency = "5m";
-  sync_address = "https://api.atuin.sh";
-  search_mode = "prefix";
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n auto_sync = true;\n sync_frequency = \"5m\";\n sync_address = \"https://api.atuin.sh\";\n search_mode = \"prefix\";\n}\n"; + } + +

Declared by:

<home-manager/modules/programs/atuin.nix>
programs.autojump.enable

Whether to enable autojump.

Type: boolean

Default: false @@ -1949,31 +2002,13 @@ of options. } -

Example:

{
-  postswitch = {
-    "notify-i3" = "${pkgs.i3}/bin/i3-msg restart";
-    "change-background" = readFile ./change-background.sh;
-    "change-dpi" = ''
-      case "$AUTORANDR_CURRENT_PROFILE" in
-        default)
-          DPI=120
-          ;;
-        home)
-          DPI=192
-          ;;
-        work)
-          DPI=144
-          ;;
-        *)
-          echo "Unknown profle: $AUTORANDR_CURRENT_PROFILE"
-          exit 1
-      esac
-
-      echo "Xft.dpi: $DPI" | ${pkgs.xorg.xrdb}/bin/xrdb -merge
-    ''
-  };
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n postswitch = {\n \"notify-i3\" = \"\${pkgs.i3}/bin/i3-msg restart\";\n \"change-background\" = readFile ./change-background.sh;\n \"change-dpi\" = ''\n case \"\$AUTORANDR_CURRENT_PROFILE\" in\n default)\n DPI=120\n ;;\n home)\n DPI=192\n ;;\n work)\n DPI=144\n ;;\n *)\n echo \"Unknown profle: \$AUTORANDR_CURRENT_PROFILE\"\n exit 1\n esac\n\n echo \"Xft.dpi: \$DPI\" | \${pkgs.xorg.xrdb}/bin/xrdb -merge\n ''\n };\n}\n"; + } + +

Declared by:

<home-manager/modules/programs/autorandr.nix>
programs.autorandr.hooks.postswitch

Postswitch hook executed after mode switch.

Type: attribute set of strings concatenated with "\n"s

Default: @@ -2006,29 +2041,13 @@ of options. } -

Example:

{
-  "work" = {
-    fingerprint = {
-      eDP1 = "<EDID>";
-      DP1 = "<EDID>";
-    };
-    config = {
-      eDP1.enable = false;
-      DP1 = {
-        enable = true;
-        crtc = 0;
-        primary = true;
-        position = "0x0";
-        mode = "3840x2160";
-        gamma = "1.0:0.909:0.833";
-        rate = "60.00";
-        rotate = "left";
-      };
-    };
-    hooks.postswitch = readFile ./work-postswitch.sh;
-  };
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n \"work\" = {\n fingerprint = {\n eDP1 = \"<EDID>\";\n DP1 = \"<EDID>\";\n };\n config = {\n eDP1.enable = false;\n DP1 = {\n enable = true;\n crtc = 0;\n primary = true;\n position = \"0x0\";\n mode = \"3840x2160\";\n gamma = \"1.0:0.909:0.833\";\n rate = \"60.00\";\n rotate = \"left\";\n };\n };\n hooks.postswitch = readFile ./work-postswitch.sh;\n };\n}\n"; + } + +

Declared by:

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

Per output profile configuration.

Type: attribute set of submodules

Default: @@ -2102,11 +2121,13 @@ This option is a shortcut version of the transform option and they are mutually exclusive.

Type: null or submodule

Default: null -

Example:

{
-  x = 1.25;
-  y = 1.25;
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n x = 1.25;\n y = 1.25;\n}\n"; + } + +

Declared by:

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

Output scaling method.

Type: one of "factor", "pixel"

Default: "factor" @@ -2123,12 +2144,13 @@ exclusive. for the documentation of the transform matrix.

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 ]
-]
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "[\n [ 0.6 0.0 0.0 ]\n [ 0.0 0.6 0.0 ]\n [ 0.0 0.0 1.0 ]\n]\n"; + } + +

Declared by:

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

Output name to EDID mapping. Use autorandr --fingerprint to get current setup values. @@ -2257,11 +2279,13 @@ this option) to command strings or directly to build outputs. } -

Example:

{
-  ll = "ls -l";
-  ".." = "cd ..";
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n ll = \"ls -l\";\n \"..\" = \"cd ..\";\n}\n"; + } + +

Declared by:

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

Shell options to set. Prefix an option with - to unset. @@ -2311,15 +2335,13 @@ this option) to command strings or directly to build outputs. } -

Example:

{
-  dracula = builtins.readFile (pkgs.fetchFromGitHub {
-    owner = "dracula";
-    repo = "sublime"; # Bat uses sublime syntax for its themes
-    rev = "26c57ec282abcaa76e57e055f38432bd827ac34e";
-    sha256 = "019hfl4zbn4vm4154hh3bwk6hm7bdxbr1hdww83nabxwjn99ndhv";
-  } + "/Dracula.tmTheme");
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n dracula = builtins.readFile (pkgs.fetchFromGitHub {\n owner = \"dracula\";\n repo = \"sublime\"; # Bat uses sublime syntax for its themes\n rev = \"26c57ec282abcaa76e57e055f38432bd827ac34e\";\n sha256 = \"019hfl4zbn4vm4154hh3bwk6hm7bdxbr1hdww83nabxwjn99ndhv\";\n } + \"/Dracula.tmTheme\");\n}\n"; + } + +

Declared by:

<home-manager/modules/programs/bat.nix>
programs.beets.enable

Whether to enable the beets music library manager. This defaults to false for state @@ -2332,8 +2354,18 @@ version ≥ 19.03. For earlier versions beets is enabled if

programs.beets.package

The beets package to use. Can be used to specify extensions.

Type: package

Default: - pkgs.beets -

Example:

(pkgs.beets.override { enableCheck = true; })

Declared by:

+ + { + _type = "literalExpression"; text = "pkgs.beets"; + } + +

Example: + + { + _type = "literalExpression"; text = "(pkgs.beets.override { enableCheck = true; })"; + } + +

Declared by:

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

Configuration written to ~/.config/beets/config.yaml @@ -2353,7 +2385,11 @@ customizable interface.

Type: boole

Declared by:

<home-manager/modules/programs/bottom.nix>
programs.bottom.package

Package providing bottom.

Type: package

Default: - pkgs.bottom + + { + _type = "literalExpression"; text = "pkgs.bottom"; + } +

Declared by:

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

Configuration written to @@ -2368,17 +2404,13 @@ for the default configuration. } -

Example:

{
-  flags = {
-    avg_cpu = true;
-    temperature_type = "c";
-  };
-
-  colors = {
-    low_battery_color = "red";
-  };
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n flags = {\n avg_cpu = true;\n temperature_type = \"c\";\n };\n\n colors = {\n low_battery_color = \"red\";\n };\n}\n"; + } + +

Declared by:

<home-manager/modules/programs/bottom.nix>
programs.broot.enable

Whether to enable Broot, a better way to navigate directories.

Type: boolean

Default: false @@ -2402,7 +2434,11 @@ for the default configuration.

Declared by:

<home-manager/modules/programs/broot.nix>
programs.broot.package

Package providing broot

Type: package

Default: - pkgs.broot + + { + _type = "literalExpression"; text = "pkgs.broot"; + } +

Declared by:

<home-manager/modules/programs/broot.nix>
programs.broot.modal

Whether to enable modal (vim) mode.

Type: boolean

Default: @@ -2424,23 +2460,13 @@ Add _fg for a foreground color and } -

Example:

{
-  status_normal_fg = "grayscale(18)";
-  status_normal_bg = "grayscale(3)";
-  status_error_fg = "red";
-  status_error_bg = "yellow";
-  tree_fg = "red";
-  selected_line_bg = "grayscale(7)";
-  permissions_fg = "grayscale(12)";
-  size_bar_full_bg = "red";
-  size_bar_void_bg = "black";
-  directory_fg = "lightyellow";
-  input_fg = "cyan";
-  flag_value_fg = "lightyellow";
-  table_border_fg = "red";
-  code_fg = "lightyellow";
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n status_normal_fg = \"grayscale(18)\";\n status_normal_bg = \"grayscale(3)\";\n status_error_fg = \"red\";\n status_error_bg = \"yellow\";\n tree_fg = \"red\";\n selected_line_bg = \"grayscale(7)\";\n permissions_fg = \"grayscale(12)\";\n size_bar_full_bg = \"red\";\n size_bar_void_bg = \"black\";\n directory_fg = \"lightyellow\";\n input_fg = \"cyan\";\n flag_value_fg = \"lightyellow\";\n table_border_fg = \"red\";\n code_fg = \"lightyellow\";\n}\n"; + } + +

Declared by:

<home-manager/modules/programs/broot.nix>
programs.broot.verbs

Define new verbs. For more information, see https://dystroy.org/broot/documentation/configuration/#verb-definition-attributes. @@ -2474,18 +2500,13 @@ The possible attributes are: ] -

Example:

[
-  { invocation = "p"; execution = ":parent"; }
-  { invocation = "edit"; shortcut = "e"; execution = "$EDITOR {file}" ; }
-  { invocation = "create {subpath}"; execution = "$EDITOR {directory}/{subpath}"; }
-  { invocation = "view"; execution = "less {file}"; }
-  {
-    invocation = "blop {name}\\.{type}";
-    execution = "/bin/mkdir {parent}/{type} && /usr/bin/nvim {parent}/{type}/{name}.{type}";
-    from_shell = true;
-  }
-]
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "[\n { invocation = \"p\"; execution = \":parent\"; }\n { invocation = \"edit\"; shortcut = \"e\"; execution = \"\$EDITOR {file}\" ; }\n { invocation = \"create {subpath}\"; execution = \"\$EDITOR {directory}/{subpath}\"; }\n { invocation = \"view\"; execution = \"less {file}\"; }\n {\n invocation = \"blop {name}\\\\.{type}\";\n execution = \"/bin/mkdir {parent}/{type} && /usr/bin/nvim {parent}/{type}/{name}.{type}\";\n from_shell = true;\n }\n]\n"; + } + +

Declared by:

<home-manager/modules/programs/broot.nix>
programs.browserpass.enable

Whether to enable the browserpass extension host application.

Type: boolean

Default: false @@ -2514,7 +2535,11 @@ The possible attributes are:

Declared by:

<home-manager/modules/programs/chromium.nix>
programs.chromium.package

The Chromium package to use.

Type: package

Default: - pkgs.chromium + + { + _type = "literalExpression"; text = "pkgs.chromium"; + } +

Declared by:

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

List of Chromium extensions to install. @@ -2532,19 +2557,13 @@ documentation. ] -

Example:

[
-  { id = "cjpalhdlnbpafiamejdnhcphjbkeiagm"; } # ublock origin
-  {
-    id = "dcpihecpambacapedldabdbpakmachpb";
-    updateUrl = "https://raw.githubusercontent.com/iamadamdev/bypass-paywalls-chrome/master/updates.xml";
-  }
-  {
-    id = "aaaaaaaaaabbbbbbbbbbcccccccccc";
-    crxPath = "/home/share/extension.crx";
-    version = "1.0";
-  }
-]
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "[\n { id = \"cjpalhdlnbpafiamejdnhcphjbkeiagm\"; } # ublock origin\n {\n id = \"dcpihecpambacapedldabdbpakmachpb\";\n updateUrl = \"https://raw.githubusercontent.com/iamadamdev/bypass-paywalls-chrome/master/updates.xml\";\n }\n {\n id = \"aaaaaaaaaabbbbbbbbbbcccccccccc\";\n crxPath = \"/home/share/extension.crx\";\n version = \"1.0\";\n }\n]\n"; + } + +

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: @@ -2614,12 +2633,13 @@ for options. } -

Example:

{
-  OTHER_WRITABLE = "30;46";
-  ".sh" = "01;32";
-  ".csh" = "01;32";
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n OTHER_WRITABLE = \"30;46\";\n \".sh\" = \"01;32\";\n \".csh\" = \"01;32\";\n}\n"; + } + +

Declared by:

<home-manager/modules/programs/dircolors.nix>
programs.direnv.enable

Whether to enable direnv, the environment switcher.

Type: boolean

Default: false @@ -2691,8 +2711,18 @@ necessary to use the Lombok class annotations. <home-manager/modules/programs/eclipse.nix>

programs.eclipse.package

The Eclipse package to install.

Type: package

Default: - pkgs.eclipses.eclipse-platform -

Example:

pkgs.eclipses.eclipse-java

Declared by:

+ + { + _type = "literalExpression"; text = "pkgs.eclipses.eclipse-platform"; + } + +

Example: + + { + _type = "literalExpression"; text = "pkgs.eclipses.eclipse-java"; + } + +

Declared by:

<home-manager/modules/programs/eclipse.nix>
programs.eclipse.jvmArgs

JVM arguments to use for the Eclipse process.

Type: list of strings

Default: @@ -2717,8 +2747,18 @@ necessary to use the Lombok class annotations.

Declared by:

<home-manager/modules/programs/emacs.nix>
programs.emacs.package

The Emacs package to use.

Type: package

Default: - pkgs.emacs -

Example:

pkgs.emacs25-nox

Declared by:

+ + { + _type = "literalExpression"; text = "pkgs.emacs"; + } + +

Example: + + { + _type = "literalExpression"; text = "pkgs.emacs25-nox"; + } + +

Declared by:

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

Configuration to include in the Emacs default init file. See https://www.gnu.org/software/emacs/manual/html_node/elisp/Init-File.html @@ -2734,16 +2774,24 @@ available packages run: nix-env -f '<nixpkgs>' -qaP -A emacsPackages.

Type: Function that takes an attribute set and returns a list containing a selection of the values of the input set

Default: "epkgs: []" -

Example:

epkgs: [ epkgs.emms epkgs.magit ]

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "epkgs: [ epkgs.emms epkgs.magit ]"; + } + +

Declared by:

<home-manager/modules/programs/emacs.nix>
programs.emacs.overrides

Allows overriding packages within the Emacs package set.

Type: An overlay function, takes self and super and returns an attribute set overriding the desired attributes.

Default: "self: super: {}" -

Example:

self: super: rec {
-  haskell-mode = self.melpaPackages.haskell-mode;
-  # ...
-};
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "self: super: rec {\n haskell-mode = self.melpaPackages.haskell-mode;\n # ...\n};\n"; + } + +

Declared by:

<home-manager/modules/programs/emacs.nix>
programs.exa.enable

Whether to enable exa, a modern replacement for ls.

Type: boolean

Default: false @@ -2827,17 +2875,18 @@ also need to set the NixOS option this should be a wrapped Firefox package. For earlier state versions it should be an unwrapped Firefox package.

Type: package

Default: - pkgs.firefox -

Example:

pkgs.firefox.override {
-  # See nixpkgs' firefox/wrapper.nix to check which options you can use
-  cfg = {
-    # Gnome shell native connector
-    enableGnomeExtensions = true;
-    # Tridactyl native connector
-    enableTridactylNative = true;
-  };
-}
-

Declared by:

+ + { + _type = "literalExpression"; text = "pkgs.firefox"; + } + +

Example: + + { + _type = "literalExpression"; text = "pkgs.firefox.override {\n # See nixpkgs' firefox/wrapper.nix to check which options you can use\n cfg = {\n # Gnome shell native connector\n enableGnomeExtensions = true;\n # Tridactyl native connector\n enableTridactylNative = true;\n };\n}\n"; + } + +

Declared by:

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

List of Firefox add-on packages to install. Some pre-packaged add-ons are accessible from NUR, @@ -2868,11 +2917,13 @@ handles extension side-loading. ] -

Example:

with pkgs.nur.repos.rycee.firefox-addons; [
-  https-everywhere
-  privacy-badger
-]
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "with pkgs.nur.repos.rycee.firefox-addons; [\n https-everywhere\n privacy-badger\n]\n"; + } + +

Declared by:

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

Attribute set of Firefox profiles.

Type: attribute set of submodules

Default: @@ -2890,16 +2941,13 @@ previously existing bookmarks! } -

Example:

{
-  wikipedia = {
-    keyword = "wiki";
-    url = "https://en.wikipedia.org/wiki/Special:Search?search=%s&go=Go";
-  };
-  "kernel.org" = {
-    url = "https://www.kernel.org";
-  };
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n wikipedia = {\n keyword = \"wiki\";\n url = \"https://en.wikipedia.org/wiki/Special:Search?search=%s&go=Go\";\n };\n \"kernel.org\" = {\n url = \"https://www.kernel.org\";\n };\n}\n"; + } + +

Declared by:

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

Bookmark search keyword.

Type: null or string

Default: null @@ -2939,15 +2987,13 @@ previously existing bookmarks! } -

Example:

{
-  "browser.startup.homepage" = "https://nixos.org";
-  "browser.search.region" = "GB";
-  "browser.search.isUS" = false;
-  "distribution.searchplugins.defaultLocale" = "en-GB";
-  "general.useragent.locale" = "en-GB";
-  "browser.bookmarks.showMobileBookmarks" = true;
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n \"browser.startup.homepage\" = \"https://nixos.org\";\n \"browser.search.region\" = \"GB\";\n \"browser.search.isUS\" = false;\n \"distribution.searchplugins.defaultLocale\" = \"en-GB\";\n \"general.useragent.locale\" = \"en-GB\";\n \"browser.bookmarks.showMobileBookmarks\" = true;\n}\n"; + } + +

Declared by:

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

Custom Firefox user chrome CSS.

Type: strings concatenated with "\n"

Default: "" @@ -2980,7 +3026,11 @@ previously existing bookmarks! <home-manager/modules/programs/fish.nix>

programs.fish.package

The fish package to install. May be used to change the version.

Type: package

Default: - pkgs.fish + + { + _type = "literalExpression"; text = "pkgs.fish"; + } +

Declared by:

<home-manager/modules/programs/fish.nix>
programs.fish.functions

Basic functions to add to fish. For more information see @@ -2991,15 +3041,13 @@ previously existing bookmarks! } -

Example:

{
-  __fish_command_not_found_handler = {
-    body = "__fish_default_command_not_found_handler $argv[1]";
-    onEvent = "fish_command_not_found";
-  };
-
-  gitignore = "curl -sL https://www.gitignore.io/api/$argv";
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n __fish_command_not_found_handler = {\n body = \"__fish_default_command_not_found_handler \$argv[1]\";\n onEvent = \"fish_command_not_found\";\n };\n\n gitignore = \"curl -sL https://www.gitignore.io/api/\$argv\";\n}\n"; + } + +

Declared by:

<home-manager/modules/programs/fish.nix>
programs.fish.interactiveShellInit

Shell script code called during interactive fish shell initialisation. @@ -3021,30 +3069,13 @@ initialisation. ] -

Example:

[
-  {
-    name = "z";
-    src = pkgs.fetchFromGitHub {
-      owner = "jethrokuan";
-      repo = "z";
-      rev = "ddeb28a7b6a1f0ec6dae40c636e5ca4908ad160a";
-      sha256 = "0c5i7sdrsp0q3vbziqzdyqn4fmp235ax4mn4zslrswvn8g3fvdyh";
-    };
-  }
-
-  # oh-my-fish plugins are stored in their own repositories, which
-  # makes them simple to import into home-manager.
-  {
-    name = "fasd";
-    src = pkgs.fetchFromGitHub {
-      owner = "oh-my-fish";
-      repo = "plugin-fasd";
-      rev = "38a5b6b6011106092009549e52249c6d6f501fba";
-      sha256 = "06v37hqy5yrv5a6ssd1p3cjd9y3hnp19d3ab7dag56fs1qmgyhbs";
-    };
-  }
-]
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "[\n {\n name = \"z\";\n src = pkgs.fetchFromGitHub {\n owner = \"jethrokuan\";\n repo = \"z\";\n rev = \"ddeb28a7b6a1f0ec6dae40c636e5ca4908ad160a\";\n sha256 = \"0c5i7sdrsp0q3vbziqzdyqn4fmp235ax4mn4zslrswvn8g3fvdyh\";\n };\n }\n\n # oh-my-fish plugins are stored in their own repositories, which\n # makes them simple to import into home-manager.\n {\n name = \"fasd\";\n src = pkgs.fetchFromGitHub {\n owner = \"oh-my-fish\";\n repo = \"plugin-fasd\";\n rev = \"38a5b6b6011106092009549e52249c6d6f501fba\";\n sha256 = \"06v37hqy5yrv5a6ssd1p3cjd9y3hnp19d3ab7dag56fs1qmgyhbs\";\n };\n }\n]\n"; + } + +

Declared by:

<home-manager/modules/programs/fish.nix>
programs.fish.plugins.*.name

The name of the plugin.

Type: string

Declared by:

@@ -3087,11 +3118,13 @@ in this option) to command strings or directly to build outputs. } -

Example:

{
-  g = "git";
-  "..." = "cd ../..";
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n g = \"git\";\n \"...\" = \"cd ../..\";\n}\n"; + } + +

Declared by:

<home-manager/modules/programs/fish.nix>
programs.fish.shellInit

Shell script code called during fish shell initialisation. @@ -3106,7 +3139,11 @@ initialisation.

Declared by:

<home-manager/modules/programs/foot.nix>
programs.foot.package

The foot package to install

Type: package

Default: - pkgs.foot + + { + _type = "literalExpression"; text = "pkgs.foot"; + } +

Declared by:

<home-manager/modules/programs/foot.nix>
programs.foot.server.enable

Whether to enable Foot terminal server.

Type: boolean

Default: @@ -3124,19 +3161,13 @@ for a list of available options. } -

Example:

{
-  main = {
-    term = "xterm-256color";
-
-    font = "Fira Code:size=11";
-    dpi-aware = "yes";
-  };
-
-  mouse = {
-    hide-when-typing = "yes";
-  };
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n main = {\n term = \"xterm-256color\";\n\n font = \"Fira Code:size=11\";\n dpi-aware = \"yes\";\n };\n\n mouse = {\n hide-when-typing = \"yes\";\n };\n}\n"; + } + +

Declared by:

<home-manager/modules/programs/foot.nix>
programs.fzf.enable

Whether to enable fzf - a command-line fuzzy finder.

Type: boolean

Default: false @@ -3160,7 +3191,11 @@ for a list of available options.

Declared by:

<home-manager/modules/programs/fzf.nix>
programs.fzf.package

Package providing the fzf tool.

Type: package

Default: - pkgs.fzf + + { + _type = "literalExpression"; text = "pkgs.fzf"; + } +

Declared by:

<home-manager/modules/programs/fzf.nix>
programs.fzf.changeDirWidgetCommand

The command that gets executed as the source for fzf for the @@ -3263,7 +3298,13 @@ See fzf-tmux --help for available ] -

Example:

[ "-d 40%" ]

Declared by:

+

Example: + + { + _type = "literalExpression"; text = ''[ "-d 40%" ]''; + } + +

Declared by:

<home-manager/modules/programs/fzf.nix>
programs.gh.enable

Whether to enable GitHub CLI tool.

Type: boolean

Default: false @@ -3278,11 +3319,13 @@ See fzf-tmux --help for available } -

Example:

{
-  co = "pr checkout";
-  pv = "pr view";
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n co = \"pr checkout\";\n pv = \"pr view\";\n}\n"; + } + +

Declared by:

<home-manager/modules/programs/gh.nix>
programs.gh.editor

The editor that gh should run when creating issues, pull requests, etc. If blank, will refer to environment. @@ -3304,7 +3347,11 @@ If blank, will refer to environment.

programs.git.package

Git package to install. Use pkgs.gitAndTools.gitFull to gain access to git send-email for instance.

Type: package

Default: - pkgs.git + + { + _type = "literalExpression"; text = "pkgs.git"; + } +

Declared by:

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

Git aliases to define.

Type: attribute set of strings

Default: @@ -3410,14 +3457,13 @@ deprecated and will be removed in the future. ] -

Example:

[
-  { path = "~/path/to/config.inc"; }
-  {
-    path = "~/path/to/conditional.inc";
-    condition = "gitdir:~/src/dir";
-  }
-]
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "[\n { path = \"~/path/to/config.inc\"; }\n {\n path = \"~/path/to/conditional.inc\";\n condition = \"gitdir:~/src/dir\";\n }\n]\n"; + } + +

Declared by:

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

Include this configuration only when condition matches. Allowed conditions are described in @@ -3436,17 +3482,13 @@ This follows the configuration structure as described in } -

Example:

{
-  user = {
-    email = "bob@work.example.com";
-    name = "Bob Work";
-    signingKey = "1A2B3C4D5E6F7G8H";
-  };
-  commit = {
-    gpgSign = true;
-  };
-};
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n user = {\n email = \"bob@work.example.com\";\n name = \"Bob Work\";\n signingKey = \"1A2B3C4D5E6F7G8H\";\n };\n commit = {\n gpgSign = true;\n };\n};\n"; + } + +

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:

<home-manager/modules/programs/git.nix> @@ -3642,7 +3684,11 @@ presses the Delete key.

Declared by:

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

The Go package to use.

Type: package

Default: - pkgs.go + + { + _type = "literalExpression"; text = "pkgs.go"; + } +

Declared by:

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

Packages to add to GOPATH.

Type: attribute set of paths

Default: @@ -3651,11 +3697,13 @@ presses the Delete key. } -

Example:

{
-  "golang.org/x/text" = builtins.fetchGit "https://go.googlesource.com/text";
-  "golang.org/x/time" = builtins.fetchGit "https://go.googlesource.com/time";
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n \"golang.org/x/text\" = builtins.fetchGit \"https://go.googlesource.com/text\";\n \"golang.org/x/time\" = builtins.fetchGit \"https://go.googlesource.com/time\";\n}\n"; + } + +

Declared by:

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

Extra GOPATHs relative to HOME appended after @@ -3715,31 +3763,56 @@ or checksum database.

Declared by:

<home-manager/modules/programs/gpg.nix>
programs.gpg.package

The Gnupg package to use (also used the gpg-agent service).

Type: package

Default: - pkgs.gnupg -

Example:

pkgs.gnupg23

Declared by:

+ + { + _type = "literalExpression"; text = "pkgs.gnupg"; + } + +

Example: + + { + _type = "literalExpression"; text = "pkgs.gnupg23"; + } + +

Declared by:

<home-manager/modules/programs/gpg.nix>
programs.gpg.homedir

Directory to store keychains and configuration.

Type: path

Default: - "${config.home.homeDirectory}/.gnupg" -

Example:

"${config.xdg.dataHome}/gnupg"

Declared by:

+ + { + _type = "literalExpression"; text = ''"''${config.home.homeDirectory}/.gnupg"''; + } + +

Example: + + { + _type = "literalExpression"; text = ''"''${config.xdg.dataHome}/gnupg"''; + } + +

Declared by:

<home-manager/modules/programs/gpg.nix>
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 stringss

Example:

{
-  disable-ccid = true;
-}
-

Declared by:

+

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

Example: + + { + _type = "literalExpression"; text = "{\n disable-ccid = true;\n}\n"; + } + +

Declared by:

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

GnuPG configuration options. Available options are described 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 stringss

Example:

{
-  no-comments = false;
-  s2k-cipher-algo = "AES128";
-}
-

Declared by:

+

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

Example: + + { + _type = "literalExpression"; text = "{\n no-comments = false;\n s2k-cipher-algo = \"AES128\";\n}\n"; + } + +

Declared by:

<home-manager/modules/programs/gpg.nix>
programs.himalaya.enable

Whether to enable himalaya mail client.

Type: boolean

Default: false @@ -3749,7 +3822,11 @@ Note that lists are converted to duplicate keys. <home-manager/modules/programs/himalaya.nix>

programs.himalaya.package

Package providing the himalaya mail client.

Type: package

Default: - pkgs.himalaya + + { + _type = "literalExpression"; text = "pkgs.himalaya"; + } +

Declared by:

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

Global himalaya configuration values. @@ -3759,10 +3836,13 @@ Note that lists are converted to duplicate keys. } -

Example:

{
-  default-page-size = 50;
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n default-page-size = 50;\n}\n"; + } + +

Declared by:

<home-manager/modules/programs/himalaya.nix>
programs.home-manager.enable

Whether to enable Home Manager.

Type: boolean

Default: false @@ -3795,39 +3875,13 @@ attempted. } -

Example:

{
-  color_scheme = 6;
-  cpu_count_from_one = 0;
-  delay = 15;
-  fields = with config.lib.htop.fields; [
-    PID
-    USER
-    PRIORITY
-    NICE
-    M_SIZE
-    M_RESIDENT
-    M_SHARE
-    STATE
-    PERCENT_CPU
-    PERCENT_MEM
-    TIME
-    COMM
-  ];
-  highlight_base_name = 1;
-  highlight_megabytes = 1;
-  highlight_threads = 1;
-} // (with config.lib.htop; leftMeters [
-  (bar "AllCPUs2")
-  (bar "Memory")
-  (bar "Swap")
-  (text "Zram")
-]) // (with config.lib.htop; rightMeters [
-  (text "Tasks")
-  (text "LoadAverage")
-  (text "Uptime")
-  (text "Systemd")
-]);
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n color_scheme = 6;\n cpu_count_from_one = 0;\n delay = 15;\n fields = with config.lib.htop.fields; [\n PID\n USER\n PRIORITY\n NICE\n M_SIZE\n M_RESIDENT\n M_SHARE\n STATE\n PERCENT_CPU\n PERCENT_MEM\n TIME\n COMM\n ];\n highlight_base_name = 1;\n highlight_megabytes = 1;\n highlight_threads = 1;\n} // (with config.lib.htop; leftMeters [\n (bar \"AllCPUs2\")\n (bar \"Memory\")\n (bar \"Swap\")\n (text \"Zram\")\n]) // (with config.lib.htop; rightMeters [\n (text \"Tasks\")\n (text \"LoadAverage\")\n (text \"Uptime\")\n (text \"Systemd\")\n]);\n"; + } + +

Declared by:

<home-manager/modules/programs/htop.nix>
programs.i3status.enable

Whether to enable i3status.

Type: boolean

Default: false @@ -3852,14 +3906,13 @@ for options. } -

Example:

{
-  colors = true;
-  color_good = "#e0e0e0";
-  color_degraded = "#d7ae00";
-  color_bad = "#f69d6a";
-  interval = 1;
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n colors = true;\n color_good = \"#e0e0e0\";\n color_degraded = \"#d7ae00\";\n color_bad = \"#f69d6a\";\n interval = 1;\n}\n"; + } + +

Declared by:

<home-manager/modules/programs/i3status.nix>
programs.i3status.modules

Modules to add to i3status config file. See @@ -3871,23 +3924,13 @@ for options. } -

Example:

{
-  "volume master" = {
-    position = 1;
-    settings = {
-      format = "♪ %volume";
-      format_muted = "♪ muted (%volume)";
-      device = "pulse:1";
-    };
-  };
-  "disk /" = {
-    position = 2;
-    settings = {
-      format = "/ %avail";
-    };
-  };
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n \"volume master\" = {\n position = 1;\n settings = {\n format = \"♪ %volume\";\n format_muted = \"♪ muted (%volume)\";\n device = \"pulse:1\";\n };\n };\n \"disk /\" = {\n position = 2;\n settings = {\n format = \"/ %avail\";\n };\n };\n}\n"; + } + +

Declared by:

<home-manager/modules/programs/i3status.nix>
programs.i3status.modules.<name>.enable

Whether or not to enable this module.

Type: boolean

Default: @@ -3907,12 +3950,13 @@ for options. } -

Example:

{
-  format = "♪ %volume";
-  format_muted = "♪ muted (%volume)";
-  device = "pulse:1";
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n format = \"♪ %volume\";\n format_muted = \"♪ muted (%volume)\";\n device = \"pulse:1\";\n}\n"; + } + +

Declared by:

<home-manager/modules/programs/i3status.nix>
programs.i3status-rust.enable

Whether to enable a replacement for i3-status written in Rust.

Type: boolean

Default: false @@ -3921,7 +3965,11 @@ for options.

Declared by:

<home-manager/modules/programs/i3status-rust.nix>
programs.i3status-rust.package

Package providing i3status-rust

Type: package

Default: - pkgs.i3status-rust + + { + _type = "literalExpression"; text = "pkgs.i3status-rust"; + } +

Declared by:

<home-manager/modules/programs/i3status-rust.nix>
programs.i3status-rust.bars

Attribute set of i3status-rust bars, each with their own configuration. @@ -3973,53 +4021,13 @@ for options. ; } -

Example:

bottom = {
-  blocks = [
-    {
-       block = "disk_space";
-       path = "/";
-       alias = "/";
-       info_type = "available";
-       unit = "GB";
-       interval = 60;
-       warning = 20.0;
-       alert = 10.0;
-     }
-     {
-       block = "memory";
-       display_type = "memory";
-       format_mem = "{mem_used_percents}";
-       format_swap = "{swap_used_percents}";
-     }
-     {
-       block = "cpu";
-       interval = 1;
-     }
-     {
-       block = "load";
-       interval = 1;
-       format = "{1m}";
-     }
-     { block = "sound"; }
-     {
-       block = "time";
-       interval = 60;
-       format = "%a %d/%m %R";
-     }
-  ];
-  settings = {
-    theme =  {
-      name = "solarized-dark";
-      overrides = {
-        idle_bg = "#123456";
-        idle_fg = "#abcdef";
-      };
-    };
-  };
-  icons = "awesome5";
-  theme = "gruvbox-dark";
-};
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "bottom = {\n blocks = [\n {\n block = \"disk_space\";\n path = \"/\";\n alias = \"/\";\n info_type = \"available\";\n unit = \"GB\";\n interval = 60;\n warning = 20.0;\n alert = 10.0;\n }\n {\n block = \"memory\";\n display_type = \"memory\";\n format_mem = \"{mem_used_percents}\";\n format_swap = \"{swap_used_percents}\";\n }\n {\n block = \"cpu\";\n interval = 1;\n }\n {\n block = \"load\";\n interval = 1;\n format = \"{1m}\";\n }\n { block = \"sound\"; }\n {\n block = \"time\";\n interval = 60;\n format = \"%a %d/%m %R\";\n }\n ];\n settings = {\n theme = {\n name = \"solarized-dark\";\n overrides = {\n idle_bg = \"#123456\";\n idle_fg = \"#abcdef\";\n };\n };\n };\n icons = \"awesome5\";\n theme = \"gruvbox-dark\";\n};\n"; + } + +

Declared by:

<home-manager/modules/programs/i3status-rust.nix>
programs.i3status-rust.bars.<name>.blocks

Configuration blocks to add to i3status-rust config. See @@ -4055,28 +4063,13 @@ for block options. ] -

Example:

[
-  {
-    block = "disk_space";
-    path = "/";
-    alias = "/";
-    info_type = "available";
-    unit = "GB";
-    interval = 60;
-    warning = 20.0;
-    alert = 10.0;
-  }
-  {
-    block = "sound";
-    format = "{output_name} {volume}%";
-    on_click = "pavucontrol --tab=3";
-    mappings = {
-     "alsa_output.pci-0000_00_1f.3.analog-stereo" = "";
-     "bluez_sink.70_26_05_DA_27_A4.a2dp_sink" = "";
-    };
-  }
-];
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "[\n {\n block = \"disk_space\";\n path = \"/\";\n alias = \"/\";\n info_type = \"available\";\n unit = \"GB\";\n interval = 60;\n warning = 20.0;\n alert = 10.0;\n }\n {\n block = \"sound\";\n format = \"{output_name} {volume}%\";\n on_click = \"pavucontrol --tab=3\";\n mappings = {\n \"alsa_output.pci-0000_00_1f.3.analog-stereo\" = \"\";\n \"bluez_sink.70_26_05_DA_27_A4.a2dp_sink\" = \"\";\n };\n }\n];\n"; + } + +

Declared by:

<home-manager/modules/programs/i3status-rust.nix>
programs.i3status-rust.bars.<name>.icons

The icons set to use. See https://github.com/greshake/i3status-rust/blob/master/themes.md @@ -4095,16 +4088,13 @@ for a list of available icon sets. } -

Example:

{
-  theme =  {
-    name = "solarized-dark";
-    overrides = {
-      idle_bg = "#123456";
-      idle_fg = "#abcdef";
-    };
-  };
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n theme = {\n name = \"solarized-dark\";\n overrides = {\n idle_bg = \"#123456\";\n idle_fg = \"#abcdef\";\n };\n };\n}\n"; + } + +

Declared by:

<home-manager/modules/programs/i3status-rust.nix>
programs.i3status-rust.bars.<name>.theme

The theme to use. See https://github.com/greshake/i3status-rust/blob/master/themes.md @@ -4151,20 +4141,13 @@ for a list of available themes. } -

Example:

{
-  freenode = {
-    nick = "hmuser";
-    server = {
-      address = "chat.freenode.net";
-      port = 6697;
-      autoConnect = true;
-    };
-    channels = {
-      nixos.autoJoin = true;
-    };
-  };
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n freenode = {\n nick = \"hmuser\";\n server = {\n address = \"chat.freenode.net\";\n port = 6697;\n autoConnect = true;\n };\n channels = {\n nixos.autoJoin = true;\n };\n };\n}\n"; + } + +

Declared by:

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

List of commands to execute on connect.

Type: list of strings

Default: @@ -4237,7 +4220,11 @@ variable.

Declared by:

<home-manager/modules/programs/jq.nix>
programs.jq.package

jq package to use.

Type: package

Default: - pkgs.jq + + { + _type = "literalExpression"; text = "pkgs.jq"; + } +

Declared by:

<home-manager/modules/programs/jq.nix>
programs.jq.colors

The colors used in colored JSON output.

See https://stedolan.github.io/jq/manual/#Colors. @@ -4247,16 +4234,13 @@ variable. arrays = "1;37"; false = "0;37"; null = "1;30"; numbers = "0;37"; objects = "1;37"; strings = "0;32"; true = "0;37"; } -

Example:

{
-  null    = "1;30";
-  false   = "0;31";
-  true    = "0;32";
-  numbers = "0;36";
-  strings = "0;33";
-  arrays  = "1;35";
-  objects = "1;37";
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n null = \"1;30\";\n false = \"0;31\";\n true = \"0;32\";\n numbers = \"0;36\";\n strings = \"0;33\";\n arrays = \"1;35\";\n objects = \"1;37\";\n}\n"; + } + +

Declared by:

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

Whether to enable the kakoune text editor.

Type: boolean

Default: false @@ -4590,7 +4574,13 @@ supported plugins run: ] -

Example:

[ pkgs.kakounePlugins.kak-fzf ]

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "[ pkgs.kakounePlugins.kak-fzf ]"; + } + +

Declared by:

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

Whether to enable keychain.

Type: boolean

Default: false @@ -4620,7 +4610,11 @@ supported plugins run: <home-manager/modules/programs/keychain.nix>

programs.keychain.package

Keychain package to install.

Type: package

Default: - pkgs.keychain + + { + _type = "literalExpression"; text = "pkgs.keychain"; + } +

Declared by:

<home-manager/modules/programs/keychain.nix>
programs.keychain.agents

Agents to add. @@ -4663,12 +4657,13 @@ supported plugins run: <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 strings

Default: null -

Example:

[
-  "--single-instance"
-  "--directory=/tmp/my-dir"
-  "--listen-on=unix:/tmp/my-socket"
-]
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "[\n \"--single-instance\"\n \"--directory=/tmp/my-dir\"\n \"--listen-on=unix:/tmp/my-socket\"\n]\n"; + } + +

Declared by:

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

Environment variables to set or override.

Type: attribute set of strings

Default: @@ -4676,10 +4671,13 @@ supported plugins run: } -

Example:

{
-  "LS_COLORS" = "1";
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n \"LS_COLORS\" = \"1\";\n}\n"; + } + +

Declared by:

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

Additional configuration to add.

Type: strings concatenated with "\n"

Default: "" @@ -4694,7 +4692,13 @@ to your profile. If null then the font is assumed to already be available in your profile.

Type: null or package

Default: null -

Example:

pkgs.dejavu_fonts

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "pkgs.dejavu_fonts"; + } + +

Declared by:

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

The family name of the font within the package.

Type: string

Example: @@ -4714,11 +4718,13 @@ is assumed to already be available in your profile. } -

Example:

{
-  "ctrl+c" = "copy_or_interrupt";
-  "ctrl+f>2" = "set_font_size 20";
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n \"ctrl+c\" = \"copy_or_interrupt\";\n \"ctrl+f>2\" = \"set_font_size 20\";\n}\n"; + } + +

Declared by:

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

Configuration written to ~/.config/kitty/kitty.conf. See @@ -4730,12 +4736,13 @@ for the documentation. } -

Example:

{
-  scrollback_lines = 10000;
-  enable_audio_bell = false;
-  update_check_interval = 0;
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n scrollback_lines = 10000;\n enable_audio_bell = false;\n update_check_interval = 0;\n}\n"; + } + +

Declared by:

<home-manager/modules/programs/kitty.nix>
programs.lazygit.enable

Whether to enable lazygit, a simple terminal UI for git commands.

Type: boolean

Default: false @@ -4749,16 +4756,18 @@ or ~/Library/Application Support/lazygit/config.ymlhttps://github.com/jesseduffield/lazygit/blob/master/docs/Config.md for supported values.

Type: YAML value

Default: - { } -

Example:

{
-  gui.theme = {
-    lightTheme = true;
-    activeBorderColor = [ "blue" "bold" ];
-    inactiveBorderColor = [ "black" ];
-    selectedLineBgColor = [ "default" ];
-  };
-}
-

Declared by:

+ + { + _type = "literalExpression"; text = "{ }"; + } + +

Example: + + { + _type = "literalExpression"; text = "{\n gui.theme = {\n lightTheme = true;\n activeBorderColor = [ \"blue\" \"bold\" ];\n inactiveBorderColor = [ \"black\" ];\n selectedLineBgColor = [ \"default\" ];\n };\n}\n"; + } + +

Declared by:

<home-manager/modules/programs/lazygit.nix>
programs.lesspipe.enable

Whether to enable lesspipe preprocessor for less.

Type: boolean

Default: false @@ -4780,7 +4789,13 @@ builtin commands. Keys set to null or an empty string are deleted. } -

Example:

{ "<c-g>" = "cmd-escape"; }

Declared by:

+

Example: + + { + _type = "literalExpression"; text = ''{ "<c-g>" = "cmd-escape"; }''; + } + +

Declared by:

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

Commands to declare. Commands set to null or an empty string are deleted. @@ -4830,19 +4845,13 @@ pipe through less. Setting to null will not bind any key. previewer option.

Type: null or path

Default: null -

Example:

pkgs.writeShellScript "pv.sh" ''
-  #!/bin/sh
-
-  case "$1" in
-      *.tar*) tar tf "$1";;
-      *.zip) unzip -l "$1";;
-      *.rar) unrar l "$1";;
-      *.7z) 7z l "$1";;
-      *.pdf) pdftotext "$1" -;;
-      *) highlight -O ansi "$1" || cat "$1";;
-  esac
-''
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "pkgs.writeShellScript \"pv.sh\" ''\n #!/bin/sh\n\n case \"\$1\" in\n *.tar*) tar tf \"\$1\";;\n *.zip) unzip -l \"\$1\";;\n *.rar) unrar l \"\$1\";;\n *.7z) 7z l \"\$1\";;\n *.pdf) pdftotext \"\$1\" -;;\n *) highlight -O ansi \"\$1\" || cat \"\$1\";;\n esac\n''\n"; + } + +

Declared by:

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

An attribute set of lf settings. The attribute names and corresponding values must be among the following supported options. @@ -4962,9 +4971,13 @@ timeout, set it to zero. <home-manager/modules/services/mako.nix>

programs.mako.extraConfig

Additional configuration.

Type: strings concatenated with "\n"

Default: "" -

Example:

[urgency=low]
-border-color=#b8bb26
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "[urgency=low]\nborder-color=#b8bb26\n"; + } + +

Declared by:

<home-manager/modules/services/mako.nix>
programs.mako.font

Font to use, in Pango format.

Type: null or string

Default: @@ -5128,7 +5141,11 @@ MangoHud is started on any application that supports it.

Declared by:

<home-manager/modules/programs/mangohud.nix>
programs.mangohud.package

The Mangohud package to install.

Type: package

Default: - pkgs.mangohud + + { + _type = "literalExpression"; text = "pkgs.mangohud"; + } +

Declared by:

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

Configuration written to @@ -5141,11 +5158,13 @@ for the default configuration. } -

Example:

{
-  output_folder = ~/Documents/mangohud/;
-  full = true;
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n output_folder = ~/Documents/mangohud/;\n full = true;\n}\n"; + } + +

Declared by:

<home-manager/modules/programs/mangohud.nix>
programs.mangohud.settingsPerApplication

Sets MangoHud settings per application. Configuration written to @@ -5158,12 +5177,13 @@ for the default configuration. } -

Example:

{
-  mpv = {
-    no_display = true;
-  }
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n mpv = {\n no_display = true;\n }\n}\n"; + } + +

Declared by:

<home-manager/modules/programs/mangohud.nix>
programs.matplotlib.enable

Whether to enable matplotlib, a plotting library for python.

Type: boolean

Default: false @@ -5179,16 +5199,13 @@ control the default matplotlib behavior. } -

Example:

{
-  backend = "Qt5Agg";
-  axes = {
-    grid = true;
-    facecolor = "black";
-    edgecolor = "FF9900";
-  };
-  grid.color = "FF9900";
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n backend = \"Qt5Agg\";\n axes = {\n grid = true;\n facecolor = \"black\";\n edgecolor = \"FF9900\";\n };\n grid.color = \"FF9900\";\n}\n"; + } + +

Declared by:

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

Additional commands for matplotlib that will be added to the matplotlibrc file. @@ -5203,8 +5220,18 @@ control the default matplotlib behavior.

Declared by:

<home-manager/modules/programs/mbsync.nix>
programs.mbsync.package

The package to use for the mbsync binary.

Type: package

Default: - pkgs.isync -

Example:

pkgs.isync

Declared by:

+ + { + _type = "literalExpression"; text = "pkgs.isync"; + } + +

Example: + + { + _type = "literalExpression"; text = "pkgs.isync"; + } + +

Declared by:

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

Extra configuration lines to add to the mbsync configuration.

Type: strings concatenated with "\n"

Default: @@ -5218,13 +5245,13 @@ control the default matplotlib behavior. } -

Example:

{
-  inboxes = {
-    account1 = [ "Inbox" ];
-    account2 = [ "Inbox" ];
-  };
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n inboxes = {\n account1 = [ \"Inbox\" ];\n account2 = [ \"Inbox\" ];\n };\n}\n"; + } + +

Declared by:

<home-manager/modules/programs/mbsync.nix>
programs.mcfly.enable

Whether to enable mcfly.

Type: boolean

Default: false @@ -5269,7 +5296,11 @@ control the default matplotlib behavior.

Declared by:

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

Mercurial package to install.

Type: package

Default: - pkgs.mercurial + + { + _type = "literalExpression"; text = "pkgs.mercurial"; + } +

Declared by:

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

Mercurial aliases to define.

Type: attribute set of anythings

Default: @@ -5329,7 +5360,13 @@ control the default matplotlib behavior.

programs.mpv.package

Package providing mpv.

Type: package

Default: (build of mpv-with-scripts-0.33.1) -

Example:

pkgs.wrapMpv (pkgs.mpv-unwrapped.override { vapoursynthSupport = true; }) { youtubeSupport = true; }

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "pkgs.wrapMpv (pkgs.mpv-unwrapped.override { vapoursynthSupport = true; }) { youtubeSupport = true; }"; + } + +

Declared by:

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

Input configuration written to ~/.config/mpv/input.conf. See @@ -5341,12 +5378,13 @@ for the full list of options. } -

Example:

{
-  WHEEL_UP = "seek 10";
-  WHEEL_DOWN = "seek -10";
-  "Alt+0" = "set window-scale 0.5";
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n WHEEL_UP = \"seek 10\";\n WHEEL_DOWN = \"seek -10\";\n \"Alt+0\" = \"set window-scale 0.5\";\n}\n"; + } + +

Declared by:

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

Configuration written to ~/.config/mpv/mpv.conf. See @@ -5358,13 +5396,13 @@ for the full list of options. } -

Example:

{
-  profile = "gpu-hq";
-  force-window = true;
-  ytdl-format = "bestvideo+bestaudio";
-  cache-default = 4000000;
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n profile = \"gpu-hq\";\n force-window = true;\n ytdl-format = \"bestvideo+bestaudio\";\n cache-default = 4000000;\n}\n"; + } + +

Declared by:

<home-manager/modules/programs/mpv.nix>
programs.mpv.defaultProfiles

Profiles to be applied by default. Options set by them are overridden by options set in programs.mpv.config. @@ -5391,16 +5429,13 @@ by options set in

Example:

{
-  fast = {
-    vo = "vdpau";
-  };
-  "protocol.dvd" = {
-    profile-desc = "profile for dvd:// streams";
-    alang = "en";
-  };
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n fast = {\n vo = \"vdpau\";\n };\n \"protocol.dvd\" = {\n profile-desc = \"profile for dvd:// streams\";\n alang = \"en\";\n };\n}\n"; + } + +

Declared by:

<home-manager/modules/programs/mpv.nix>
programs.mpv.scripts

List of scripts to use with mpv.

Type: list of package or strings

Default: @@ -5409,7 +5444,13 @@ by options set in

Example:

[ pkgs.mpvScripts.mpris ]

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "[ pkgs.mpvScripts.mpris ]"; + } + +

Declared by:

<home-manager/modules/programs/mpv.nix>
programs.msmtp.enable

Whether to enable msmtp.

Type: boolean

Default: false @@ -5448,8 +5489,18 @@ Account commands should be placed in <home-manager/modules/programs/ncmpcpp.nix>

programs.ncmpcpp.package

Package providing the ncmpcpp command.

Type: package

Default: - pkgs.ncmpcpp -

Example:

pkgs.ncmpcpp.override { visualizerSupport = true; }

Declared by:

+ + { + _type = "literalExpression"; text = "pkgs.ncmpcpp"; + } + +

Example: + + { + _type = "literalExpression"; text = "pkgs.ncmpcpp.override { visualizerSupport = true; }"; + } + +

Declared by:

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

List of keybindings.

Type: list of submodules

Default: @@ -5457,13 +5508,13 @@ Account commands should be placed in ] -

Example:

[
-  { key = "j"; command = "scroll_down"; }
-  { key = "k"; command = "scroll_up"; }
-  { key = "J"; command = [ "select_item" "scroll_down" ]; }
-  { key = "K"; command = [ "select_item" "scroll_up" ]; }
-]
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "[\n { key = \"j\"; command = \"scroll_down\"; }\n { key = \"k\"; command = \"scroll_up\"; }\n { key = \"J\"; command = [ \"select_item\" \"scroll_down\" ]; }\n { key = \"K\"; command = [ \"select_item\" \"scroll_up\" ]; }\n]\n"; + } + +

Declared by:

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

Command or sequence of commands to be executed.

Type: string or list of strings

Example: "scroll_down" @@ -5478,11 +5529,11 @@ 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 - config.services.mpd.musicDirectory -else - null - + + { + _type = "literalExpression"; text = "if pkgs.stdenv.hostPlatform.isLinux && config.services.mpd.enable then\n config.services.mpd.musicDirectory\nelse\n null\n"; + } +

Example: "~/music"

Declared by:

@@ -5511,7 +5562,11 @@ see

Declared by:

<home-manager/modules/programs/ncspot.nix>
programs.ncspot.package

The package to use for ncspot.

Type: package

Default: - pkgs.ncspot + + { + _type = "literalExpression"; text = "pkgs.ncspot"; + } +

Declared by:

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

Configuration written to @@ -5525,11 +5580,13 @@ for the full list of options. } -

Example:

{
-  shuffle = true;
-  gapless = true;
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n shuffle = true;\n gapless = true;\n}\n"; + } + +

Declared by:

<home-manager/modules/programs/ncspot.nix>
programs.ne.enable

Whether to enable ne.

Type: boolean

Default: false @@ -5544,16 +5601,13 @@ for the full list of options. } -

Example:

{
-  nix = ''
-    TAB 0
-    TS 2
-  '';
-  js = ''
-    TS 4
-  '';
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n nix = ''\n TAB 0\n TS 2\n '';\n js = ''\n TS 4\n '';\n}\n"; + } + +

Declared by:

<home-manager/modules/programs/ne.nix>
programs.ne.defaultPreferences

Default preferences for ne.

@@ -5588,7 +5642,11 @@ csh 1 ^#!\s*/.*\b(csh|tcsh)\s*

Declared by:

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

The neomutt package to use.

Type: package

Default: - pkgs.neomutt + + { + _type = "literalExpression"; text = "pkgs.neomutt"; + } +

Declared by:

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

List of keybindings.

Type: list of submodules

Default: @@ -5703,7 +5761,11 @@ with this enabled only the relative name is shown.

Declared by:

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

The package to use for the neovim binary.

Type: package

Default: - pkgs.neovim-unwrapped + + { + _type = "literalExpression"; text = "pkgs.neovim-unwrapped"; + } +

Declared by:

<home-manager/modules/programs/neovim.nix>
programs.neovim.coc.enable

Whether to enable Coc.

Type: boolean

Default: @@ -5723,27 +5785,13 @@ for options. } -

Example:

{
-  "suggest.noselect" = true;
-  "suggest.enablePreview" = true;
-  "suggest.enablePreselect" = false;
-  "suggest.disableKind" = true;
-  languageserver = {
-    haskell = {
-      command = "haskell-language-server-wrapper";
-      args = [ "--lsp" ];
-      rootPatterns = [
-        "*.cabal"
-        "stack.yaml"
-        "cabal.project"
-        "package.yaml"
-        "hie.yaml"
-      ];
-      filetypes = [ "haskell" "lhaskell" ];
-    };
-  };
-};
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n \"suggest.noselect\" = true;\n \"suggest.enablePreview\" = true;\n \"suggest.enablePreselect\" = false;\n \"suggest.disableKind\" = true;\n languageserver = {\n haskell = {\n command = \"haskell-language-server-wrapper\";\n args = [ \"--lsp\" ];\n rootPatterns = [\n \"*.cabal\"\n \"stack.yaml\"\n \"cabal.project\"\n \"package.yaml\"\n \"hie.yaml\"\n ];\n filetypes = [ \"haskell\" \"lhaskell\" ];\n };\n };\n};\n"; + } + +

Declared by:

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

Deprecated. Please use the other options. @@ -5760,18 +5808,13 @@ and plugins. } -

Example:

configure = {
-    customRC = $'''
-    " here your custom configuration goes!
-    $''';
-    packages.myVimPackage = with pkgs.vimPlugins; {
-      # loaded on launch
-      start = [ fugitive ];
-      # manually loadable by calling `:packadd $plugin-name`
-      opt = [ ];
-    };
-  };
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "configure = {\n customRC = \$'''\n \" here your custom configuration goes!\n \$''';\n packages.myVimPackage = with pkgs.vimPlugins; {\n # loaded on launch\n start = [ fugitive ];\n # manually loadable by calling `:packadd \$plugin-name`\n opt = [ ];\n };\n };\n"; + } + +

Declared by:

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

Custom vimrc lines. @@ -5799,7 +5842,13 @@ set nobackup list of Python 3 packages required for your plugins to work.

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

Default: "ps: []" -

Example:

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

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "(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:

@@ -5816,14 +5865,13 @@ This option is mutually exclusive with configure. ] -

Example:

with pkgs.vimPlugins; [
-  yankring
-  vim-nix
-  { plugin = vim-startify;
-    config = "let g:startify_change_to_vcs_root = 0";
-  }
-]
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "with pkgs.vimPlugins; [\n yankring\n vim-nix\n { plugin = vim-startify;\n config = \"let g:startify_change_to_vcs_root = 0\";\n }\n]\n"; + } + +

Declared by:

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

Symlink vi to nvim binary.

Type: boolean

Default: @@ -5974,7 +6022,11 @@ use Python 3 plugins.

Declared by:

<home-manager/modules/programs/nix-index.nix>
programs.nix-index.package

Package providing the nix-index tool.

Type: package

Default: - pkgs.nix-index + + { + _type = "literalExpression"; text = "pkgs.nix-index"; + } +

Declared by:

<home-manager/modules/programs/nix-index.nix>
programs.nnn.enable

Whether to enable nnn.

Type: boolean

Default: @@ -5985,8 +6037,18 @@ use Python 3 plugins. <home-manager/modules/programs/nnn.nix>

programs.nnn.package

Package containing the nnn program.

Type: package

Default: - pkgs.nnn -

Example:

pkgs.nnn.override ({ withNerdIcons = true; });

Declared by:

+ + { + _type = "literalExpression"; text = "pkgs.nnn"; + } + +

Example: + + { + _type = "literalExpression"; text = "pkgs.nnn.override ({ withNerdIcons = true; });"; + } + +

Declared by:

<home-manager/modules/programs/nnn.nix>
programs.nnn.bookmarks

Directory bookmarks.

Type: attribute set of strings

Default: @@ -5995,13 +6057,13 @@ use Python 3 plugins. } -

Example:

{
-  d = "~/Documents";
-  D = "~/Downloads";
-  p = "~/Pictures";
-  v = "~/Videos";
-};
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n d = \"~/Documents\";\n D = \"~/Downloads\";\n p = \"~/Pictures\";\n v = \"~/Videos\";\n};\n"; + } + +

Declared by:

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

Extra packages available to nnn.

Type: list of packages

Default: @@ -6010,7 +6072,13 @@ use Python 3 plugins. ] -

Example:

with pkgs; [ ffmpegthumbnailer mediainfo sxiv ]

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "with pkgs; [ ffmpegthumbnailer mediainfo sxiv ]"; + } + +

Declared by:

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

Manage nnn plugins.

Type: submodule

Default: @@ -6028,23 +6096,24 @@ use Python 3 plugins. } -

Example:

{
-  c = "fzcd";
-  f = "finder";
-  v = "imgview";
-};
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n c = \"fzcd\";\n f = \"finder\";\n v = \"imgview\";\n};\n"; + } + +

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 {
-  owner = "jarun";
-  repo = "nnn";
-  rev = "v4.0";
-  sha256 = "sha256-Hpc8YaJeAzJoEi7aJ6DntH2VLkoR6ToP6tPYn3llR7k=";
-}) + "/plugins";
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "(pkgs.fetchFromGitHub {\n owner = \"jarun\";\n repo = \"nnn\";\n rev = \"v4.0\";\n sha256 = \"sha256-Hpc8YaJeAzJoEi7aJ6DntH2VLkoR6ToP6tPYn3llR7k=\";\n}) + \"/plugins\";\n"; + } + +

Declared by:

<home-manager/modules/programs/nnn.nix>
programs.noti.enable

Whether to enable Noti.

Type: boolean

Default: false @@ -6064,16 +6133,13 @@ for the full list of options. } -

Example:

{
-  say = {
-    voice = "Alex";
-  };
-  slack = {
-    token = "1234567890abcdefg";
-    channel = "@jaime";
-  };
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n say = {\n voice = \"Alex\";\n };\n slack = {\n token = \"1234567890abcdefg\";\n channel = \"@jaime\";\n };\n}\n"; + } + +

Declared by:

<home-manager/modules/programs/noti.nix>
programs.notmuch.enable

Whether to enable Notmuch mail indexer.

Type: boolean

Default: false @@ -6177,7 +6243,11 @@ exclusion.

Declared by:

<home-manager/modules/programs/nushell.nix>
programs.nushell.package

The package to use for nushell.

Type: package

Default: - pkgs.nushell + + { + _type = "literalExpression"; text = "pkgs.nushell"; + } +

Declared by:

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

Configuration written to @@ -6191,14 +6261,13 @@ of options. } -

Example:

{
-  edit_mode = "vi";
-  startup = [ "alias la [] { ls -a }" "alias e [msg] { echo $msg }" ];
-  key_timeout = 10;
-  completion_mode = "circular";
-  no_auto_pivot = true;
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n edit_mode = \"vi\";\n startup = [ \"alias la [] { ls -a }\" \"alias e [msg] { echo \$msg }\" ];\n key_timeout = 10;\n completion_mode = \"circular\";\n no_auto_pivot = true;\n}\n"; + } + +

Declared by:

<home-manager/modules/programs/nushell.nix>
programs.obs-studio.enable

Whether to enable obs-studio.

Type: boolean

Default: false @@ -6208,7 +6277,11 @@ of options. <home-manager/modules/programs/obs-studio.nix>

programs.obs-studio.package

OBS Studio package to install.

Type: package

Default: - pkgs.obs-studio + + { + _type = "literalExpression"; text = "pkgs.obs-studio"; + } +

Declared by:

<home-manager/modules/programs/obs-studio.nix>
programs.obs-studio.plugins

Optional OBS plugins.

Type: list of packages

Default: @@ -6217,7 +6290,13 @@ of options. ] -

Example:

[ pkgs.obs-studio-plugins.wlrobs ]

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "[ pkgs.obs-studio-plugins.wlrobs ]"; + } + +

Declared by:

<home-manager/modules/programs/obs-studio.nix>
programs.octant.enable

Whether to enable octant.

Type: boolean

Default: false @@ -6226,8 +6305,18 @@ of options.

Declared by:

<home-manager/modules/programs/octant.nix>
programs.octant.package

The Octant package to use.

Type: package

Default: - pkgs.octant -

Example:

pkgs.octant-other

Declared by:

+ + { + _type = "literalExpression"; text = "pkgs.octant"; + } + +

Example: + + { + _type = "literalExpression"; text = "pkgs.octant-other"; + } + +

Declared by:

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

Optional Octant plugins.

Type: list of packages

Default: @@ -6235,7 +6324,13 @@ of options. ] -

Example:

[ pkgs.starboard-octant-plugin ]

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "[ pkgs.starboard-octant-plugin ]"; + } + +

Declared by:

<home-manager/modules/programs/octant.nix>
programs.offlineimap.enable

Whether to enable OfflineIMAP.

Type: boolean

Default: false @@ -6283,14 +6378,13 @@ of options. } -

Example:

{
-  filename = "~/.config/mutt/mailboxes";
-  header = "'mailboxes '";
-  peritem = "'+%(accountname)s/%(foldername)s'";
-  sep = "' '";
-  footer = "'\\n'";
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n filename = \"~/.config/mutt/mailboxes\";\n header = \"'mailboxes '\";\n peritem = \"'+%(accountname)s/%(foldername)s'\";\n sep = \"' '\";\n footer = \"'\\\\n'\";\n}\n"; + } + +

Declared by:

<home-manager/modules/programs/offlineimap.nix>
programs.offlineimap.pythonFile

Python code that can then be used in other parts of the configuration. @@ -6318,7 +6412,11 @@ def get_pass(service, cmd):

Declared by:

<home-manager/modules/programs/opam.nix>
programs.opam.package

Opam package to install.

Type: package

Default: - pkgs.opam + + { + _type = "literalExpression"; text = "pkgs.opam"; + } +

Declared by:

<home-manager/modules/programs/opam.nix>
programs.password-store.enable

Whether to enable Password store.

Type: boolean

Default: @@ -6330,9 +6428,18 @@ def get_pass(service, cmd):

programs.password-store.package

The pass package to use. Can be used to specify extensions.

Type: package

Default: - pkgs.pass -

Example:

pkgs.pass.withExtensions (exts: [ exts.pass-otp ])
-

Declared by:

+ + { + _type = "literalExpression"; text = "pkgs.pass"; + } + +

Example: + + { + _type = "literalExpression"; text = "pkgs.pass.withExtensions (exts: [ exts.pass-otp ])\n"; + } + +

Declared by:

<home-manager/modules/programs/password-store.nix>
programs.password-store.settings

The pass environment variables dictionary.

@@ -6341,14 +6448,18 @@ See the "Environment variables" section of and the extension man pages for more information about the available keys.

Type: attribute set of strings

Default: - { PASSWORD_STORE_DIR = "$XDG_DATA_HOME/password-store"; } - -

Example:

{
-  PASSWORD_STORE_DIR = "/some/directory";
-  PASSWORD_STORE_KEY = "12345678";
-  PASSWORD_STORE_CLIP_TIME = "60";
-}
-

Declared by:

+ + { + _type = "literalExpression"; text = "{ PASSWORD_STORE_DIR = \"\$XDG_DATA_HOME/password-store\"; }\n"; + } + +

Example: + + { + _type = "literalExpression"; text = "{\n PASSWORD_STORE_DIR = \"/some/directory\";\n PASSWORD_STORE_KEY = \"12345678\";\n PASSWORD_STORE_CLIP_TIME = \"60\";\n}\n"; + } + +

Declared by:

<home-manager/modules/programs/password-store.nix>
programs.pazi.enable

Whether to enable pazi.

Type: boolean

Default: false @@ -6379,7 +6490,11 @@ available keys. <home-manager/modules/programs/pet.nix>

programs.pet.selectcmdPackage

The package needed for the settings.selectcmd.

Type: package

Default: - pkgs.fzf + + { + _type = "literalExpression"; text = "pkgs.fzf"; + } +

Declared by:

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

Settings written to config.toml. See the pet @@ -6429,7 +6544,13 @@ documentation for details. ] -

Example:

["git" "nixpkgs"]

Declared by:

+

Example: + + { + _type = "literalExpression"; text = ''["git" "nixpkgs"]''; + } + +

Declared by:

<home-manager/modules/programs/pet.nix>
programs.pidgin.enable

Whether to enable Pidgin messaging client.

Type: boolean

Default: false @@ -6438,7 +6559,11 @@ documentation for details.

Declared by:

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

The Pidgin package to use.

Type: package

Default: - pkgs.pidgin + + { + _type = "literalExpression"; text = "pkgs.pidgin"; + } +

Declared by:

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

Plugins that should be available to Pidgin.

Type: unspecified

Default: @@ -6447,7 +6572,13 @@ documentation for details. ] -

Example:

[ pkgs.pidgin-otr pkgs.pidgin-osd ]

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "[ pkgs.pidgin-otr pkgs.pidgin-osd ]"; + } + +

Declared by:

<home-manager/modules/programs/pidgin.nix>
programs.piston-cli.enable

Whether to enable piston-cli, code runner.

Type: boolean

Default: false @@ -6456,7 +6587,11 @@ documentation for details.

Declared by:

<home-manager/modules/programs/piston-cli.nix>
programs.piston-cli.package

The piston-cli package to use.

Type: package

Default: - pkgs.piston-cli + + { + _type = "literalExpression"; text = "pkgs.piston-cli"; + } +

Declared by:

<home-manager/modules/programs/piston-cli.nix>
programs.piston-cli.settings

Configuration written to @@ -6467,13 +6602,13 @@ documentation for details. } -

Example:

{
-  theme = "emacs";
-  box_style = "MINIMAL_DOUBLE_HEAD";
-  prompt_continuation = "...";
-  prompt_start = ">>>";
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n theme = \"emacs\";\n box_style = \"MINIMAL_DOUBLE_HEAD\";\n prompt_continuation = \"...\";\n prompt_start = \">>>\";\n}\n"; + } + +

Declared by:

<home-manager/modules/programs/piston-cli.nix>
programs.powerline-go.enable

Whether to enable Powerline-go, a beautiful and useful low-latency prompt for your shell.

Type: boolean

Default: false @@ -6512,8 +6647,13 @@ may use '~' to represent your home directory but you should protect it to avoid shell substitution.

Type: null or attribute set of strings

Default: null -

Example:

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

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{ \"\\\\~/projects/home-manager\" = \"prj:home-manager\"; }\n"; + } + +

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. @@ -6523,13 +6663,13 @@ protect it to avoid shell substitution. } -

Example:

{
-  hostname-only-if-ssh = true;
-  numeric-exit-codes = true;
-  cwd-max-depth = 7;
-  ignore-repos = [ "/home/me/big-project" "/home/me/huge-project" ];
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n hostname-only-if-ssh = true;\n numeric-exit-codes = true;\n cwd-max-depth = 7;\n ignore-repos = [ \"/home/me/big-project\" \"/home/me/huge-project\" ];\n}\n"; + } + +

Declared by:

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

Whether to enable qutebrowser.

Type: boolean

Default: false @@ -6543,7 +6683,11 @@ protect it to avoid shell substitution.

Declared by:

<home-manager/modules/programs/qutebrowser.nix>
programs.qutebrowser.package

Qutebrowser package to install.

Type: package

Default: - pkgs.qutebrowser + + { + _type = "literalExpression"; text = "pkgs.qutebrowser"; + } +

Declared by:

<home-manager/modules/programs/qutebrowser.nix>
programs.qutebrowser.aliases

Aliases for commands. @@ -6628,17 +6772,13 @@ commands. The following modes are available: } -

Example:

{
-  normal = {
-    "<Ctrl-v>" = "spawn mpv {url}";
-    ",p" = "spawn --userscript qute-pass";
-    ",l" = ''config-cycle spellcheck.languages ["en-GB"] ["en-US"]'';
-  };
-  prompt = {
-    "<Ctrl-y>" = "prompt-yes";
-  };
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n normal = {\n \"<Ctrl-v>\" = \"spawn mpv {url}\";\n \",p\" = \"spawn --userscript qute-pass\";\n \",l\" = ''config-cycle spellcheck.languages [\"en-GB\"] [\"en-US\"]'';\n };\n prompt = {\n \"<Ctrl-y>\" = \"prompt-yes\";\n };\n}\n"; + } + +

Declared by:

<home-manager/modules/programs/qutebrowser.nix>
programs.qutebrowser.keyMappings

This setting can be used to map keys to other keys. When the key used as dictionary-key is pressed, the binding for the key used as @@ -6667,11 +6807,13 @@ Note that when Home Manager manages your quickmarks, you cannot edit them at run } -

Example:

{
-  nixpkgs = "https://github.com/NixOS/nixpkgs";
-  home-manager = "https://github.com/nix-community/home-manager";
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n nixpkgs = \"https://github.com/NixOS/nixpkgs\";\n home-manager = \"https://github.com/nix-community/home-manager\";\n}\n"; + } + +

Declared by:

<home-manager/modules/programs/qutebrowser.nix>
programs.qutebrowser.searchEngines

Search engines that can be used via the address bar. Maps a search engine name (such as DEFAULT, or @@ -6690,13 +6832,13 @@ prepending the search engine name to the search term, for example } -

Example:

{
-  w = "https://en.wikipedia.org/wiki/Special:Search?search={}&go=Go&ns0=1";
-  aw = "https://wiki.archlinux.org/?search={}";
-  nw = "https://nixos.wiki/index.php?search={}";
-  g = "https://www.google.com/search?hl=en&q={}";
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n w = \"https://en.wikipedia.org/wiki/Special:Search?search={}&go=Go&ns0=1\";\n aw = \"https://wiki.archlinux.org/?search={}\";\n nw = \"https://nixos.wiki/index.php?search={}\";\n g = \"https://www.google.com/search?hl=en&q={}\";\n}\n"; + } + +

Declared by:

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

Options to add to qutebrowser config.py file. See https://qutebrowser.org/doc/help/settings.html @@ -6707,17 +6849,13 @@ for options. } -

Example:

{
-  colors = {
-    hints = {
-      bg = "#000000";
-      fg = "#ffffff";
-    };
-    tabs.bar.bg = "#000000";
-  };
-  tabs.tabs_are_windows = true;
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n colors = {\n hints = {\n bg = \"#000000\";\n fg = \"#ffffff\";\n };\n tabs.bar.bg = \"#000000\";\n };\n tabs.tabs_are_windows = true;\n}\n"; + } + +

Declared by:

<home-manager/modules/programs/qutebrowser.nix>
programs.rbw.enable

Whether to enable rwb, a CLI Bitwarden client.

Type: boolean

Default: false @@ -6728,19 +6866,24 @@ for options.

programs.rbw.package

Package providing the rbw tool and its rbw-agent daemon.

Type: package

Default: - pkgs.rbw + + { + _type = "literalExpression"; text = "pkgs.rbw"; + } +

Declared by:

<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:

{
-  email = "name@example.com";
-  lock_timeout = 300;
-  pinentry = "gnome3";
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n email = \"name@example.com\";\n lock_timeout = 300;\n pinentry = \"gnome3\";\n}\n"; + } + +

Declared by:

<home-manager/modules/programs/rbw.nix>
programs.rbw.settings.base_url

The base-url for a self-hosted bitwarden installation.

Type: null or string

Default: null @@ -6792,8 +6935,13 @@ now. } -

Example:

{ "\\C-h" = "backward-kill-word"; }
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{ \"\\\\C-h\" = \"backward-kill-word\"; }\n"; + } + +

Declared by:

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

Configuration lines appended unchanged to the end of the ~/.inputrc file. @@ -6829,8 +6977,13 @@ now.

programs.rofi.package

Package providing the rofi binary.

Type: package

Default: (build of rofi-1.7.0) -

Example:

pkgs.rofi.override { plugins = [ pkgs.rofi-emoji ]; };
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "pkgs.rofi.override { plugins = [ pkgs.rofi-emoji ]; };\n"; + } + +

Declared by:

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

Border width

Type: null or signed integer

Default: null @@ -6844,26 +6997,13 @@ therefore the programs.rofi.theme option should be used whenever possible.

Type: null or submodule

Default: null -

Example:

colors = {
-  window = {
-    background = "argb:583a4c54";
-    border = "argb:582a373e";
-    separator = "#c3c6c8";
-  };
-
-  rows = {
-    normal = {
-      background = "argb:58455a64";
-      foreground = "#fafbfc";
-      backgroundAlt = "argb:58455a64";
-      highlight = {
-        background = "#00bcd4";
-        foreground = "#fafbfc";
-      };
-    };
-  };
-};
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "colors = {\n window = {\n background = \"argb:583a4c54\";\n border = \"argb:582a373e\";\n separator = \"#c3c6c8\";\n };\n\n rows = {\n normal = {\n background = \"argb:58455a64\";\n foreground = \"#fafbfc\";\n backgroundAlt = \"argb:58455a64\";\n highlight = {\n background = \"#00bcd4\";\n foreground = \"#fafbfc\";\n };\n };\n };\n};\n"; + } + +

Declared by:

<home-manager/modules/programs/rofi.nix>
programs.rofi.colors.rows

Rows color settings.

Type: submodule

Default: null @@ -6941,12 +7081,13 @@ should be used whenever possible. } -

Example:

{
-  modi = "drun,emoji,ssh";
-  kb-primary-paste = "Control+V,Shift+Insert";
-  kb-secondary-paste = "Control+v,Insert";
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n modi = \"drun,emoji,ssh\";\n kb-primary-paste = \"Control+V,Shift+Insert\";\n kb-secondary-paste = \"Control+v,Insert\";\n}\n"; + } + +

Declared by:

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

Font to use.

Type: null or string

Default: null @@ -7007,7 +7148,13 @@ AUTOTYPE_field='autotype' ] -

Example:

[ pkgs.rofi-calc ]

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "[ pkgs.rofi-calc ]"; + } + +

Declared by:

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

Row height (in chars)

Type: null or signed integer

Default: null @@ -7037,28 +7184,13 @@ 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 stringss or strings

Default: null -

Example:

let
-  inherit (config.lib.formats.rasi) mkLiteral;
-in {
-  "*" = {
-    background-color = mkLiteral "#000000";
-    foreground-color = mkLiteral "rgba ( 250, 251, 252, 100 % )";
-    border-color = mkLiteral "#FFFFFF";
-    width = 512;
-  };
-
-  "#inputbar" = {
-    children = map mkLiteral [ "prompt" "entry" ];
-  };
-
-  "#textbox-prompt-colon" = {
-    expand = false;
-    str = ":";
-    margin = mkLiteral "0px 0.3em 0em 0em";
-    text-color = mkLiteral "@foreground-color";
-  };
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "let\n inherit (config.lib.formats.rasi) mkLiteral;\nin {\n \"*\" = {\n background-color = mkLiteral \"#000000\";\n foreground-color = mkLiteral \"rgba ( 250, 251, 252, 100 % )\";\n border-color = mkLiteral \"#FFFFFF\";\n width = 512;\n };\n\n \"#inputbar\" = {\n children = map mkLiteral [ \"prompt\" \"entry\" ];\n };\n\n \"#textbox-prompt-colon\" = {\n expand = false;\n str = \":\";\n margin = mkLiteral \"0px 0.3em 0em 0em\";\n text-color = mkLiteral \"@foreground-color\";\n };\n}\n"; + } + +

Declared by:

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

Window width

Type: null or signed integer

Default: null @@ -7097,7 +7229,11 @@ for explanation about possible values.

Declared by:

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

The package with sbt to be installed.

Type: package

Default: - pkgs.sbt + + { + _type = "literalExpression"; text = "pkgs.sbt"; + } +

Declared by:

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

Where the plugins and credentials should be located.

Type: string

Default: @@ -7111,13 +7247,13 @@ for explanation about possible values. ] -

Example:

[{
-  realm = "Sonatype Nexus Repository Manager";
-  host = "example.com";
-  user = "user";
-  passwordCommand = "pass show sbt/user@example.com";
-}]
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "[{\n realm = \"Sonatype Nexus Repository Manager\";\n host = \"example.com\";\n user = \"user\";\n passwordCommand = \"pass show sbt/user@example.com\";\n}]\n"; + } + +

Declared by:

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

The hostname of the repository you're authenticating to.

Type: string

Declared by:

<home-manager/modules/programs/sbt.nix> @@ -7136,19 +7272,13 @@ the repository. ] -

Example:

[
-  {
-    org = "net.virtual-void";
-    artifact = "sbt-dependency-graph";
-    version = "0.10.0-RC1";
-  }
-  {
-    org = "com.dwijnand";
-    artifact = "sbt-project-graph";
-    version = "0.4.0";
-  }
-]
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "[\n {\n org = \"net.virtual-void\";\n artifact = \"sbt-dependency-graph\";\n version = \"0.10.0-RC1\";\n }\n {\n org = \"com.dwijnand\";\n artifact = \"sbt-project-graph\";\n version = \"0.4.0\";\n }\n]\n"; + } + +

Declared by:

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

The name of the artifact.

Type: string

Declared by:

<home-manager/modules/programs/sbt.nix> @@ -7174,7 +7304,11 @@ substituting numeric shortcuts for files.

Type:

Declared by:

<home-manager/modules/programs/scmpuff.nix>
programs.scmpuff.package

Package providing the scmpuff tool.

Type: package

Default: - pkgs.scmpuff + + { + _type = "literalExpression"; text = "pkgs.scmpuff"; + } +

Declared by:

<home-manager/modules/programs/scmpuff.nix>
programs.senpai.enable

Whether to enable senpai.

Type: boolean

Default: @@ -7184,17 +7318,22 @@ substituting numeric shortcuts for files.

Type:

Declared by:

<home-manager/modules/programs/senpai.nix>
programs.senpai.package

The senpai package to use.

Type: package

Default: - pkgs.senpai + + { + _type = "literalExpression"; text = "pkgs.senpai"; + } +

Declared by:

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

Configuration for senpai. For a complete list of options, see senpai(5). -

Type: YAML value

Example:

{
-  addr = "libera.chat:6697";
-  nick = "nicholas";
-  password = "verysecurepassword";
-}
-

Declared by:

+

Type: YAML value

Example: + + { + _type = "literalExpression"; text = "{\n addr = \"libera.chat:6697\";\n nick = \"nicholas\";\n password = \"verysecurepassword\";\n}\n"; + } + +

Declared by:

<home-manager/modules/programs/senpai.nix>
programs.senpai.config.addr

The address (host[:port]) of the IRC server. senpai uses TLS connections by default unless you specify no-tls option. TLS @@ -7332,57 +7471,51 @@ CTRL-T keybinding. <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:

+

Example: + + { + _type = "literalExpression"; text = "/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 strings

Default: null -

Example:

[
-  "BETTERCAMERA=1"
-  "NODRAWINGDISTANCE=1"
-];
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "[\n \"BETTERCAMERA=1\"\n \"NODRAWINGDISTANCE=1\"\n];\n"; + } + +

Declared by:

<home-manager/modules/programs/sm64ex.nix>
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:

+ + { + _type = "literalExpression"; text = "us"; + } + +

Example: + + { + _type = "literalExpression"; text = "jp"; + } + +

Declared by:

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

Settings for sm64ex's ~/.local/share/sm64pc/sm64config.txt file.

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

Default: null -

Example:

{
-  fullscreen = false;
-  window_x = 0;
-  window_y = 0;
-  window_w = 1920;
-  window_h = 1080;
-  vsync = 1;
-  texture_filtering = 1;
-  master_volume = 127;
-  music_volume = 127;
-  sfx_volume = 127;
-  env_volume = 127;
-  key_a = [ "0026" "1000" "1103" ];
-  key_b = [ "0033" "1002" "1101" ];
-  key_start = [ "0039" "1006" "ffff" ];
-  key_l = [ "0034" "1007" "1104" ];
-  key_r = [ "0036" "100a" "1105" ];
-  key_z = [ "0025" "1009" "1102" ];
-  key_cup = [ "100b" "ffff" "ffff" ];
-  key_cdown = [ "100c" "ffff" "ffff" ];
-  key_cleft = [ "100d" "ffff" "ffff" ];
-  key_cright = [ "100e" "ffff" "ffff" ];
-  key_stickup = [ "0011" "ffff" "ffff" ];
-  key_stickdown = [ "001f" "ffff" "ffff" ];
-  key_stickleft = [ "001e" "ffff" "ffff" ];
-  key_stickright = [ "0020" "ffff" "ffff" ];
-  stick_deadzone = 16;
-  rumble_strength = 10;
-  skip_intro = 1;
-};
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n fullscreen = false;\n window_x = 0;\n window_y = 0;\n window_w = 1920;\n window_h = 1080;\n vsync = 1;\n texture_filtering = 1;\n master_volume = 127;\n music_volume = 127;\n sfx_volume = 127;\n env_volume = 127;\n key_a = [ \"0026\" \"1000\" \"1103\" ];\n key_b = [ \"0033\" \"1002\" \"1101\" ];\n key_start = [ \"0039\" \"1006\" \"ffff\" ];\n key_l = [ \"0034\" \"1007\" \"1104\" ];\n key_r = [ \"0036\" \"100a\" \"1105\" ];\n key_z = [ \"0025\" \"1009\" \"1102\" ];\n key_cup = [ \"100b\" \"ffff\" \"ffff\" ];\n key_cdown = [ \"100c\" \"ffff\" \"ffff\" ];\n key_cleft = [ \"100d\" \"ffff\" \"ffff\" ];\n key_cright = [ \"100e\" \"ffff\" \"ffff\" ];\n key_stickup = [ \"0011\" \"ffff\" \"ffff\" ];\n key_stickdown = [ \"001f\" \"ffff\" \"ffff\" ];\n key_stickleft = [ \"001e\" \"ffff\" \"ffff\" ];\n key_stickright = [ \"0020\" \"ffff\" \"ffff\" ];\n stick_deadzone = 16;\n rumble_strength = 10;\n skip_intro = 1;\n};\n"; + } + +

Declared by:

<home-manager/modules/programs/sm64ex.nix>
programs.ssh.enable

Whether to enable SSH client configuration.

Type: boolean

Default: false @@ -7453,17 +7586,13 @@ for more information. } -

Example:

{
-  "john.example.com" = {
-    hostname = "example.com";
-    user = "john";
-  };
-  foo = lib.hm.dag.entryBefore ["john.example.com"] {
-    hostname = "example.com";
-    identityFile = "/home/john/.ssh/foo_rsa";
-  };
-};
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n \"john.example.com\" = {\n hostname = \"example.com\";\n user = \"john\";\n };\n foo = lib.hm.dag.entryBefore [\"john.example.com\"] {\n hostname = \"example.com\";\n identityFile = \"/home/john/.ssh/foo_rsa\";\n };\n};\n"; + } + +

Declared by:

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

Specifies which address family to use when connecting.

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

Default: @@ -7499,8 +7628,13 @@ block when null. ] -

Example:

[ { port = 8080; } ];
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "[ { port = 8080; } ];\n"; + } + +

Declared by:

<home-manager/modules/programs/ssh.nix>
programs.ssh.matchBlocks.<name>.dynamicForwards.*.address

The address where to bind the port.

Type: string

Default: "localhost" @@ -7576,14 +7710,13 @@ Identities will be tried in the given order. ] -

Example:

[
-  {
-    bind.port = 8080;
-    host.address = "10.0.0.13";
-    host.port = 80;
-  }
-];
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "[\n {\n bind.port = 8080;\n host.address = \"10.0.0.13\";\n host.port = 80;\n }\n];\n"; + } + +

Declared by:

<home-manager/modules/programs/ssh.nix>
programs.ssh.matchBlocks.<name>.localForwards.*.bind.address

The address where to bind the port.

Type: string

Default: "localhost" @@ -7629,14 +7762,13 @@ Identities will be tried in the given order. ] -

Example:

[
-  {
-    bind.port = 8080;
-    host.address = "10.0.0.13";
-    host.port = 80;
-  }
-];
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "[\n {\n bind.port = 8080;\n host.address = \"10.0.0.13\";\n host.port = 80;\n }\n];\n"; + } + +

Declared by:

<home-manager/modules/programs/ssh.nix>
programs.ssh.matchBlocks.<name>.remoteForwards.*.bind.address

The address where to bind the port.

Type: string

Default: "localhost" @@ -7726,7 +7858,11 @@ database, separated by whitespace. The default is

Declared by:

<home-manager/modules/programs/starship.nix>
programs.starship.package

The package to use for the starship binary.

Type: package

Default: - pkgs.starship + + { + _type = "literalExpression"; text = "pkgs.starship"; + } +

Declared by:

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

Configuration written to @@ -7740,21 +7876,13 @@ of options. } -

Example:

{
-  add_newline = false;
-  format = lib.concatStrings [
-    "$line_break"
-    "$package"
-    "$line_break"
-    "$character"
-  ];
-  scan_timeout = 10;
-  character = {
-    success_symbol = "➜";
-    error_symbol = "➜";
-  };
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n add_newline = false;\n format = lib.concatStrings [\n \"\$line_break\"\n \"\$package\"\n \"\$line_break\"\n \"\$character\"\n ];\n scan_timeout = 10;\n character = {\n success_symbol = \"➜\";\n error_symbol = \"➜\";\n };\n}\n"; + } + +

Declared by:

<home-manager/modules/programs/starship.nix>
programs.taskwarrior.enable

Whether to enable Task Warrior.

Type: boolean

Default: false @@ -7778,20 +7906,13 @@ path to a theme configuration file. } -

Example:

{
-  confirmation = false;
-  report.minimal.filter = "status:pending";
-  report.active.columns = [ "id" "start" "entry.age" "priority" "project" "due" "description" ];
-  report.active.labels  = [ "ID" "Started" "Age" "Priority" "Project" "Due" "Description" ];
-  taskd = {
-    certificate = "/path/to/cert";
-    key = "/path/to/key";
-    ca = "/path/to/ca";
-    server = "host.domain:53589";
-    credentials = "Org/First Last/cf31f287-ee9e-43a8-843e-e8bbd5de4294";
-  };
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n confirmation = false;\n report.minimal.filter = \"status:pending\";\n report.active.columns = [ \"id\" \"start\" \"entry.age\" \"priority\" \"project\" \"due\" \"description\" ];\n report.active.labels = [ \"ID\" \"Started\" \"Age\" \"Priority\" \"Project\" \"Due\" \"Description\" ];\n taskd = {\n certificate = \"/path/to/cert\";\n key = \"/path/to/key\";\n ca = \"/path/to/ca\";\n server = \"host.domain:53589\";\n credentials = \"Org/First Last/cf31f287-ee9e-43a8-843e-e8bbd5de4294\";\n };\n}\n"; + } + +

Declared by:

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

Location where Task Warrior will store its data.

@@ -7814,7 +7935,13 @@ Home Manager will attempt to create this directory. <home-manager/modules/programs/terminator.nix>

programs.terminator.package

terminator package to install.

Type: package

Default: (build of terminator-2.1.1) -

Example:

pkgs.terminator

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "pkgs.terminator"; + } + +

Declared by:

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

configuration for terminator.

@@ -7827,11 +7954,13 @@ man page. } -

Example:

{
-  global_config.borderless = true;
-  profiles.default.background_color = "#002b36";
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n global_config.borderless = true;\n profiles.default.background_color = \"#002b36\";\n}\n"; + } + +

Declared by:

<home-manager/modules/programs/terminator.nix>
programs.termite.enable

Whether to enable Termite VTE-based terminal.

Type: boolean

Default: false @@ -8081,13 +8210,22 @@ Requires a window manager that respects scroll hints.

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 + + { + _type = "literalExpression"; text = "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; }
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "tpkgs: { inherit (tpkgs) collection-fontsrecommended algorithms; }\n"; + } + +

Declared by:

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

Whether to enable tmux.

Type: boolean

Default: false @@ -8096,8 +8234,18 @@ Requires a window manager that respects scroll hints.

Declared by:

<home-manager/modules/programs/tmux.nix>
programs.tmux.package

The tmux package to install

Type: package

Default: - pkgs.tmux -

Example:

pkgs.tmux

Declared by:

+ + { + _type = "literalExpression"; text = "pkgs.tmux"; + } + +

Example: + + { + _type = "literalExpression"; text = "pkgs.tmux"; + } + +

Declared by:

<home-manager/modules/programs/tmux.nix>
programs.tmux.aggressiveResize

Resize the window to the size of the smallest session for which it is the current window. @@ -8167,21 +8315,13 @@ run at the top of your configuration. ] -

Example:

with pkgs; [
-  tmuxPlugins.cpu
-  {
-    plugin = tmuxPlugins.resurrect;
-    extraConfig = "set -g @resurrect-strategy-nvim 'session'";
-  }
-  {
-    plugin = tmuxPlugins.continuum;
-    extraConfig = ''
-      set -g @continuum-restore 'on'
-      set -g @continuum-save-interval '60' # minutes
-    '';
-  }
-]
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "with pkgs; [\n tmuxPlugins.cpu\n {\n plugin = tmuxPlugins.resurrect;\n extraConfig = \"set -g @resurrect-strategy-nvim 'session'\";\n }\n {\n plugin = tmuxPlugins.continuum;\n extraConfig = ''\n set -g @continuum-restore 'on'\n set -g @continuum-save-interval '60' # minutes\n '';\n }\n]\n"; + } + +

Declared by:

<home-manager/modules/programs/tmux.nix>
programs.tmux.prefix

Set the prefix key. Overrules the "shortcut" option when set.

Type: null or string

Default: @@ -8252,7 +8392,11 @@ is possible to override the sensible settings using the

Declared by:

<home-manager/modules/programs/topgrade.nix>
programs.topgrade.package

The package to use for the topgrade binary.

Type: package

Default: - pkgs.topgrade + + { + _type = "literalExpression"; text = "pkgs.topgrade"; + } +

Declared by:

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

Configuration written to @@ -8261,20 +8405,18 @@ is possible to override the sensible settings using the See https://github.com/r-darwish/topgrade/wiki/Step-list for the full list of options.

Type: TOML value

Default: - { } -

Example:

{
-  assume_yes = true;
-  disable = [
-    "flutter"
-    "node"
-  ];
-  set_title = false;
-  cleanup = true;
-  commands = {
-    "Run garbage collection on Nix store" = "nix-collect-garbage";
-  };
-}
-

Declared by:

+ + { + _type = "literalExpression"; text = "{ }"; + } + +

Example: + + { + _type = "literalExpression"; text = "{\n assume_yes = true;\n disable = [\n \"flutter\"\n \"node\"\n ];\n set_title = false;\n cleanup = true;\n commands = {\n \"Run garbage collection on Nix store\" = \"nix-collect-garbage\";\n };\n}\n"; + } + +

Declared by:

<home-manager/modules/programs/topgrade.nix>
programs.urxvt.enable

Whether to enable rxvt-unicode terminal emulator.

Type: boolean

Default: false @@ -8283,7 +8425,11 @@ of options.

Declared by:

<home-manager/modules/programs/urxvt.nix>
programs.urxvt.package

rxvt-unicode package to install.

Type: package

Default: - pkgs.rxvt_unicode + + { + _type = "literalExpression"; text = "pkgs.rxvt_unicode"; + } +

Declared by:

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

Additional configuration to add.

Type: attribute set of anythings

Default: @@ -8324,11 +8470,13 @@ of options. } -

Example:

{
-  "Shift-Control-C" = "eval:selection_to_clipboard";
-  "Shift-Control-V" = "eval:paste_clipboard";
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n \"Shift-Control-C\" = \"eval:selection_to_clipboard\";\n \"Shift-Control-V\" = \"eval:paste_clipboard\";\n}\n"; + } + +

Declared by:

<home-manager/modules/programs/urxvt.nix>
programs.urxvt.scroll.bar

Scrollbar settings.

Type: submodule

Default: @@ -8413,7 +8561,13 @@ Note: String values are deprecated, please use actual packages. (build of vimplugin-vim-sensible-2019-11-24) ] -

Example:

[ pkgs.vimPlugins.YankRing ]

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "[ pkgs.vimPlugins.YankRing ]"; + } + +

Declared by:

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

At attribute set of Vim settings. The attribute names and corresponding values must be among the following supported @@ -8430,12 +8584,13 @@ manually set any options not listed above. } -

Example:

{
-  expandtab = true;
-  history = 1000;
-  background = "dark";
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n expandtab = true;\n history = 1000;\n background = \"dark\";\n}\n"; + } + +

Declared by:

<home-manager/modules/programs/vim.nix>
programs.vscode.enable

Whether to enable Visual Studio Code.

Type: boolean

Default: false @@ -8446,7 +8601,13 @@ manually set any options not listed above.

programs.vscode.package

Version of Visual Studio Code to install.

Type: package

Default: (build of vscode-1.60.2) -

Example:

pkgs.vscodium

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "pkgs.vscodium"; + } + +

Declared by:

<home-manager/modules/programs/vscode.nix>
programs.vscode.extensions

The extensions Visual Studio Code should be started with. These will override but not delete manually installed ones. @@ -8456,7 +8617,13 @@ These will override but not delete manually installed ones. ] -

Example:

[ pkgs.vscode-extensions.bbenoist.Nix ]

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "[ pkgs.vscode-extensions.bbenoist.Nix ]"; + } + +

Declared by:

<home-manager/modules/programs/vscode.nix>
programs.vscode.haskell.enable

Whether to enable Haskell integration for Visual Studio Code.

Type: boolean

Default: false @@ -8477,9 +8644,18 @@ overlay or set this option. Example overlay configuration: ]

Type: path

Default: - "${pkgs.hie-nix.hies}/bin/hie-wrapper" -

Example:

(import ~/src/haskell-ide-engine {}).hies + "/bin/hie-wrapper";
-

Declared by:

+ + { + _type = "literalExpression"; text = ''"''${pkgs.hie-nix.hies}/bin/hie-wrapper"''; + } + +

Example: + + { + _type = "literalExpression"; text = "(import ~/src/haskell-ide-engine {}).hies + \"/bin/hie-wrapper\";\n"; + } + +

Declared by:

<home-manager/modules/programs/vscode/haskell.nix>
programs.vscode.keybindings

Keybindings written to Visual Studio Code's keybindings.json. @@ -8489,14 +8665,13 @@ overlay or set this option. Example overlay configuration: ] -

Example:

[
-  {
-    key = "ctrl+c";
-    command = "editor.action.clipboardCopyAction";
-    when = "textInputFocus";
-  }
-]
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "[\n {\n key = \"ctrl+c\";\n command = \"editor.action.clipboardCopyAction\";\n when = \"textInputFocus\";\n }\n]\n"; + } + +

Declared by:

<home-manager/modules/programs/vscode.nix>
programs.vscode.keybindings.*.args

Optional arguments for a command.

Type: null or attribute set

Default: null @@ -8530,11 +8705,13 @@ overlay or set this option. Example overlay configuration: } -

Example:

{
-  "update.channel" = "none";
-  "[nix]"."editor.tabSize" = 2;
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n \"update.channel\" = \"none\";\n \"[nix]\".\"editor.tabSize\" = 2;\n}\n"; + } + +

Declared by:

<home-manager/modules/programs/vscode.nix>
programs.waybar.enable

Whether to enable Waybar.

Type: boolean

Default: false @@ -8555,35 +8732,13 @@ for supported values. ] -

Example:

[
-  {
-    layer = "top";
-    position = "top";
-    height = 30;
-    output = [
-      "eDP-1"
-      "HDMI-A-1"
-    ];
-    modules-left = [ "sway/workspaces" "sway/mode" "wlr/taskbar" ];
-    modules-center = [ "sway/window" "custom/hello-from-waybar" ];
-    modules-right = [ "mpd" "custom/mymodule#with-css-id" "temperature" ];
-    modules = {
-      "sway/workspaces" = {
-        disable-scroll = true;
-        all-outputs = true;
-      };
-      "custom/hello-from-waybar" = {
-        format = "hello {}";
-        max-length = 40;
-        interval = "once";
-        exec = pkgs.writeShellScript "hello-from-waybar" ''
-          echo "from within waybar"
-        '';
-      };
-    };
-  }
-]
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "[\n {\n layer = \"top\";\n position = \"top\";\n height = 30;\n output = [\n \"eDP-1\"\n \"HDMI-A-1\"\n ];\n modules-left = [ \"sway/workspaces\" \"sway/mode\" \"wlr/taskbar\" ];\n modules-center = [ \"sway/window\" \"custom/hello-from-waybar\" ];\n modules-right = [ \"mpd\" \"custom/mymodule#with-css-id\" \"temperature\" ];\n modules = {\n \"sway/workspaces\" = {\n disable-scroll = true;\n all-outputs = true;\n };\n \"custom/hello-from-waybar\" = {\n format = \"hello {}\";\n max-length = 40;\n interval = \"once\";\n exec = pkgs.writeShellScript \"hello-from-waybar\" ''\n echo \"from within waybar\"\n '';\n };\n };\n }\n]\n"; + } + +

Declared by:

<home-manager/modules/programs/waybar.nix>
programs.waybar.settings.*.gtk-layer-shell

Option to disable the use of gtk-layer-shell for popups.

Type: null or boolean

Default: null @@ -8641,15 +8796,13 @@ of the windows or behind ("bottom"). } -

Example:

{
-  "sway/window" = {
-    max-length = 50;
-  };
-  "clock" = {
-    format-alt = "{:%a, %d. %b  %H:%M}";
-  };
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n \"sway/window\" = {\n max-length = 50;\n };\n \"clock\" = {\n format-alt = \"{:%a, %d. %b %H:%M}\";\n };\n}\n"; + } + +

Declared by:

<home-manager/modules/programs/waybar.nix>
programs.waybar.settings.*.modules-center

Modules that will be displayed in the center.

Type: list of strings

Default: @@ -8657,8 +8810,13 @@ of the windows or behind ("bottom"). ] -

Example:

[ "sway/window" ]
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "[ \"sway/window\" ]\n"; + } + +

Declared by:

<home-manager/modules/programs/waybar.nix>
programs.waybar.settings.*.modules-left

Modules that will be displayed on the left.

Type: list of strings

Default: @@ -8666,8 +8824,13 @@ of the windows or behind ("bottom"). ] -

Example:

[ "sway/workspaces" "sway/mode" "wlr/taskbar" ]
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "[ \"sway/workspaces\" \"sway/mode\" \"wlr/taskbar\" ]\n"; + } + +

Declared by:

<home-manager/modules/programs/waybar.nix>
programs.waybar.settings.*.modules-right

Modules that will be displayed on the right.

Type: list of strings

Default: @@ -8675,8 +8838,13 @@ of the windows or behind ("bottom"). ] -

Example:

[ "mpd" "custom/mymodule#with-css-id" "temperature" ]
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "[ \"mpd\" \"custom/mymodule#with-css-id\" \"temperature\" ]\n"; + } + +

Declared by:

<home-manager/modules/programs/waybar.nix>
programs.waybar.settings.*.name

Optional name added as a CSS class, for styling multiple waybars.

Type: null or string

Default: null @@ -8688,8 +8856,13 @@ of the windows or behind ("bottom"). Exclamation mark(!) can be used to exclude specific output.

Type: null or string or list of strings

Default: null -

Example:

[ "DP-1" "!DP-2" "!DP-3" ]
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "[ \"DP-1\" \"!DP-2\" \"!DP-3\" ]\n"; + } + +

Declared by:

<home-manager/modules/programs/waybar.nix>
programs.waybar.settings.*.position

Bar position relative to the output.

Type: null or one of "top", "bottom", "left", "right"

Default: null @@ -8737,7 +8910,11 @@ window#waybar { <home-manager/modules/programs/xmobar.nix>

programs.xmobar.package

Package providing the xmobar binary.

Type: package

Default: - pkgs.haskellPackages.xmobar + + { + _type = "literalExpression"; text = "pkgs.haskellPackages.xmobar"; + } +

Declared by:

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

Extra configuration lines to add to @@ -8747,26 +8924,13 @@ See for options.

Type: strings concatenated with "\n"

Default: "" -

Example:

Config
-  { font        = "Fira Code"
-  , borderColor = "#d0d0d0"
-  , border      = FullB
-  , borderWidth = 3
-  , bgColor     = "#222"
-  , fgColor     = "grey"
-  , position    = TopSize C 99 30
-  , commands    =
-      [ Run Cpu ["-t", "cpu: <fc=#4eb4fa><bar> <total>%</fc>"] 10
-      , Run Network "enp3s0" ["-S", "True", "-t", "eth: <fc=#4eb4fa><rx></fc>/<fc=#4eb4fa><tx></fc>"] 10
-      , Run Memory ["-t","mem: <fc=#4eb4fa><usedbar> <usedratio>%</fc>"] 10
-      , Run Date "date: <fc=#4eb4fa>%a %d %b %Y %H:%M:%S </fc>" "date" 10
-      , Run StdinReader
-      ]
-  , sepChar     = "%"
-  , alignSep    = "}{"
-  , template    = "  %StdinReader% | %cpu% | %memory% | %enp3s0%  }{%date%  "
-  }
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "Config\n { font = \"Fira Code\"\n , borderColor = \"#d0d0d0\"\n , border = FullB\n , borderWidth = 3\n , bgColor = \"#222\"\n , fgColor = \"grey\"\n , position = TopSize C 99 30\n , commands =\n [ Run Cpu [\"-t\", \"cpu: <fc=#4eb4fa><bar> <total>%</fc>\"] 10\n , Run Network \"enp3s0\" [\"-S\", \"True\", \"-t\", \"eth: <fc=#4eb4fa><rx></fc>/<fc=#4eb4fa><tx></fc>\"] 10\n , Run Memory [\"-t\",\"mem: <fc=#4eb4fa><usedbar> <usedratio>%</fc>\"] 10\n , Run Date \"date: <fc=#4eb4fa>%a %d %b %Y %H:%M:%S </fc>\" \"date\" 10\n , Run StdinReader\n ]\n , sepChar = \"%\"\n , alignSep = \"}{\"\n , template = \" %StdinReader% | %cpu% | %memory% | %enp3s0% }{%date% \"\n }\n"; + } + +

Declared by:

<home-manager/modules/programs/xmobar.nix>
programs.z-lua.enable

Whether to enable z.lua.

Type: boolean

Default: false @@ -8867,7 +9031,11 @@ for the full list of options. <home-manager/modules/programs/zoxide.nix>

programs.zoxide.package

Zoxide package to install.

Type: package

Default: - pkgs.zoxide + + { + _type = "literalExpression"; text = "pkgs.zoxide"; + } +

Declared by:

<home-manager/modules/programs/zoxide.nix>
programs.zoxide.options

List of options to pass to zoxide. @@ -8948,12 +9116,13 @@ directory. } -

Example:

{
-  docs  = "$HOME/Documents";
-  vids  = "$HOME/Videos";
-  dl    = "$HOME/Downloads";
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n docs = \"\$HOME/Documents\";\n vids = \"\$HOME/Videos\";\n dl = \"\$HOME/Downloads\";\n}\n"; + } + +

Declared by:

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

Directory where the zsh configuration and more should be located, relative to the users home directory. The default is the home @@ -8998,7 +9167,13 @@ if they match any one of the given shell patterns. ] -

Example:

[ "rm *" "pkill *" ]

Declared by:

+

Example: + + { + _type = "literalExpression"; text = ''[ "rm *" "pkill *" ]''; + } + +

Declared by:

<home-manager/modules/programs/zsh.nix>
programs.zsh.history.ignoreSpace

Do not enter command lines into the history list if the first character is a space. @@ -9007,10 +9182,18 @@ if the first character is a space.

Declared by:

<home-manager/modules/programs/zsh.nix>
programs.zsh.history.path

History file location

Type: string

Default: - "$HOME/.zsh_history" if state version ≥ 20.03, -"$ZDOTDIR/.zsh_history" otherwise - -

Example:

"${config.xdg.dataHome}/zsh/zsh_history"

Declared by:

+ + { + _type = "literalExpression"; text = "\"\$HOME/.zsh_history\" if state version ≥ 20.03,\n\"\$ZDOTDIR/.zsh_history\" otherwise\n"; + } + +

Example: + + { + _type = "literalExpression"; text = ''"''${config.xdg.dataHome}/zsh/zsh_history"''; + } + +

Declared by:

<home-manager/modules/programs/zsh.nix>
programs.zsh.history.save

Number of history lines to save.

Type: signed integer

Default: 10000 @@ -9121,29 +9304,13 @@ zstyle :omz:plugins:ssh-agent identities id_rsa id_rsa2 id_github ] -

Example:

[
-  {
-    # will source zsh-autosuggestions.plugin.zsh
-    name = "zsh-autosuggestions";
-    src = pkgs.fetchFromGitHub {
-      owner = "zsh-users";
-      repo = "zsh-autosuggestions";
-      rev = "v0.4.0";
-      sha256 = "0z6i9wjjklb4lvr7zjhbphibsyx51psv50gm07mbb0kj9058j6kc";
-    };
-  }
-  {
-    name = "enhancd";
-    file = "init.sh";
-    src = pkgs.fetchFromGitHub {
-      owner = "b4b4r07";
-      repo = "enhancd";
-      rev = "v2.2.1";
-      sha256 = "0iqa9j09fwm6nj5rpip87x3hnvbbz9w9ajgm6wkrd5fls8fn8i5g";
-    };
-  }
-]
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "[\n {\n # will source zsh-autosuggestions.plugin.zsh\n name = \"zsh-autosuggestions\";\n src = pkgs.fetchFromGitHub {\n owner = \"zsh-users\";\n repo = \"zsh-autosuggestions\";\n rev = \"v0.4.0\";\n sha256 = \"0z6i9wjjklb4lvr7zjhbphibsyx51psv50gm07mbb0kj9058j6kc\";\n };\n }\n {\n name = \"enhancd\";\n file = \"init.sh\";\n src = pkgs.fetchFromGitHub {\n owner = \"b4b4r07\";\n repo = \"enhancd\";\n rev = \"v2.2.1\";\n sha256 = \"0iqa9j09fwm6nj5rpip87x3hnvbbz9w9ajgm6wkrd5fls8fn8i5g\";\n };\n }\n]\n"; + } + +

Declared by:

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

The plugin script to source.

Type: string

Declared by:

<home-manager/modules/programs/zsh.nix> @@ -9502,11 +9669,13 @@ this option) to command strings or directly to build outputs. } -

Example:

{
-  ll = "ls -l";
-  ".." = "cd ..";
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n ll = \"ls -l\";\n \"..\" = \"cd ..\";\n}\n"; + } + +

Declared by:

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

Similar to opt-programs.zsh.shellAliases, but are substituted anywhere on a line. @@ -9516,11 +9685,13 @@ but are substituted anywhere on a line. } -

Example:

{
-  UUID = "$(uuidgen | tr -d \\n)";
-  G = "| grep";
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n UUID = \"\$(uuidgen | tr -d \\\\n)\";\n G = \"| grep\";\n}\n"; + } + +

Declared by:

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

Whether to enable zplug - a zsh plugin manager.

Type: boolean

Default: false @@ -9566,7 +9737,13 @@ but are substituted anywhere on a line. <home-manager/modules/misc/qt.nix>

qt.style.package

Theme package to be used in Qt5 applications.

Type: null or package

Default: null -

Example:

pkgs.adwaita-qt

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "pkgs.adwaita-qt"; + } + +

Declared by:

<home-manager/modules/misc/qt.nix>
qt.style.name

Selects the style to use for Qt5 applications.

The options are

adwaita, adwaita-dark

Use Adwaita Qt style with @@ -9601,7 +9778,11 @@ but are substituted anywhere on a line.

services.barrier.client.extraFlags

Additional flags to pass to barrierc. See barrierc --help.

Type: list of strings

Default: - [ "-f" ] + + { + _type = "literalExpression"; text = ''[ "-f" ]''; + } +

Declared by:

<home-manager/modules/services/barrier.nix>
services.barrier.client.name

Screen name of client. Defaults to hostname. @@ -9621,7 +9802,11 @@ Port defaults to 24800.

Declared by:

<home-manager/modules/services/betterlockscreen.nix>
services.betterlockscreen.package

Package providing betterlockscreen.

Type: package

Default: - pkgs.betterlockscreen + + { + _type = "literalExpression"; text = "pkgs.betterlockscreen"; + } +

Declared by:

<home-manager/modules/services/betterlockscreen.nix>
services.betterlockscreen.arguments

List of arguments appended to ./betterlockscreen --lock [args]

Type: list of strings

Default: @@ -9741,7 +9926,11 @@ end

Declared by:

<home-manager/modules/services/dropbox.nix>
services.dropbox.path

Where to put the Dropbox directory.

Type: path

Default: - "${config.home.homeDirectory}/Dropbox" + + { + _type = "literalExpression"; text = ''"''${config.home.homeDirectory}/Dropbox"''; + } +

Declared by:

<home-manager/modules/services/dropbox.nix>
services.dunst.enable

Whether to enable the dunst notification daemon.

Type: boolean

Default: @@ -9751,7 +9940,11 @@ end

Declared by:

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

Package providing dunst.

Type: package

Default: - pkgs.dunst + + { + _type = "literalExpression"; text = "pkgs.dunst"; + } +

Declared by:

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

Path to the configuration file read by dunst. @@ -9773,7 +9966,13 @@ desired.

Declared by:

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

Package providing the theme.

Type: package

Example:

pkgs.gnome.adwaita-icon-theme

Declared by:

+
services.dunst.iconTheme.package

Package providing the theme.

Type: package

Example: + + { + _type = "literalExpression"; text = "pkgs.gnome.adwaita-icon-theme"; + } + +

Declared by:

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

The name of the theme within the package.

Type: string

Example: "Adwaita" @@ -9791,21 +9990,13 @@ desired. } -

Example:

{
-  global = {
-    geometry = "300x5-30+50";
-    transparency = 10;
-    frame_color = "#eceff1";
-    font = "Droid Sans 9";
-  };
-
-  urgency_normal = {
-    background = "#37474f";
-    foreground = "#eceff1";
-    timeout = 10;
-  };
-};
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n global = {\n geometry = \"300x5-30+50\";\n transparency = 10;\n frame_color = \"#eceff1\";\n font = \"Droid Sans 9\";\n };\n\n urgency_normal = {\n background = \"#37474f\";\n foreground = \"#eceff1\";\n timeout = 10;\n };\n};\n"; + } + +

Declared by:

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

Paths where dunst will look for icons.

Type: strings concatenated with ":"

Declared by:

<home-manager/modules/services/dunst.nix> @@ -9820,7 +10011,11 @@ desired.

Declared by:

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

Which dwm-status package to use.

Type: package

Default: - pkgs.dwm-status + + { + _type = "literalExpression"; text = "pkgs.dwm-status"; + } +

Example: "pkgs.dwm-status.override { enableAlsaUtils = false; }"

Declared by:

@@ -9831,18 +10026,13 @@ desired. } -

Example:

{
-  separator = "#";
-
-  battery = {
-    notifier_levels = [ 2 5 10 15 20 ];
-  };
-
-  time = {
-    format = "%H:%M";
-  };
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n separator = \"#\";\n\n battery = {\n notifier_levels = [ 2 5 10 15 20 ];\n };\n\n time = {\n format = \"%H:%M\";\n };\n}\n"; + } + +

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"s

Declared by:

<home-manager/modules/services/dwm-status.nix> @@ -9870,9 +10060,11 @@ Will likely need to launch easyeffects to initially create preset.

Declared by:

<home-manager/modules/services/emacs.nix>
services.emacs.package

The Emacs package to use.

Type: package

Default: - if config.programs.emacs.enable then config.programs.emacs.finalPackage -else pkgs.emacs - + + { + _type = "literalExpression"; text = "if config.programs.emacs.enable then config.programs.emacs.finalPackage\nelse pkgs.emacs\n"; + } +

Declared by:

<home-manager/modules/services/emacs.nix>
services.emacs.client.enable

Whether to enable generation of Emacs client desktop file.

Type: boolean

Default: @@ -9932,11 +10124,13 @@ else pkgs.emacs } -

Example:

{
-  ETESYNC_LISTEN_ADDRESS = "localhost";
-  ETESYNC_LISTEN_PORT = 37358;
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n ETESYNC_LISTEN_ADDRESS = \"localhost\";\n ETESYNC_LISTEN_PORT = 37358;\n}\n"; + } + +

Declared by:

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

Whether to enable Flameshot.

Type: boolean

Default: false @@ -9986,7 +10180,11 @@ else pkgs.emacs

Declared by:

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

Package providing fnott.

Type: package

Default: - pkgs.fnott + + { + _type = "literalExpression"; text = "pkgs.fnott"; + } +

Declared by:

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

Path to the configuration file read by fnott. @@ -10029,18 +10227,13 @@ for an example configuration. } -

Example:

{
-  main = {
-    notification-margin = 5;
-  };
-
-  low = {
-    timeout = 5;
-    title-font = "Dina:weight=bold:slant=italic";
-    title-color = "ffffff";
-  };
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n main = {\n notification-margin = 5;\n };\n\n low = {\n timeout = 5;\n title-font = \"Dina:weight=bold:slant=italic\";\n title-color = \"ffffff\";\n };\n}\n"; + } + +

Declared by:

<home-manager/modules/services/fnott.nix>
services.gammastep.enable

Whether to enable Gammastep.

Type: boolean

Default: false @@ -10050,7 +10243,11 @@ for an example configuration. <home-manager/modules/services/redshift-gammastep/gammastep.nix>

services.gammastep.package

Gammastep derivation to use.

Type: package

Default: - pkgs.gammastep + + { + _type = "literalExpression"; text = "pkgs.gammastep"; + } +

Declared by:

<home-manager/modules/services/redshift-gammastep/gammastep.nix>
services.gammastep.dawnTime

Set the time interval of dawn manually. @@ -10100,15 +10297,13 @@ Available options for Gammastep described in } -

Example:

{
-  general = {
-    adjustment-method = "randr";
-  };
-  randr = {
-    screen = 0;
-  };
-};
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n general = {\n adjustment-method = \"randr\";\n };\n randr = {\n screen = 0;\n };\n};\n"; + } + +

Declared by:

<home-manager/modules/services/redshift-gammastep/gammastep.nix>
services.gammastep.temperature.day

Colour temperature to use during the day, between 1000 and 25000 K. @@ -10155,7 +10350,11 @@ permanently for a password. <home-manager/modules/services/git-sync.nix>

services.git-sync.package

Package containing the git-sync program.

Type: package

Default: - pkgs.git-sync + + { + _type = "literalExpression"; text = "pkgs.git-sync"; + } +

Declared by:

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

The repositories that should be synchronized. @@ -10328,31 +10527,13 @@ key in ~/.config/grobi.conf. ] -

Example:

[
-  {
-    name = "Home";
-    outputs_connected = [ "DP-2" ];
-    configure_single = "DP-2";
-    primary = true;
-    atomic = true;
-    execute_after = [
-      "${pkgs.xorg.xrandr}/bin/xrandr --dpi 96"
-      "${pkgs.xmonad-with-packages}/bin/xmonad --restart";
-    ];
-  }
-  {
-    name = "Mobile";
-    outputs_disconnected = [ "DP-2" ];
-    configure_single = "eDP-1";
-    primary = true;
-    atomic = true;
-    execute_after = [
-      "${pkgs.xorg.xrandr}/bin/xrandr --dpi 120"
-      "${pkgs.xmonad-with-packages}/bin/xmonad --restart";
-    ];
-  }
-]
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "[\n {\n name = \"Home\";\n outputs_connected = [ \"DP-2\" ];\n configure_single = \"DP-2\";\n primary = true;\n atomic = true;\n execute_after = [\n \"\${pkgs.xorg.xrandr}/bin/xrandr --dpi 96\"\n \"\${pkgs.xmonad-with-packages}/bin/xmonad --restart\";\n ];\n }\n {\n name = \"Mobile\";\n outputs_disconnected = [ \"DP-2\" ];\n configure_single = \"eDP-1\";\n primary = true;\n atomic = true;\n execute_after = [\n \"\${pkgs.xorg.xrandr}/bin/xrandr --dpi 120\"\n \"\${pkgs.xmonad-with-packages}/bin/xmonad --restart\";\n ];\n }\n]\n"; + } + +

Declared by:

<home-manager/modules/services/grobi.nix>
services.hound.enable

Whether to enable hound.

Type: boolean

Default: false @@ -10378,14 +10559,13 @@ key in ~/.config/grobi.conf. } -

Example:

{
-  SomeGitRepo = {
-    url = "https://www.github.com/YourOrganization/RepoOne.git";
-    ms-between-poll = 10000;
-    exclude-dot-files = true;
-  };
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n SomeGitRepo = {\n url = \"https://www.github.com/YourOrganization/RepoOne.git\";\n ms-between-poll = 10000;\n exclude-dot-files = true;\n };\n}\n"; + } + +

Declared by:

<home-manager/modules/services/hound.nix>
services.imapnotify.enable

Whether to enable imapnotify.

Type: boolean

Default: false @@ -10401,7 +10581,11 @@ key in ~/.config/grobi.conf. <home-manager/modules/services/kanshi.nix>

services.kanshi.package

kanshi derivation to use.

Type: package

Default: - pkgs.kanshi + + { + _type = "literalExpression"; text = "pkgs.kanshi"; + } +

Declared by:

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

Extra configuration lines to append to the kanshi @@ -10417,25 +10601,13 @@ configuration file. } -

Example:

undocked = {
-  outputs = [
-    {
-      criteria = "eDP-1";
-    }
-  ];
-};
-docked = {
-  outputs = [
-    {
-      criteria = "eDP-1";
-    }
-    {
-      criteria = "Some Company ASDF 4242";
-      transform = "90";
-    }
-  ];
-};
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "undocked = {\n outputs = [\n {\n criteria = \"eDP-1\";\n }\n ];\n};\ndocked = {\n outputs = [\n {\n criteria = \"eDP-1\";\n }\n {\n criteria = \"Some Company ASDF 4242\";\n transform = \"90\";\n }\n ];\n};\n"; + } + +

Declared by:

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

Commands executed after the profile is succesfully applied. Note that if you provide multiple commands, they will be @@ -10579,7 +10751,11 @@ space.

Declared by:

<home-manager/modules/services/lorri.nix>
services.lorri.package

Which lorri package to install.

Type: package

Default: - pkgs.lorri + + { + _type = "literalExpression"; text = "pkgs.lorri"; + } +

Declared by:

<home-manager/modules/services/lorri.nix>
services.mbsync.enable

Whether to enable mbsync.

Type: boolean

Default: @@ -10589,8 +10765,18 @@ space.

Declared by:

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

The package to use for the mbsync binary.

Type: package

Default: - pkgs.isync -

Example:

pkgs.isync

Declared by:

+ + { + _type = "literalExpression"; text = "pkgs.isync"; + } + +

Example: + + { + _type = "literalExpression"; text = "pkgs.isync"; + } + +

Declared by:

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

Optional configuration file to link to use instead of the default file (~/.mbsyncrc). @@ -10694,7 +10880,11 @@ Use any to listen on all addresses.

Declared by:

<home-manager/modules/services/mpdris2.nix>
services.mpdris2.package

The mpDris2 package to use.

Type: package

Default: - pkgs.mpdris2 + + { + _type = "literalExpression"; text = "pkgs.mpdris2"; + } +

Declared by:

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

The address where MPD is listening for connections.

Type: string

Default: @@ -10738,13 +10928,13 @@ Use any to listen on all addresses. } -

Example:

{
-  server = {
-    frequency = "*:0/10";
-    remote.host = "server.tld";
-  };
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n server = {\n frequency = \"*:0/10\";\n remote.host = \"server.tld\";\n };\n}\n"; + } + +

Declared by:

<home-manager/modules/services/muchsync.nix>
services.muchsync.remotes.<name>.frequency

How often to run muchsync. This value is passed to the systemd timer configuration as the @@ -10839,7 +11029,11 @@ special characters including spaces may need to be escaped.

Declared by:

<home-manager/modules/services/nextcloud-client.nix>
services.nextcloud-client.package

The package to use for the nextcloud client binary.

Type: package

Default: - pkgs.nextcloud-client + + { + _type = "literalExpression"; text = "pkgs.nextcloud-client"; + } +

Declared by:

<home-manager/modules/services/nextcloud-client.nix>
services.nextcloud-client.startInBackground

Whether to start the Nextcloud client in the background.

Type: boolean

Default: @@ -10854,7 +11048,11 @@ special characters including spaces may need to be escaped. <home-manager/modules/services/notify-osd.nix>

services.notify-osd.package

Package containing the notify-osd program.

Type: package

Default: - pkgs.notify-osd + + { + _type = "literalExpression"; text = "pkgs.notify-osd"; + } +

Declared by:

<home-manager/modules/services/notify-osd.nix>
services.owncloud-client.enable

Whether to enable Owncloud Client.

Type: boolean

Default: @@ -10870,7 +11068,11 @@ special characters including spaces may need to be escaped.

Declared by:

<home-manager/modules/services/pantalaimon.nix>
services.pantalaimon.package

Package providing the pantalaimon executable to use.

Type: package

Default: - pkgs.pantalaimon + + { + _type = "literalExpression"; text = "pkgs.pantalaimon"; + } +

Declared by:

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

Configuration written to @@ -10880,19 +11082,18 @@ See pantalaimon(5) for options.

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

Default: - { } -

Example:

{
-  Default = {
-    LogLevel = "Debug";
-    SSL = true;
-  };
-  local-matrix = {
-    Homeserver = "https://matrix.org";
-    ListenAddress = "127.0.0.1";
-    ListenPort = 8008;
-  };
-}
-

Declared by:

+ + { + _type = "literalExpression"; text = "{ }"; + } + +

Example: + + { + _type = "literalExpression"; text = "{\n Default = {\n LogLevel = \"Debug\";\n SSL = true;\n };\n local-matrix = {\n Homeserver = \"https://matrix.org\";\n ListenAddress = \"127.0.0.1\";\n ListenPort = 8008;\n };\n}\n"; + } + +

Declared by:

<home-manager/modules/services/pantalaimon.nix>
services.parcellite.enable

Whether to enable Parcellite.

Type: boolean

Default: false @@ -10901,8 +11102,18 @@ for options.

Declared by:

<home-manager/modules/services/parcellite.nix>
services.parcellite.package

Parcellite derivation to use.

Type: package

Default: - pkgs.parcellite -

Example:

pkgs.clipit

Declared by:

+ + { + _type = "literalExpression"; text = "pkgs.parcellite"; + } + +

Example: + + { + _type = "literalExpression"; text = "pkgs.clipit"; + } + +

Declared by:

<home-manager/modules/services/parcellite.nix>
services.pass-secret-service.enable

Whether to enable Pass libsecret service.

Type: boolean

Default: false @@ -10970,8 +11181,18 @@ password are escaped. <home-manager/modules/services/picom.nix>

services.picom.package

picom derivation to use.

Type: package

Default: - pkgs.picom -

Example:

pkgs.picom

Declared by:

+ + { + _type = "literalExpression"; text = "pkgs.picom"; + } + +

Example: + + { + _type = "literalExpression"; text = "pkgs.picom"; + } + +

Declared by:

<home-manager/modules/services/picom.nix>
services.picom.activeOpacity

Opacity of active windows.

Type: string

Default: @@ -11191,7 +11412,11 @@ man page for more examples.

Declared by:

<home-manager/modules/services/playerctld.nix>
services.playerctld.package

The playerctl package to use.

Type: package

Default: - pkgs.playerctl + + { + _type = "literalExpression"; text = "pkgs.playerctl"; + } +

Declared by:

<home-manager/modules/services/playerctld.nix>
services.polybar.enable

Whether to enable Polybar status bar.

Type: boolean

Default: @@ -11201,14 +11426,18 @@ man page for more examples.

Declared by:

<home-manager/modules/services/polybar.nix>
services.polybar.package

Polybar package to install.

Type: package

Default: - pkgs.polybar -

Example:

pkgs.polybar.override {
-  i3GapsSupport = true;
-  alsaSupport = true;
-  iwSupport = true;
-  githubSupport = true;
-}
-

Declared by:

+ + { + _type = "literalExpression"; text = "pkgs.polybar"; + } + +

Example: + + { + _type = "literalExpression"; text = "pkgs.polybar.override {\n i3GapsSupport = true;\n alsaSupport = true;\n iwSupport = true;\n githubSupport = true;\n}\n"; + } + +

Declared by:

<home-manager/modules/services/polybar.nix>
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. @@ -11219,24 +11448,13 @@ See also services.polybar.settings for a more nix-fr } -

Example:

{
-  "bar/top" = {
-    monitor = "\${env:MONITOR:eDP1}";
-    width = "100%";
-    height = "3%";
-    radius = 0;
-    modules-center = "date";
-  };
-
-  "module/date" = {
-    type = "internal/date";
-    internal = 5;
-    date = "%d.%m.%y";
-    time = "%H:%M";
-    label = "%time%  %date%";
-  };
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n \"bar/top\" = {\n monitor = \"\\\${env:MONITOR:eDP1}\";\n width = \"100%\";\n height = \"3%\";\n radius = 0;\n modules-center = \"date\";\n };\n\n \"module/date\" = {\n type = \"internal/date\";\n internal = 5;\n date = \"%d.%m.%y\";\n time = \"%H:%M\";\n label = \"%time% %date%\";\n };\n}\n"; + } + +

Declared by:

<home-manager/modules/services/polybar.nix>
services.polybar.extraConfig

Additional configuration to add.

Type: strings concatenated with "\n"

Default: "" @@ -11296,17 +11514,13 @@ click-right=pavucontrol & } -

Example:

{
-  "module/volume" = {
-    type = "internal/pulseaudio";
-    format.volume = "<ramp-volume> <label-volume>";
-    label.muted.text = "🔇";
-    label.muted.foreground = "#666";
-    ramp.volume = ["🔈" "🔉" "🔊"];
-    click.right = "pavucontrol &";
-  };
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n \"module/volume\" = {\n type = \"internal/pulseaudio\";\n format.volume = \"<ramp-volume> <label-volume>\";\n label.muted.text = \"🔇\";\n label.muted.foreground = \"#666\";\n ramp.volume = [\"🔈\" \"🔉\" \"🔊\"];\n click.right = \"pavucontrol &\";\n };\n}\n"; + } + +

Declared by:

<home-manager/modules/services/polybar.nix>
services.poweralertd.enable

Whether to enable the Upower-powered power alerterd.

Type: boolean

Default: false @@ -11326,7 +11540,11 @@ to your system configuration for the daemon to work correctly.

Declared by:

<home-manager/modules/services/pulseeffects.nix>
services.pulseeffects.package

Pulseeffects package to use.

Type: package

Default: - pkgs.pulseeffects-legacy + + { + _type = "literalExpression"; text = "pkgs.pulseeffects-legacy"; + } +

Declared by:

<home-manager/modules/services/pulseeffects.nix>
services.pulseeffects.preset

Which preset to use when starting pulseeffects. @@ -11383,7 +11601,11 @@ as a duration understood by systemd. <home-manager/modules/services/redshift-gammastep/redshift.nix>

services.redshift.package

Redshift derivation to use.

Type: package

Default: - pkgs.redshift + + { + _type = "literalExpression"; text = "pkgs.redshift"; + } +

Declared by:

<home-manager/modules/services/redshift-gammastep/redshift.nix>
services.redshift.dawnTime

Set the time interval of dawn manually. @@ -11433,15 +11655,13 @@ Available options for Redshift described in } -

Example:

{
-  redshift = {
-    adjustment-method = "randr";
-  };
-  randr = {
-    screen = 0;
-  };
-};
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n redshift = {\n adjustment-method = \"randr\";\n };\n randr = {\n screen = 0;\n };\n};\n"; + } + +

Declared by:

<home-manager/modules/services/redshift-gammastep/redshift.nix>
services.redshift.temperature.day

Colour temperature to use during the day, between 1000 and 25000 K. @@ -11536,8 +11756,18 @@ No effect if xautolock.enable is false.

services.spotifyd.package

The spotifyd package to use. Can be used to specify extensions.

Type: package

Default: - pkgs.spotifyd -

Example:

(pkgs.spotifyd.override { withKeyring = true; })

Declared by:

+ + { + _type = "literalExpression"; text = "pkgs.spotifyd"; + } + +

Example: + + { + _type = "literalExpression"; text = "(pkgs.spotifyd.override { withKeyring = true; })"; + } + +

Declared by:

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

Configuration for spotifyd

Type: TOML value

Default: @@ -11545,14 +11775,13 @@ Can be used to specify extensions. } -

Example:

{
-  global = {
-    username = "Alex";
-    password = "foo";
-    device_name = "nix";
-  };
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n global = {\n username = \"Alex\";\n password = \"foo\";\n device_name = \"nix\";\n };\n}\n"; + } + +

Declared by:

<home-manager/modules/services/spotifyd.nix>
services.stalonetray.enable

Whether to enable Stalonetray system tray.

Type: boolean

Default: false @@ -11561,8 +11790,18 @@ Can be used to specify extensions.

Declared by:

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

The package to use for the Stalonetray binary.

Type: package

Default: - pkgs.stalonetray -

Example:

pkgs.stalonetray

Declared by:

+ + { + _type = "literalExpression"; text = "pkgs.stalonetray"; + } + +

Example: + + { + _type = "literalExpression"; text = "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 integers

Default: @@ -11596,8 +11835,18 @@ background "#cccccc"

Declared by:

<home-manager/modules/services/status-notifier-watcher.nix>
services.status-notifier-watcher.package

The package to use for the status notifier watcher binary.

Type: package

Default: - pkgs.haskellPackages.status-notifier-item -

Example:

pkgs.haskellPackages.status-notifier-item

Declared by:

+ + { + _type = "literalExpression"; text = "pkgs.haskellPackages.status-notifier-item"; + } + +

Example: + + { + _type = "literalExpression"; text = "pkgs.haskellPackages.status-notifier-item"; + } + +

Declared by:

<home-manager/modules/services/status-notifier-watcher.nix>
services.sxhkd.enable

Whether to enable simple X hotkey daemon.

Type: boolean

Default: false @@ -11611,9 +11860,13 @@ background "#cccccc" <home-manager/modules/services/sxhkd.nix>

services.sxhkd.extraConfig

Additional configuration to add.

Type: strings concatenated with "\n"

Default: "" -

Example:

super + {_,shift +} {1-9,0}
-  i3-msg {workspace,move container to workspace} {1-10}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "super + {_,shift +} {1-9,0}\n i3-msg {workspace,move container to workspace} {1-10}\n"; + } + +

Declared by:

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

Command line arguments to invoke sxhkd with.

Type: list of strings

Default: @@ -11621,7 +11874,13 @@ background "#cccccc" ] -

Example:

[ "-m 1" ]

Declared by:

+

Example: + + { + _type = "literalExpression"; text = ''[ "-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 strings

Default: @@ -11629,11 +11888,13 @@ background "#cccccc" } -

Example:

{
-  "super + shift + {r,c}" = "i3-msg {restart,reload}";
-  "super + {s,w}"         = "i3-msg {stacking,tabbed}";
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n \"super + shift + {r,c}\" = \"i3-msg {restart,reload}\";\n \"super + {s,w}\" = \"i3-msg {stacking,tabbed}\";\n}\n"; + } + +

Declared by:

<home-manager/modules/services/sxhkd.nix>
services.syncthing.enable

Whether to enable Syncthing continuous file synchronization.

Type: boolean

Default: false @@ -11656,8 +11917,18 @@ background "#cccccc"

Declared by:

<home-manager/modules/services/taffybar.nix>
services.taffybar.package

The package to use for the Taffybar binary.

Type: package

Default: - pkgs.taffybar -

Example:

pkgs.taffybar

Declared by:

+ + { + _type = "literalExpression"; text = "pkgs.taffybar"; + } + +

Example: + + { + _type = "literalExpression"; text = "pkgs.taffybar"; + } + +

Declared by:

<home-manager/modules/services/taffybar.nix>
services.tahoe-lafs.enable

Whether to enable Tahoe-LAFS.

Type: boolean

Default: false @@ -11687,8 +11958,18 @@ for more information about the format.

Declared by:

<home-manager/modules/services/trayer.nix>
services.trayer.package

The package to use for the trayer binary.

Type: package

Default: - pkgs.trayer -

Example:

pkgs.trayer

Declared by:

+ + { + _type = "literalExpression"; text = "pkgs.trayer"; + } + +

Example: + + { + _type = "literalExpression"; text = "pkgs.trayer"; + } + +

Declared by:

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

Trayer configuration as a set of attributes. Further details can be found at https://github.com/sargon/trayer-srg. @@ -11700,13 +11981,13 @@ found at Example:

{
-  edge = "top";
-  padding = 6;
-  SetDockType = true;
-  tint = "0x282c34";
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n edge = \"top\";\n padding = 6;\n SetDockType = true;\n tint = \"0x282c34\";\n}\n"; + } + +

Declared by:

<home-manager/modules/services/trayer.nix>
services.udiskie.enable

Whether to enable udiskie mount daemon.

Type: boolean

Default: false @@ -11739,7 +12020,11 @@ The options are

Declared by:

<home-manager/modules/services/unclutter.nix>
services.unclutter.package

unclutter derivation to use.

Type: package

Default: - pkgs.unclutter-xfixes + + { + _type = "literalExpression"; text = "pkgs.unclutter-xfixes"; + } +

Declared by:

<home-manager/modules/services/unclutter.nix>
services.unclutter.extraOptions

More arguments to pass to the unclutter command.

Type: list of strings

Default: @@ -11777,13 +12062,13 @@ The options are } -

Example:

{
-  roots = [
-    "/home/user/documents"
-    "ssh://remote/documents"
-  ];
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n roots = [\n \"/home/user/documents\"\n \"ssh://remote/documents\"\n ];\n}\n"; + } + +

Declared by:

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

Additional command line options as a dictionary to pass to the unison program. @@ -11800,11 +12085,13 @@ for a list of available options.

Declared by:

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

Pair of roots to synchronise. -

Type: list of strings of length 2

Example:

[
-  "/home/user/documents"
-  "ssh://remote/documents"
-]
-

Declared by:

+

Type: list of strings of length 2

Example: + + { + _type = "literalExpression"; text = "[\n \"/home/user/documents\"\n \"ssh://remote/documents\"\n]\n"; + } + +

Declared by:

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

Unison state directory to use.

Type: path

Default: @@ -11819,7 +12106,11 @@ for a list of available options. <home-manager/modules/services/volnoti.nix>

services.volnoti.package

Package containing the volnoti program.

Type: package

Default: - pkgs.volnoti + + { + _type = "literalExpression"; text = "pkgs.volnoti"; + } +

Declared by:

<home-manager/modules/services/volnoti.nix>
services.wlsunset.enable

Whether to enable Whether to enable wlsunset..

Type: boolean

Default: @@ -11914,7 +12205,11 @@ generate a key event. Default is 500 ms.

services.xembed-sni-proxy.package

Package containing the xembedsniproxy program.

Type: package

Default: - pkgs.plasma-workspace + + { + _type = "literalExpression"; text = "pkgs.plasma-workspace"; + } +

Declared by:

<home-manager/modules/services/xembed-sni-proxy.nix>
services.xidlehook.enable

Whether to enable xidlehook systemd service.

Type: boolean

Default: @@ -11935,10 +12230,13 @@ These options are passed unescaped as export name=value

Example:

{
-  "primary-display" = "$(xrandr | awk '/ primary/{print $1}')";
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n \"primary-display\" = \"\$(xrandr | awk '/ primary/{print \$1}')\";\n}\n"; + } + +

Declared by:

<home-manager/modules/services/xidlehook.nix>
services.xidlehook.not-when-audio

Disable locking when audio is playing.

Type: boolean

Default: false @@ -11969,20 +12267,13 @@ in the environment section. ] -

Example:

[
-  {
-    delay = 60;
-    command = "xrandr --output \"$PRIMARY_DISPLAY\" --brightness .1";
-    canceller = "xrandr --output \"$PRIMARY_DISPLAY\" --brightness 1";
-  }
-  {
-    delay = 120;
-    command = "${pkgs.writeShellScript "my-script" ''
-      # A complex script to run
-    ''}";
-  }
-]
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "[\n {\n delay = 60;\n command = \"xrandr --output \\\"\$PRIMARY_DISPLAY\\\" --brightness .1\";\n canceller = \"xrandr --output \\\"\$PRIMARY_DISPLAY\\\" --brightness 1\";\n }\n {\n delay = 120;\n command = \"\${pkgs.writeShellScript \"my-script\" ''\n # A complex script to run\n ''}\";\n }\n]\n"; + } + +

Declared by:

<home-manager/modules/services/xidlehook.nix>
services.xidlehook.timers.*.canceller

Command executed when the user becomes active again. This is only executed if the next timer has not been reached. @@ -11990,14 +12281,24 @@ Path to executables are accepted. The command is automatically escaped.

Type: string

Default: "" -

Example:

${pkgs.libnotify}/bin/notify-send "Idle" "Resuming activity"
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "\${pkgs.libnotify}/bin/notify-send \"Idle\" \"Resuming activity\"\n"; + } + +

Declared by:

<home-manager/modules/services/xidlehook.nix>
services.xidlehook.timers.*.command

Command executed after the idle timeout is reached. Path to executables are accepted. The command is automatically escaped. -

Type: null or string

Example:

${pkgs.libnotify}/bin/notify-send "Idle" "Sleeping in 1 minute"
-

Declared by:

+

Type: null or string

Example: + + { + _type = "literalExpression"; text = "\${pkgs.libnotify}/bin/notify-send \"Idle\" \"Sleeping in 1 minute\"\n"; + } + +

Declared by:

<home-manager/modules/services/xidlehook.nix>
services.xidlehook.timers.*.delay

Time before executing the command.

Type: unsigned integer, meaning >=0

Example: 60 @@ -12032,7 +12333,11 @@ The command is automatically escaped. <home-manager/modules/services/xsettingsd.nix>

services.xsettingsd.package

Package containing the xsettingsd program.

Type: package

Default: - pkgs.xsettingsd + + { + _type = "literalExpression"; text = "pkgs.xsettingsd"; + } +

Declared by:

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

Xsettingsd options for configuration file. See @@ -12044,13 +12349,13 @@ for documentation on these values. } -

Example:

{
-  "Net/ThemeName" = "Numix";
-  "Xft/Antialias" = true;
-  "Xft/Hinting" = true;
-  "Xft/RGBA" = "rgb";
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n \"Net/ThemeName\" = \"Numix\";\n \"Xft/Antialias\" = true;\n \"Xft/Hinting\" = true;\n \"Xft/RGBA\" = \"rgb\";\n}\n"; + } + +

Declared by:

<home-manager/modules/services/xsettingsd.nix>
services.xsuspender.enable

Whether to enable XSuspender.

Type: boolean

Default: false @@ -12232,19 +12537,13 @@ by systemd. More details can be found in } -

Example:

{
-  automount-name = {
-    Unit = {
-      Description = "Example description";
-      Documentation = [ "man:example(1)" "man:example(5)" ];
-    };
-
-    Automount = {
-      …
-    };
-  };
-};
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n automount-name = {\n Unit = {\n Description = \"Example description\";\n Documentation = [ \"man:example(1)\" \"man:example(5)\" ];\n };\n\n Automount = {\n …\n };\n };\n};\n"; + } + +

Declared by:

<home-manager/modules/systemd.nix>
systemd.user.mounts

Definition of systemd per-user mount units. Attributes are merged recursively. @@ -12258,19 +12557,13 @@ by systemd. More details can be found in } -

Example:

{
-  mount-name = {
-    Unit = {
-      Description = "Example description";
-      Documentation = [ "man:example(1)" "man:example(5)" ];
-    };
-
-    Mount = {
-      …
-    };
-  };
-};
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n mount-name = {\n Unit = {\n Description = \"Example description\";\n Documentation = [ \"man:example(1)\" \"man:example(5)\" ];\n };\n\n Mount = {\n …\n };\n };\n};\n"; + } + +

Declared by:

<home-manager/modules/systemd.nix>
systemd.user.paths

Definition of systemd per-user path units. Attributes are merged recursively. @@ -12284,19 +12577,13 @@ by systemd. More details can be found in } -

Example:

{
-  path-name = {
-    Unit = {
-      Description = "Example description";
-      Documentation = [ "man:example(1)" "man:example(5)" ];
-    };
-
-    Path = {
-      …
-    };
-  };
-};
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n path-name = {\n Unit = {\n Description = \"Example description\";\n Documentation = [ \"man:example(1)\" \"man:example(5)\" ];\n };\n\n Path = {\n …\n };\n };\n};\n"; + } + +

Declared by:

<home-manager/modules/systemd.nix>
systemd.user.services

Definition of systemd per-user service units. Attributes are merged recursively. @@ -12310,19 +12597,13 @@ by systemd. More details can be found in } -

Example:

{
-  service-name = {
-    Unit = {
-      Description = "Example description";
-      Documentation = [ "man:example(1)" "man:example(5)" ];
-    };
-
-    Service = {
-      …
-    };
-  };
-};
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n service-name = {\n Unit = {\n Description = \"Example description\";\n Documentation = [ \"man:example(1)\" \"man:example(5)\" ];\n };\n\n Service = {\n …\n };\n };\n};\n"; + } + +

Declared by:

<home-manager/modules/systemd.nix>
systemd.user.servicesStartTimeoutMs

How long to wait for started services to fail until their start is considered successful. The value 0 indicates no timeout. @@ -12359,19 +12640,13 @@ by systemd. More details can be found in } -

Example:

{
-  slices-name = {
-    Unit = {
-      Description = "Example description";
-      Documentation = [ "man:example(1)" "man:example(5)" ];
-    };
-
-    Slices = {
-      …
-    };
-  };
-};
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n slices-name = {\n Unit = {\n Description = \"Example description\";\n Documentation = [ \"man:example(1)\" \"man:example(5)\" ];\n };\n\n Slices = {\n …\n };\n };\n};\n"; + } + +

Declared by:

<home-manager/modules/systemd.nix>
systemd.user.sockets

Definition of systemd per-user socket units. Attributes are merged recursively. @@ -12385,19 +12660,13 @@ by systemd. More details can be found in } -

Example:

{
-  socket-name = {
-    Unit = {
-      Description = "Example description";
-      Documentation = [ "man:example(1)" "man:example(5)" ];
-    };
-
-    Socket = {
-      …
-    };
-  };
-};
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n socket-name = {\n Unit = {\n Description = \"Example description\";\n Documentation = [ \"man:example(1)\" \"man:example(5)\" ];\n };\n\n Socket = {\n …\n };\n };\n};\n"; + } + +

Declared by:

<home-manager/modules/systemd.nix>
systemd.user.startServices

Whether new or changed services that are wanted by active targets should be started. Additionally, stop obsolete services from the @@ -12442,19 +12711,13 @@ by systemd. More details can be found in } -

Example:

{
-  target-name = {
-    Unit = {
-      Description = "Example description";
-      Documentation = [ "man:example(1)" "man:example(5)" ];
-    };
-
-    Target = {
-      …
-    };
-  };
-};
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n target-name = {\n Unit = {\n Description = \"Example description\";\n Documentation = [ \"man:example(1)\" \"man:example(5)\" ];\n };\n\n Target = {\n …\n };\n };\n};\n"; + } + +

Declared by:

<home-manager/modules/systemd.nix>
systemd.user.timers

Definition of systemd per-user timer units. Attributes are merged recursively. @@ -12468,19 +12731,13 @@ by systemd. More details can be found in } -

Example:

{
-  timer-name = {
-    Unit = {
-      Description = "Example description";
-      Documentation = [ "man:example(1)" "man:example(5)" ];
-    };
-
-    Timer = {
-      …
-    };
-  };
-};
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n timer-name = {\n Unit = {\n Description = \"Example description\";\n Documentation = [ \"man:example(1)\" \"man:example(5)\" ];\n };\n\n Timer = {\n …\n };\n };\n};\n"; + } + +

Declared by:

<home-manager/modules/systemd.nix>
systemd.user.tmpfiles.rules

Rules for creating and cleaning up temporary files automatically. See @@ -12758,7 +13015,11 @@ Set to null to not add any Sway package to your path. This should be done if you want to use the NixOS Sway module to install Sway.

Type: null or package

Default: - ${pkgs.sway} + + { + _type = "literalExpression"; text = "\${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: @@ -12777,15 +13038,21 @@ on criteria. } -

Example:

{
-"1: web" = [{ class = "^Firefox$"; }];
-"0: extra" = [{ class = "^Firefox$"; window_role = "About"; }];
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n\"1: web\" = [{ class = \"^Firefox\$\"; }];\n\"0: extra\" = [{ class = \"^Firefox\$\"; window_role = \"About\"; }];\n}\n"; + } + +

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 submodules

Default: - see code + + { + _type = "literalExpression"; text = "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 @@ -12804,8 +13071,11 @@ See 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 = "literalExpression"; text = "null for state version ≥ 20.09, as example otherwise\n"; + } +

Example: { @@ -12815,15 +13085,21 @@ See Declared by:

<home-manager/modules/services/window-managers/i3-sway/sway.nix>
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 - + + { + _type = "literalExpression"; text = "null for state version ≥ 20.09, as example otherwise\n"; + } +

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 - + + { + _type = "literalExpression"; text = "null for state version ≥ 20.09, as example otherwise\n"; + } +

Example: { @@ -12852,8 +13128,11 @@ See 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 = "literalExpression"; text = "null for state version ≥ 20.09, as example otherwise\n"; + } +

Example: { @@ -12865,8 +13144,11 @@ 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 = "literalExpression"; text = "null for state version ≥ 20.09, as example otherwise\n"; + } +

Example: { @@ -12876,15 +13158,21 @@ have focus and is not active.

Declared by:

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

Text color to be used for the separator.

Type: null or string

Default: - null for state version ≥ 20.09, as example otherwise - + + { + _type = "literalExpression"; text = "null for state version ≥ 20.09, as example otherwise\n"; + } +

Example: "#666666"

Declared by:

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

Text color to be used for the statusline.

Type: null or string

Default: - null for state version ≥ 20.09, as example otherwise - + + { + _type = "literalExpression"; text = "null for state version ≥ 20.09, as example otherwise\n"; + } +

Example: "#ffffff"

Declared by:

@@ -12892,8 +13180,11 @@ have focus and is not active.
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 = "literalExpression"; text = "null for state version ≥ 20.09, as example otherwise\n"; + } +

Example: { @@ -12918,16 +13209,20 @@ a window with the urgency hint set. } -

Example:

{
-  names = [ "DejaVu Sans Mono" "FontAwesome5Free" ];
-  style = "Bold Semi-Condensed";
-  size = 11.0;
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n names = [ \"DejaVu Sans Mono\" \"FontAwesome5Free\" ];\n style = \"Bold Semi-Condensed\";\n size = 11.0;\n}\n"; + } + +

Declared by:

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

The default bar mode when 'bar.mode' == 'hide'.

Type: null or one of "hide", "show"

Default: - null for state version ≥ 20.09, as example otherwise - + + { + _type = "literalExpression"; text = "null for state version ≥ 20.09, as example otherwise\n"; + } +

Example: "hide"

Declared by:

@@ -12940,43 +13235,61 @@ to the position of the embedding bar block in the config file.

Declared by:

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

Bar visibility mode.

Type: null or one of "dock", "hide", "invisible"

Default: - null for state version ≥ 20.09, as example otherwise - + + { + _type = "literalExpression"; text = "null for state version ≥ 20.09, as example otherwise\n"; + } +

Example: "dock"

Declared by:

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

The edge of the screen swaybar should show up.

Type: null or one of "top", "bottom"

Default: - null for state version ≥ 20.09, as example otherwise - + + { + _type = "literalExpression"; text = "null for state version ≥ 20.09, as example otherwise\n"; + } +

Example: "bottom"

Declared by:

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

Command that will be used to get status lines.

Type: null or string

Default: - null for state version ≥ 20.09, as example otherwise - + + { + _type = "literalExpression"; text = "null for state version ≥ 20.09, as example otherwise\n"; + } +

Example: "\${pkgs.i3status}/bin/i3status"

Declared by:

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

Where to output tray.

Type: null or string

Default: - null for state version ≥ 20.09, as example otherwise - + + { + _type = "literalExpression"; text = "null for state version ≥ 20.09, as example otherwise\n"; + } +

Example: "primary"

Declared by:

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

Whether workspace buttons should be shown or not.

Type: null or boolean

Default: - null for state version ≥ 20.09, as example otherwise - + + { + _type = "literalExpression"; text = "null for state version ≥ 20.09, as example otherwise\n"; + } +

Example: true

Declared by:

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

Whether workspace numbers should be displayed within the workspace buttons.

Type: null or boolean

Default: - null for state version ≥ 20.09, as example otherwise - + + { + _type = "literalExpression"; text = "null for state version ≥ 20.09, as example otherwise\n"; + } +

Example: true

Declared by:

@@ -13148,12 +13461,13 @@ See Example:

{
-  names = [ "DejaVu Sans Mono" "FontAwesome5Free" ];
-  style = "Bold Semi-Condensed";
-  size = 11.0;
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n names = [ \"DejaVu Sans Mono\" \"FontAwesome5Free\" ];\n style = \"Bold Semi-Condensed\";\n size = 11.0;\n}\n"; + } + +

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: @@ -13250,14 +13564,13 @@ Consider to use lib.mkOptionDefault function to extend default keybindings instead of specifying all of them from scratch.

Type: attribute set of null or strings

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";
-  "${modifier}+Shift+q" = "kill";
-  "${modifier}+d" = "exec ${pkgs.dmenu}/bin/dmenu_path | ${pkgs.dmenu}/bin/dmenu | ${pkgs.findutils}/bin/xargs swaymsg exec --";
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "let\n modifier = config.wayland.windowManager.sway.config.modifier;\nin lib.mkOptionDefault {\n \"\${modifier}+Return\" = \"exec \${pkgs.rxvt-unicode-unwrapped}/bin/urxvt\";\n \"\${modifier}+Shift+q\" = \"kill\";\n \"\${modifier}+d\" = \"exec \${pkgs.dmenu}/bin/dmenu_path | \${pkgs.dmenu}/bin/dmenu | \${pkgs.findutils}/bin/xargs swaymsg exec --\";\n}\n"; + } + +

Declared by:

<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. @@ -13363,12 +13676,13 @@ See Example:

[
-{ command = "systemctl --user restart waybar"; always = true; }
-{ command = "dropbox start"; }
-{ command = "firefox"; }
-]
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "[\n{ command = \"systemctl --user restart waybar\"; always = true; }\n{ command = \"dropbox start\"; }\n{ command = \"firefox\"; }\n]\n"; + } + +

Declared by:

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

Whether to run command on each sway restart.

Type: boolean

Default: false @@ -13430,11 +13744,13 @@ 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 booleans

Example:

{
-  title = "x200: ~/work";
-  floating = true;
-};
-

Declared by:

+

Type: attribute set of string or booleans

Example: + + { + _type = "literalExpression"; text = "{\n title = \"x200: ~/work\";\n floating = true;\n};\n"; + } + +

Declared by:

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

Hide window borders adjacent to the screen edges.

Type: one of "none", "vertical", "horizontal", "both", "smart"

Default: "none" @@ -13625,7 +13941,11 @@ containing that text. <home-manager/modules/misc/xdg.nix>

xdg.configFile.<name>.target

Path to target file relative to xdg.configHome.

Type: string

Default: - <name> + + { + _type = "literalExpression"; text = "<name>"; + } +

Declared by:

<home-manager/modules/misc/xdg.nix>
xdg.configFile.<name>.text

Text of the file. If this option is null then @@ -13690,7 +14010,11 @@ containing that text. <home-manager/modules/misc/xdg.nix>

xdg.dataFile.<name>.target

Path to target file relative to xdg.dataHome.

Type: string

Default: - <name> + + { + _type = "literalExpression"; text = "<name>"; + } +

Declared by:

<home-manager/modules/misc/xdg.nix>
xdg.dataFile.<name>.text

Text of the file. If this option is null then @@ -13714,17 +14038,13 @@ See Example:

{
-  firefox = {
-    name = "Firefox";
-    genericName = "Web Browser";
-    exec = "firefox %U";
-    terminal = false;
-    categories = [ "Application" "Network" "WebBrowser" ];
-    mimeType = [ "text/html" "text/xml" ];
-  };
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n firefox = {\n name = \"Firefox\";\n genericName = \"Web Browser\";\n exec = \"firefox %U\";\n terminal = false;\n categories = [ \"Application\" \"Network\" \"WebBrowser\" ];\n mimeType = [ \"text/html\" \"text/xml\" ];\n };\n}\n"; + } + +

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 strings

Default: null @@ -13768,11 +14088,13 @@ This may override other values. } -

Example:

{
-  Keywords = "calc;math";
-  DBusActivatable = "false";
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n Keywords = \"calc;math\";\n DBusActivatable = \"false\";\n}\n"; + } + +

Declared by:

<home-manager/modules/misc/xdg-desktop-entries.nix>
xdg.desktopEntries.<name>.startupNotify

If true, it is KNOWN that the application will send a "remove" message when started with the DESKTOP_STARTUP_ID @@ -13797,7 +14119,11 @@ and https://specifications.freedesktop.org/mime-apps-spec/mime-apps-spec-latest.html, respectively.

Type: boolean

Default: - true if host platform is Linux, false otherwise + + { + _type = "literalExpression"; text = "true if host platform is Linux, false otherwise"; + } +

Declared by:

<home-manager/modules/misc/xdg-mime.nix>
xdg.mimeApps.enable

Whether to manage $XDG_CONFIG_HOME/mimeapps.list. @@ -13816,11 +14142,13 @@ in the first place. } -

Example:

{
-  "mimetype1" = [ "foo1.desktop" "foo2.desktop" "foo3.desktop" ];
-  "mimetype2" = "foo4.desktop";
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n \"mimetype1\" = [ \"foo1.desktop\" \"foo2.desktop\" \"foo3.desktop\" ];\n \"mimetype2\" = \"foo4.desktop\";\n}\n"; + } + +

Declared by:

<home-manager/modules/misc/xdg-mime-apps.nix>
xdg.mimeApps.associations.removed

Removes associations of applications with mimetypes, as if the .desktop file was not listing this @@ -13850,10 +14178,13 @@ the list is attempted, and so on. } -

Example:

{
-  "mimetype1" = [ "default1.desktop" "default2.desktop" ];
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n \"mimetype1\" = [ \"default1.desktop\" \"default2.desktop\" ];\n}\n"; + } + +

Declared by:

<home-manager/modules/misc/xdg-mime-apps.nix>
xdg.systemDirs.config

Directory names to add to XDG_CONFIG_DIRS in the user session. @@ -13863,7 +14194,13 @@ in the user session. ] -

Example:

[ "/etc/xdg" ]

Declared by:

+

Example: + + { + _type = "literalExpression"; text = ''[ "/etc/xdg" ]''; + } + +

Declared by:

<home-manager/modules/misc/xdg-system-dirs.nix>
xdg.systemDirs.data

Directory names to add to XDG_DATA_DIRS in the user session. @@ -13873,7 +14210,13 @@ in the user session. ] -

Example:

[ "/usr/share" "/usr/local/share" ]

Declared by:

+

Example: + + { + _type = "literalExpression"; text = ''[ "/usr/share" "/usr/local/share" ]''; + } + +

Declared by:

<home-manager/modules/misc/xdg-system-dirs.nix>
xdg.userDirs.enable

Whether to manage $XDG_CONFIG_HOME/user-dirs.dirs.

@@ -13940,15 +14283,13 @@ If this and all other xresources options are ~/.Xresources link is produced.

Type: strings concatenated with "\n"

Default: "" -

Example:

builtins.readFile (
-    pkgs.fetchFromGitHub {
-        owner = "solarized";
-        repo = "xresources";
-        rev = "025ceddbddf55f2eb4ab40b05889148aab9699fc";
-        sha256 = "0lxv37gmh38y9d3l8nbnsm1mskcv10g3i83j0kac0a2qmypv1k9f";
-    } + "/Xresources.dark"
-)
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "builtins.readFile (\n pkgs.fetchFromGitHub {\n owner = \"solarized\";\n repo = \"xresources\";\n rev = \"025ceddbddf55f2eb4ab40b05889148aab9699fc\";\n sha256 = \"0lxv37gmh38y9d3l8nbnsm1mskcv10g3i83j0kac0a2qmypv1k9f\";\n } + \"/Xresources.dark\"\n)\n"; + } + +

Declared by:

<home-manager/modules/xresources.nix>
xresources.path

Path where Home Manager should link the .Xresources file.

Type: string

Default: "\$HOME/.Xresources" @@ -13964,12 +14305,13 @@ If this and all other xresources options are ~/.Xresources link is produced.

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

Default: null -

Example:

{
-  "Emacs*toolBar" = 0;
-  "XTerm*faceName" = "dejavu sans mono";
-  "XTerm*charClass" = [ "37:48" "45-47:48" "58:48" "64:48" "126:48" ];
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n \"Emacs*toolBar\" = 0;\n \"XTerm*faceName\" = \"dejavu sans mono\";\n \"XTerm*charClass\" = [ \"37:48\" \"45-47:48\" \"58:48\" \"64:48\" \"126:48\" ];\n}\n"; + } + +

Declared by:

<home-manager/modules/xresources.nix>
xsession.enable

Whether to enable X Session.

Type: boolean

Default: false @@ -13997,7 +14339,13 @@ custom sizes. null

Declared by:

<home-manager/modules/xcursor.nix> -
xsession.pointerCursor.package

Package providing the cursor theme.

Type: package

Example:

pkgs.vanilla-dmz

Declared by:

+
xsession.pointerCursor.package

Package providing the cursor theme.

Type: package

Example: + + { + _type = "literalExpression"; text = "pkgs.vanilla-dmz"; + } + +

Declared by:

<home-manager/modules/xcursor.nix>
xsession.pointerCursor.defaultCursor

The default cursor file to use within the package.

Type: string

Default: "left_ptr" @@ -14051,7 +14399,11 @@ should write the X session script.

Declared by:

<home-manager/modules/services/window-managers/awesome.nix>
xsession.windowManager.awesome.package

Package to use for running the Awesome WM.

Type: package

Default: - pkgs.awesome + + { + _type = "literalExpression"; text = "pkgs.awesome"; + } +

Declared by:

<home-manager/modules/services/window-managers/awesome.nix>
xsession.windowManager.awesome.luaModules

List of lua packages available for being @@ -14062,7 +14414,13 @@ used in the Awesome configuration. ] -

Example:

[ pkgs.luaPackages.vicious ]

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "[ pkgs.luaPackages.vicious ]"; + } + +

Declared by:

<home-manager/modules/services/window-managers/awesome.nix>
xsession.windowManager.awesome.noArgb

Disable client transparency support, which can be greatly detrimental to performance in some setups @@ -14077,8 +14435,18 @@ detrimental to performance in some setups

Declared by:

<home-manager/modules/services/window-managers/bspwm/default.nix>
xsession.windowManager.bspwm.package

The bspwm package to use.

Type: package

Default: - pkgs.bspwm -

Example:

pkgs.bspwm-unstable

Declared by:

+ + { + _type = "literalExpression"; text = "pkgs.bspwm"; + } + +

Example: + + { + _type = "literalExpression"; text = "pkgs.bspwm-unstable"; + } + +

Declared by:

<home-manager/modules/services/window-managers/bspwm/default.nix>
xsession.windowManager.bspwm.extraConfig

Additional shell commands to be run at the end of the config file.

Type: strings concatenated with "\n"

Default: "" @@ -14110,20 +14478,13 @@ bspc subscribe all > ~/bspc-report.log & } -

Example:

{
-  "Gimp" = {
-    desktop = "^8";
-    state = "floating";
-    follow = true;
-  };
-  "Kupfer.py" = {
-    focus = true;
-  };
-  "Screenkey" = {
-    manage = false;
-  };
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n \"Gimp\" = {\n desktop = \"^8\";\n state = \"floating\";\n follow = true;\n };\n \"Kupfer.py\" = {\n focus = true;\n };\n \"Screenkey\" = {\n manage = false;\n };\n}\n"; + } + +

Declared by:

<home-manager/modules/services/window-managers/bspwm/default.nix>
xsession.windowManager.bspwm.rules.<name>.border

Whether the node should have border.

Type: null or boolean

Default: null @@ -14271,13 +14632,13 @@ The default value allows integration with NixOS' generated xserver configuration Extra actions and commands can be specified in xsession.initExtra.

Type: string

Default: ''test -n "$1" && eval "$@"'' -

Example:

let
-  xmonad = pkgs.xmonad-with-packages.override {
-    packages = self: [ self.xmonad-contrib self.taffybar ];
-  };
-in
-  "${xmonad}/bin/xmonad";
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "let\n xmonad = pkgs.xmonad-with-packages.override {\n packages = self: [ self.xmonad-contrib self.taffybar ];\n };\nin\n \"\${xmonad}/bin/xmonad\";\n"; + } + +

Declared by:

<home-manager/modules/xsession.nix>
xsession.windowManager.i3.enable

Whether to enable i3 window manager..

Type: boolean

Default: false @@ -14288,8 +14649,18 @@ in

xsession.windowManager.i3.package

i3 package to use. 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:

+ + { + _type = "literalExpression"; text = "pkgs.i3"; + } + +

Example: + + { + _type = "literalExpression"; text = "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: @@ -14307,15 +14678,21 @@ on criteria. } -

Example:

{
-"1: web" = [{ class = "^Firefox$"; }];
-"0: extra" = [{ class = "^Firefox$"; window_role = "About"; }];
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n\"1: web\" = [{ class = \"^Firefox\$\"; }];\n\"0: extra\" = [{ class = \"^Firefox\$\"; window_role = \"About\"; }];\n}\n"; + } + +

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 submodules

Default: - see code + + { + _type = "literalExpression"; text = "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 @@ -14334,8 +14711,11 @@ See 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 = "literalExpression"; text = "null for state version ≥ 20.09, as example otherwise\n"; + } +

Example: { @@ -14345,15 +14725,21 @@ See Declared by:

<home-manager/modules/services/window-managers/i3-sway/i3.nix>
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 - + + { + _type = "literalExpression"; text = "null for state version ≥ 20.09, as example otherwise\n"; + } +

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 - + + { + _type = "literalExpression"; text = "null for state version ≥ 20.09, as example otherwise\n"; + } +

Example: { @@ -14382,8 +14768,11 @@ See 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 = "literalExpression"; text = "null for state version ≥ 20.09, as example otherwise\n"; + } +

Example: { @@ -14395,8 +14784,11 @@ 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 = "literalExpression"; text = "null for state version ≥ 20.09, as example otherwise\n"; + } +

Example: { @@ -14406,15 +14798,21 @@ have focus and is not active.

Declared by:

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

Text color to be used for the separator.

Type: null or string

Default: - null for state version ≥ 20.09, as example otherwise - + + { + _type = "literalExpression"; text = "null for state version ≥ 20.09, as example otherwise\n"; + } +

Example: "#666666"

Declared by:

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

Text color to be used for the statusline.

Type: null or string

Default: - null for state version ≥ 20.09, as example otherwise - + + { + _type = "literalExpression"; text = "null for state version ≥ 20.09, as example otherwise\n"; + } +

Example: "#ffffff"

Declared by:

@@ -14422,8 +14820,11 @@ have focus and is not active.
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 = "literalExpression"; text = "null for state version ≥ 20.09, as example otherwise\n"; + } +

Example: { @@ -14448,16 +14849,20 @@ a window with the urgency hint set. } -

Example:

{
-  names = [ "DejaVu Sans Mono" "FontAwesome5Free" ];
-  style = "Bold Semi-Condensed";
-  size = 11.0;
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n names = [ \"DejaVu Sans Mono\" \"FontAwesome5Free\" ];\n style = \"Bold Semi-Condensed\";\n size = 11.0;\n}\n"; + } + +

Declared by:

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

The default bar mode when 'bar.mode' == 'hide'.

Type: null or one of "hide", "show"

Default: - null for state version ≥ 20.09, as example otherwise - + + { + _type = "literalExpression"; text = "null for state version ≥ 20.09, as example otherwise\n"; + } +

Example: "hide"

Declared by:

@@ -14470,43 +14875,61 @@ to the position of the embedding bar block in the config file.

Declared by:

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

Bar visibility mode.

Type: null or one of "dock", "hide", "invisible"

Default: - null for state version ≥ 20.09, as example otherwise - + + { + _type = "literalExpression"; text = "null for state version ≥ 20.09, as example otherwise\n"; + } +

Example: "dock"

Declared by:

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

The edge of the screen i3bar should show up.

Type: null or one of "top", "bottom"

Default: - null for state version ≥ 20.09, as example otherwise - + + { + _type = "literalExpression"; text = "null for state version ≥ 20.09, as example otherwise\n"; + } +

Example: "bottom"

Declared by:

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

Command that will be used to get status lines.

Type: null or string

Default: - null for state version ≥ 20.09, as example otherwise - + + { + _type = "literalExpression"; text = "null for state version ≥ 20.09, as example otherwise\n"; + } +

Example: "\${pkgs.i3status}/bin/i3status"

Declared by:

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

Where to output tray.

Type: null or string

Default: - null for state version ≥ 20.09, as example otherwise - + + { + _type = "literalExpression"; text = "null for state version ≥ 20.09, as example otherwise\n"; + } +

Example: "primary"

Declared by:

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

Whether workspace buttons should be shown or not.

Type: null or boolean

Default: - null for state version ≥ 20.09, as example otherwise - + + { + _type = "literalExpression"; text = "null for state version ≥ 20.09, as example otherwise\n"; + } +

Example: true

Declared by:

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

Whether workspace numbers should be displayed within the workspace buttons.

Type: null or boolean

Default: - null for state version ≥ 20.09, as example otherwise - + + { + _type = "literalExpression"; text = "null for state version ≥ 20.09, as example otherwise\n"; + } +

Example: true

Declared by:

@@ -14667,12 +15090,13 @@ See Example:

{
-  names = [ "DejaVu Sans Mono" "FontAwesome5Free" ];
-  style = "Bold Semi-Condensed";
-  size = 11.0;
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n names = [ \"DejaVu Sans Mono\" \"FontAwesome5Free\" ];\n style = \"Bold Semi-Condensed\";\n size = 11.0;\n}\n"; + } + +

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: @@ -14748,14 +15172,13 @@ Consider to use lib.mkOptionDefault function to extend default keybindings instead of specifying all of them from scratch.

Type: attribute set of null or strings

Default: "Default i3 keybindings." -

Example:

let
-  modifier = config.xsession.windowManager.i3.config.modifier;
-in lib.mkOptionDefault {
-  "${modifier}+Return" = "exec i3-sensible-terminal";
-  "${modifier}+Shift+q" = "kill";
-  "${modifier}+d" = "exec \${pkgs.dmenu}/bin/dmenu_run";
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "let\n modifier = config.xsession.windowManager.i3.config.modifier;\nin lib.mkOptionDefault {\n \"\${modifier}+Return\" = \"exec i3-sensible-terminal\";\n \"\${modifier}+Shift+q\" = \"kill\";\n \"\${modifier}+d\" = \"exec \\\${pkgs.dmenu}/bin/dmenu_run\";\n}\n"; + } + +

Declared by:

<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. @@ -14811,12 +15234,13 @@ See Example:

[
-{ command = "systemctl --user restart polybar"; always = true; notification = false; }
-{ command = "dropbox start"; notification = false; }
-{ command = "firefox"; workspace = "1: web"; }
-];
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "[\n{ command = \"systemctl --user restart polybar\"; always = true; notification = false; }\n{ command = \"dropbox start\"; notification = false; }\n{ command = \"firefox\"; workspace = \"1: web\"; }\n];\n"; + } + +

Declared by:

<home-manager/modules/services/window-managers/i3-sway/i3.nix>
xsession.windowManager.i3.config.startup.*.always

Whether to run command on each i3 restart.

Type: boolean

Default: false @@ -14887,11 +15311,13 @@ 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 booleans

Example:

{
-  title = "x200: ~/work";
-  floating = true;
-};
-

Declared by:

+

Type: attribute set of string or booleans

Example: + + { + _type = "literalExpression"; text = "{\n title = \"x200: ~/work\";\n floating = true;\n};\n"; + } + +

Declared by:

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

Hide window borders adjacent to the screen edges.

Type: one of "none", "vertical", "horizontal", "both", "smart"

Default: "none" @@ -14967,15 +15393,13 @@ 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" ''
-  import XMonad
-  main = xmonad defaultConfig
-      { terminal    = "urxvt"
-      , modMask     = mod4Mask
-      , borderWidth = 3
-      }
-''
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "pkgs.writeText \"xmonad.hs\" ''\n import XMonad\n main = xmonad defaultConfig\n { terminal = \"urxvt\"\n , modMask = mod4Mask\n , borderWidth = 3\n }\n''\n"; + } + +

Declared by:

<home-manager/modules/services/window-managers/xmonad.nix>
xsession.windowManager.xmonad.extraPackages

Extra packages available to GHC when rebuilding xmonad. The value must be a function which receives the attribute set @@ -14983,19 +15407,31 @@ defined in haskellPackages as the sole argument.

Type: unspecified

Default: "self: []" -

Example:

haskellPackages: [
-  haskellPackages.xmonad-contrib
-  haskellPackages.monad-logger
-]
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "haskellPackages: [\n haskellPackages.xmonad-contrib\n haskellPackages.monad-logger\n]\n"; + } + +

Declared by:

<home-manager/modules/services/window-managers/xmonad.nix>
xsession.windowManager.xmonad.haskellPackages

The haskellPackages used to build xmonad 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 = "literalExpression"; text = "pkgs.haskellPackages"; + } + +

Example: + + { + _type = "literalExpression"; text = "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 @@ -15007,12 +15443,12 @@ contents of the files. } -

Example:

{
-  "Tools.hs" = pkgs.writeText "Tools.hs" ''
-     module Tools where
-     screenshot = "scrot"
-   '';
-}
-

Declared by:

+

Example: + + { + _type = "literalExpression"; text = "{\n \"Tools.hs\" = pkgs.writeText \"Tools.hs\" ''\n module Tools where\n screenshot = \"scrot\"\n '';\n}\n"; + } + +

Declared by:

<home-manager/modules/services/window-managers/xmonad.nix>
\ No newline at end of file diff --git a/tools.html b/tools.html index adf14a83..c2ec8c4b 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 | @@ -82,7 +82,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.

@@ -151,7 +151,7 @@ available for immediate garbage collection.

-

Options

+

Options

The tool accepts the options

-A attrPath @@ -259,15 +259,15 @@ --verbose

Activates verbose output. -

Files

+

Files

~/.local/share/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