Hjem Rum Options

rum.environment.hideWarning Link copied!

Type: boolean

Whether to enable a warning for env vars not being implemented.

Default: false
Example: true

rum.misc.gtk.bookmarks Link copied!

Type: list of string

Bookmarks used by GTK file managers (ex. Nautilus). Each entry should have one of the following formats:

  • [uri]
  • [uri] <display name>
Default: [ ]
Example:
[
  "file:///home/user/Documents Documents"
  "file:///home/user/Music Music"
  "file:///home/user/Pictures Pictures"
  "file:///home/user/Videos Videos"
  "file:///home/user/Downloads Downloads"
]

rum.misc.gtk.css.gtk3 Link copied!

Type: strings concatenated with "\n"

CSS to be written to $HOME/.config/gtk-3.0/gtk.css. You can either use this as lines or you can reference a CSS file from your theme’s package (or both).

Default: ""

rum.misc.gtk.css.gtk4 Link copied!

Type: strings concatenated with "\n"

CSS to be written to $HOME/.config/gtk-4.0/gtk.css. You can either use this as lines or you can reference a CSS file from your theme’s package (or both).

Default: ""

rum.misc.gtk.enable Link copied!

Type: boolean

Whether to enable GTK configuration.

Default: false
Example: true

rum.misc.gtk.packages Link copied!

Type: list of package

The list of packages to be installed for gtk themes. This list should consist of any packages that will be used by your GTK theme(s).

Default: [ ]
Example:
[
  (pkgs.catppuccin-papirus-folders.override {
    accent = "rosewater";
    flavor = "mocha";
  })
  pkgs.bibata-cursors
];

rum.misc.gtk.settings Link copied!

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

The settings that will be written to the various gtk files to configure the GTK theme. GTK documentation is perhaps nebulous, but the Arch Wiki entry and the official GTK documentation are decent places to start.

Please note that each option name will have “gtk-” prepended to it, so there is no need to include that on every single option.

Default: { }
Example:
{
  application-prefer-dark-theme = true;
  font-name = "Sans 11";
  theme-name = "Arc-Dark";
}

rum.programs.alacritty.enable Link copied!

Type: boolean

Whether to enable Alacritty.

Default: false
Example: true

rum.programs.alacritty.package Link copied!

Type: package

The alacritty package to use.

Default: pkgs.alacritty

rum.programs.alacritty.settings Link copied!

Type: TOML value

The configuration converted into TOML and written to $HOME/.config/alacritty/alacritty.toml. Please reference Alacritty’s documentation for config options.

Default: { }
Example:
{
  window = {
    dimensions = {
      columns = 101;
      lines = 28;
    };
    padding = {
      x = 6;
      y = 3;
    };
  };
}

rum.programs.bottom.enable Link copied!

Type: boolean

Whether to enable bottom.

Default: false
Example: true

rum.programs.bottom.package Link copied!

Type: package

The bottom package to use.

Default: pkgs.bottom

rum.programs.bottom.settings Link copied!

Type: TOML value

The configuration converted into TOML and written to $HOME/.config/bottom/bottom.toml.

Please reference bottom’s config file documentation for config options.

Default: { }
Example:
{
  flags = {
    battery = true;
    tree = true;
  };
  styles = {
    battery = {
      high_battery_color = "Pink";
    };
  };
}

rum.programs.fish.abbrs Link copied!

Type: attribute set of string

A set of fish abbreviations, they will be set up with the abbr --add fish builtin.

Default: { }

rum.programs.fish.config Link copied!

Type: null or string or absolute path

The main configuration for fish, written verbatim to .config/fish/config.fish.

Default: null

rum.programs.fish.earlyConfigFiles Link copied!

Type: attribute set of (string or absolute path)

Extra configuration files, they will all be written verbatim to .config/fish/conf.d/<name>.fish.

Those files are run before .config/fish/config.fish as per the fish documentation.

Default: { }
Example:
{
  my-aliases = ''
    alias la "ls -la"
    alias ll "ls -l"
  '';
}

rum.programs.fish.enable Link copied!

Type: boolean

Whether to enable fish.

Default: false
Example: true

rum.programs.fish.functions Link copied!

Type: attribute set of (string or absolute path)

A fish function which is being written to .config/fish/functions/<name>.fish.

If the input value is a string, its contents will be wrapped inside of a function declaration, like so:

function <name>;
    <function body>
end

Otherwise you are expected to handle that yourself.

Default: { }
Example:
{
  fish_prompt = pkgs.writers.writeFish "fish_prompt.fish" '\'
      function fish_prompt -d "Write out the prompt"
            # This shows up as USER@HOST /home/user/ >, with the directory colored
            # $USER and $hostname are set by fish, so you can just use them
            # instead of using `whoami` and `hostname`
            printf '%s@%s %s%s%s > ' $USER $hostname \
                (set_color $fish_color_cwd) (prompt_pwd) (set_color normal)
      end
  '\';
  hello-world = '\'
      echo Hello, World!
  '\';
}

rum.programs.fish.package Link copied!

Type: package

The fish package to use.

Default: pkgs.fish

rum.programs.fish.plugins Link copied!

Type: attribute set of absolute path

An attrset of plugins.

In the case where a plugin is a ‘vendored’ plugin, all we are doing is adding that plugin to hjem.users.<name>.packages. As fish automatically discovers those files.

A vendored plugin is denoted by the existence of one of the following files in its derivation:

  • /share/fish/vendor_conf.d
  • /share/fish/vendor_completions.d
  • /share/fish/vendor_functions.d

This will be the case with plugins present in pkgs.fishPlugins.

For the remaining cases, a file will be created at ~/.config/fish/conf.d/rum-plugin-<name>.fish. It will attempt to handle or source a variety of expected files from the derivation. Those files are:

  • /functions: is added to fish_function_path
  • /completions: is added to fish_complete_path
  • /conf.d/*, /key_bindings.fish, /init.fish: sourced in this order

If a plugin seems to not work, verify that it contains one of the aformentioned files.

Default: { }
Example:
{
  inherit (pkgs.fishPlugins) z;
  pisces = pkgs.fetchFromGitHub {
    owner = "laughedelic";
    repo = "pisces";
    tag = "v0.7.0";
    hash = "sha256-Oou2IeNNAqR00ZT3bss/DbhrJjGeMsn9dBBYhgdafBw=";
  };
};

rum.programs.fish.prompt Link copied!

Type: null or string or absolute path

Your fish prompt, written to .config/fish/functions/fish_prompt.fish. It follows the behaviour of rum.programs.fish.functions.

Default: null

rum.programs.foot.enable Link copied!

Type: boolean

Whether to enable foot.

Default: false
Example: true

rum.programs.foot.package Link copied!

Type: package

The foot package to use.

Default: pkgs.foot

rum.programs.foot.settings Link copied!

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

Settings are written as an INI file to $HOME/.config/foot/foot.ini.

Refer to foot.ini(5) or the upstream template for all available options.

Default: { }
Example:
{
  colors = {
    alpha = 0.8;
  };
  main = {
    font = "NotoSansM Nerd Font Mono:size=13";
    term = "xterm-256color";
  };
  mouse = {
    hide-when-typing = "yes";
  };
  scrollback = {
    indicator-position = "none";
    lines = 90000;
  };
}

rum.programs.fuzzel.enable Link copied!

Type: boolean

Whether to enable fuzzel.

Default: false
Example: true

rum.programs.fuzzel.package Link copied!

Type: package

The fuzzel package to use.

Default: pkgs.fuzzel

rum.programs.fuzzel.settings Link copied!

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

Is written to $HOME/fuzzel/fuzzel.ini.

Please reference fuzzel.ini(5) for configuration options.

Default: { }
Example:
{
  colors = {
    background = "ffffffff";
  };
  main = {
    layer = "overlay";
    terminal = "foot";
  };
}

rum.programs.gammastep.enable Link copied!

Type: boolean

Whether to enable gammastep.

Default: false
Example: true

rum.programs.gammastep.package Link copied!

Type: package

The gammastep package to use.

Default: pkgs.gammastep

rum.programs.gammastep.settings Link copied!

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

Settings are written as an INI file to $HOME/.config/gammastep/config.ini. Refer to gammastep’s example configuration all available options.

Default: { }
Example:
{
  general = {
    location-provider = "manual";
    temp-day = 5000;
  };
  manual = {
    lat = -12.5;
    lon = 55.6;
  };
}

rum.programs.ghostty.enable Link copied!

Type: boolean

Whether to enable Ghostty.

Default: false
Example: true

rum.programs.ghostty.package Link copied!

Type: package

The ghostty package to use. You can use an override to configure some settings baked into the package.

Default: pkgs.ghostty
Example:
pkgs.ghostty.override {
  withAdwaita = true;
};

rum.programs.ghostty.settings Link copied!

Type: attribute set of (atom (null, bool, int, float or string) or a list of them for duplicate keys)

The configuration converted to INI and written to $HOME/.config/ghostty/config. Please consult Ghostty’s option reference for configuration options.

Default: { }
Example:
{
  font-size = 10;
  keybind = [
    "ctrl+h=goto_split:left"
    "ctrl+l=goto_split:right"
  ];
  theme = "example-theme";
}

rum.programs.ghostty.themes Link copied!

Type: attribute set of attribute set of (atom (null, bool, int, float or string) or a list of them for duplicate keys)

An attribute set of themes, with the key as the theme name. Please reference Ghostty’s color theme documentation for configuration options.

Default: { }
Example:
{
  example-theme = {
    background = "#303446";
    cursor-color = "#f2d5cf";
    cursor-text = "#c6d0f5";
    foreground = "#c6d0f5";
    palette = [
      "0=#51576d"
      "1=#e78284"
      "2=#a6d189"
      "3=#e5c890"
      "4=#8caaee"
      "5=#f4b8e4"
      "6=#81c8be"
      "7=#a5adce"
      "8=#626880"
      "9=#e67172"
      "10=#8ec772"
      "11=#d9ba73"
      "12=#7b9ef0"
      "13=#f2a4db"
      "14=#5abfb5"
      "15=#b5bfe2"
    ];
    selection-background = "#626880";
    selection-foreground = "#c6d0f5";
  };
}

rum.programs.git.destination Link copied!

Type: one of ".gitconfig", ".config/git/config"

Select your preferred git config location. Do note that options set in $HOME/.gitconfig will shadow anything set in .config/git/config.

Default: ".gitconfig"

rum.programs.git.enable Link copied!

Type: boolean

Whether to enable git.

Default: false
Example: true

rum.programs.git.package Link copied!

Type: package

The git package to use.

Default: pkgs.git

rum.programs.git.settings Link copied!

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

Settings that will be written to your configuration file.

Default: { }
Example:
{
  diff = {
    colorMoved = "default";
  };
  init = {
    defaultBranch = "main";
  };
  merge = {
    conflictstyle = "diff3";
  };
  user = {
    email = "alice@example.com";
    name = "alice";
  };
}

rum.programs.helix.enable Link copied!

Type: boolean

Whether to enable Helix.

Default: false
Example: true

rum.programs.helix.languages Link copied!

Type: TOML value

The languages configurations converted into TOML and written to $HOME/.config/helix/languages.toml. Please reference Helix’s language documentation for config options.

Default: { }
Example:
{
  language-server = {
    vscode-json-language-server = {
      command = "vscode-json-languageserver";
    };
  };
}

rum.programs.helix.package Link copied!

Type: package

The helix package to use.

Default: pkgs.helix

rum.programs.helix.settings Link copied!

Type: TOML value

The editor configuration converted into TOML and written to $HOME/.config/helix/config.toml. Please reference Helix’s documentation for config options.

Default: { }
Example:
{
  editor = {
    editor = {
      statusline = {
        left = [
          "mode"
          "spinner"
        ];
      };
    };
    line-number = "relative";
  };
}

rum.programs.helix.themes Link copied!

Type: attribute set of (TOML value)

The custom themes converted into TOML and written to $HOME/.config/helix/themes/. Please reference Helix’s theming documentation for config options.

Default: { }
Example:
{
  theme1 = {
    palette = {
      black = "#000000";
      white = "#ffffff";
    };
    "ui.background" = "white";
    "ui.text" = "black";
  };
}

rum.programs.hypridle.enable Link copied!

Type: boolean

Whether to enable hypridle.

Default: false
Example: true

rum.programs.hypridle.package Link copied!

Type: package

The hypridle package to use.

Default: pkgs.hypridle

rum.programs.hypridle.settings Link copied!

Type: Hyprland configuration value

Is written to $HOME/hypr/hypridle.conf.

Configuration options can be found on the Hyprland Wiki.

Default: { }
Example:
{
  general = {
    after_sleep_cmd = "notify-send \"Awake!\"";
    before_sleep_cmd = "notify-send \"Zzz\"";
    ignore_dbus_inhibit = false;
    ignore_systemd_inhibit = false;
    lock_cmd = "notify-send \"lock!\"";
    unlock_cmd = "notify-send \"unlock!\"";
  };
  listener = [
    {
      on-resume = "notify-send \"Welcome back!\"";
      on-timeout = "notify-send \"You are idle!\"";
      timeout = 500;
    }
  ];
}

rum.programs.hyprland.enable Link copied!

Type: boolean

Whether to enable Hyprland.

Default: false
Example: true

rum.programs.hyprland.extraConfig Link copied!

Type: strings concatenated with "\n"

Extra configuration that will be appended verbatim at the end of your hyprland.conf.

Default: ""

rum.programs.hyprland.importantPrefixes Link copied!

Type: list of string

List of prefix of attributes to source at the top of the config.

Default: [ "$" "bezier" "name" ]
Example:
[
  "$"
  "bezier"
]

rum.programs.hyprland.plugins Link copied!

Type: list of (package or absolute path)

List of Hyprland plugins to use. Can either be packages or absolute plugin paths.

Default: [ ]

rum.programs.hyprland.settings Link copied!

Type: Hyprland configuration value

Hyprland configuration written in Nix. Entries with the same key should be written as lists. Variables’ and colors’ names should be quoted. See Hyprland’s documentation for more examples.

Default: { }
Example:
{
  "\$mod" = "SUPER";
  decoration = {
    rounding = "3";
  };
}

rum.programs.hyprlock.enable Link copied!

Type: boolean

Whether to enable hyprlock.

Default: false
Example: true

rum.programs.hyprlock.package Link copied!

Type: package

The hyprlock package to use.

Default: pkgs.hyprlock

rum.programs.hyprlock.settings Link copied!

Type: Hyprland configuration value

Is written to $HOME/hypr/hyprlock.conf.

Configuration options can be found on the Hyprland Wiki.

Default: { }
Example:
{
  background = [
    {
      blur_passes = 3;
      blur_size = 8;
      path = "screenshot";
    }
  ];
  general = {
    hide_cursor = true;
    no_fade_in = false;
  };
}

rum.programs.keepassxc.enable Link copied!

Type: boolean

Whether to enable KeePassXC.

Default: false
Example: true

rum.programs.keepassxc.package Link copied!

Type: package

The keepassxc package to use.

Default: pkgs.keepassxc

rum.programs.keepassxc.settings Link copied!

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

Settings are written as an INI file to $HOME/.config/keepassxc/keepassxc.ini. Please reference KeePassXC’s User Guide.

It also can be configured by toggling options through the GUI, but this does not seem documented.

Default: { }
Example:
{
  GUI = {
    ColorPasswords = true;
    MinimizeOnClose = true;
    MinimizeOnStartup = true;
    MinimizeToTray = true;
    ShowTrayIcon = true;
    TrayIconAppearance = "colorful";
  };
  General = {
    BackupBeforeSave = true;
    ConfigVersion = 2;
  };
}

rum.programs.lsd.colors Link copied!

Type: YAML value

Configuration written to $HOME/.config/lsd/colors.yaml, defining the colors used by lsd. Please reference lsd’s color theme example to configure it accordingly.

Default: { }
Example:
{
  group = 187;
  permission = {
    read = "dark_green";
    write = "dark_yellow";
  };
  user = 230;
}

rum.programs.lsd.enable Link copied!

Type: boolean

Whether to enable LSD (LSDeluxe).

Default: false
Example: true

rum.programs.lsd.icons Link copied!

Type: YAML value

Configuration written to $HOME/.config/lsd/icons.yaml, defining the icons used by lsd. Please reference lsd’s icon theme example to configure it accordingly.

Default: { }
Example:
{
  filetype = {
    dir = "📂";
    file = "📄";
    pipe = "📩";
  };
}

rum.programs.lsd.package Link copied!

Type: package

The lsd package to use.

Default: pkgs.lsd

rum.programs.lsd.settings Link copied!

Type: YAML value

Configuration written to $HOME/.config/lsd/config.yaml, defining lsd settings. Please reference lsd’s example configuration to configure it accordingly.

Default: { }
Example:
{
  classic = false;
  color = {
    theme = "default";
  };
}

rum.programs.ncmpcpp.bindings Link copied!

Type: attribute set of list of (submodule)

Custom bindings configuration written to $HOME/.config/ncmpcpp/bindings. Please reference ncmpcpp(1) to configure it accordingly, or consult ncmpcpp’s example bindings file.

The lists are separated between keys, for actions ran on keypresses, and commands, for actions ran on commands. The option’s example demonstrates this greatly.

Default: { }
Example:
{
  commands = [
    {
      actions = [
        "stop"
        "quit"
      ];
      binding = "!sq";
    }
    {
      actions = [
        "quit"
      ];
      binding = "!q";
      deferred = true;
    }
  ];
  keys = [
    {
      actions = [
        "stop"
        "quit"
      ];
      binding = "ctrl-q";
    }
    {
      actions = [
        "quit"
      ];
      binding = "q";
      deferred = true;
    }
  ];
}

rum.programs.ncmpcpp.bindings.<name>.*.actions Link copied!

Type: null or (list of string)

The actions to be ran on either the key’s or command’s activation.

Default: null
Example:
[
  "stop"
  "quit"
]

rum.programs.ncmpcpp.bindings.<name>.*.binding Link copied!

Type: null or string

The key or command for which the set of actions is binded to.

Default: null
Example: "p"

rum.programs.ncmpcpp.bindings.<name>.*.deferred Link copied!

Type: boolean

Whether the binding or command should be deferred (true) or immediate (false).

Default: false
Example: true

rum.programs.ncmpcpp.enable Link copied!

Type: boolean

Whether to enable ncmpcpp, a mpd-based music player..

Default: false
Example: true

rum.programs.ncmpcpp.package Link copied!

Type: package

The ncmpcpp package to use. You can override the package to customize certain settings that are baked into the package.

Default: pkgs.ncmpcpp
Example:
pkgs.ncmpcpp.override {
  # useful overrides in the package
  outputsSupport = true; # outputs screen
  visualizerSupport = false; # visualizer screen
  clockSupport = true; # clock screen
  taglibSupport = true; # tag editor
};

rum.programs.ncmpcpp.settings Link copied!

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

Configuration written to $HOME/.config/ncmpcpp/config. Please reference ncmpcpp(1) to configure it accordingly, or consult ncmpcpp’s example configuration.

Default: { }
Example:
{
  mpd_host = "localhost";
  mpd_music_dir = "~/music";
  mpd_port = 6600;
  statusbar_visibility = true;
}

rum.programs.obs-studio.enable Link copied!

Type: boolean

Whether to enable OBS Studio.

Default: false
Example: true

rum.programs.obs-studio.package Link copied!

Type: package

The obs-studio package to use. You can override the package to install plugins.

Default: pkgs.obs-studio
Example:
# OBS has a special "package" to wrap the obs-studio package with plugins
package = pkgs.wrapOBS.override {
  # These plugins will get installed and wrapped into obs-studio for use
  plugins = with pkgs.obs-studio-plugins; [
    wlrobs
    waveform
    obs-websocket
  ];
};

rum.programs.spotify-player.enable Link copied!

Type: boolean

Whether to enable spotify_player.

Default: false
Example: true

rum.programs.spotify-player.keymap Link copied!

Type: TOML value

Sets of keymaps and actions converted into TOML and written to $HOME/.config/spotify-player/keymap.toml. See example for how to format declarations.

Please reference spotify_player’s keymaps documentation for more information.

Default: { }
Example:
{
  actions = [
    {
      action = "GoToArtist";
      key_sequence = "g A";
    }
  ];
  keymaps = [
    {
      command = "NextTrack";
      key_sequence = "g n";
    }
  ];
}

rum.programs.spotify-player.package Link copied!

Type: package

The spotify-player package to use. You can use an override to configure certain settings baked into the package.

Default: pkgs.spotify-player
Example:
package = pkgs.spotify-player.override {
  # Useful overrides in the package
  withStreaming = true;
  withDaemon = true;
  withAudioBackend = "rodio"; # alsa, pulseaudio, rodio, portaudio, jackaudio, rodiojack, sdl
  withMediaControl = true;
  withImage = true;
  withNotify = true;
  withSixel = true;
  withFuzzy = true;
};

rum.programs.spotify-player.settings Link copied!

Type: TOML value

The configuration converted into TOML and written to $HOME/.config/spotify-player/app.toml.

Please reference spotify_player’s configuration documentation for configuration options.

Default: { }
Example:
{
  device = {
    device_type = "computer";
    name = "nixos";
    normalization = true;
    volume = 40;
  };
  enable_notify = false;
}

rum.programs.spotify-player.themes Link copied!

Type: list of (TOML value)

The theme converted into TOML and written to $HOME/.config/spotify-player/themes.toml.

Please reference spotify_player’s theme documentation for configuration options.

Default: [ ]
Example:
[
  {
    component_style = {
      like = {
        fg = "Red";
        modifiers = [
          "Bold"
        ];
      };
      secondary_row = {
        bg = "#677075";
      };
      selection = {
        bg = "Black";
        fg = "White";
        modifiers = [
          "Bold"
        ];
      };
    };
    name = "default2";
    palette = {
      black = "black";
      blue = "blue";
      bright_black = "bright_black";
      bright_blue = "bright_blue";
      bright_cyan = "bright_cyan";
      bright_green = "bright_green";
      bright_magenta = "bright_magenta";
      bright_red = "bright_red";
      bright_white = "bright_white";
      bright_yellow = "bright_yellow";
      cyan = "cyan";
      green = "green";
      magenta = "magenta";
      red = "red";
      white = "white";
      yellow = "yellow";
    };
  }
]

rum.programs.starship.enable Link copied!

Type: boolean

Whether to enable starship module..

Default: false
Example: true

rum.programs.starship.integrations.zsh.enable Link copied!

Type: boolean

Whether to enable starship integration with zsh.

Default: false
Example: true

rum.programs.starship.package Link copied!

Type: package

The starship package to use.

Default: pkgs.starship

rum.programs.starship.settings Link copied!

Type: TOML value

The configuration converted to TOML and written to $HOME/.config/starship.toml. Please reference Starship’s documentation for configuration options.

Default: { }
Example:
{
  add_newline = false;
  character = {
    error_symbol = "➜";
    success_symbol = "➜";
  };
  format = "$line_break$package$line_break$character";
  scan_timeout = 10;
}

rum.programs.tofi.enable Link copied!

Type: boolean

Whether to enable tofi.

Default: false
Example: true

rum.programs.tofi.package Link copied!

Type: package

The tofi package to use.

Default: pkgs.tofi

rum.programs.tofi.settings Link copied!

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

The configuration converted into “key = value” and written to $HOME/.config/tofi/config. Please reference tofi(5), or see an example at tofi’s default configuration.

Default: { }
Example:
{
  horizontal = false;
  num-results = 0;
  text-color = "#FFFFFF";
}

rum.programs.vscode.enable Link copied!

Type: boolean

Whether to enable Visual Studio Code.

Default: false
Example: true

rum.programs.vscode.package Link copied!

Type: package

The vscode package to use.

Default: pkgs.vscode

rum.programs.vscode.settings Link copied!

Type: JSON value

The configuration converted into JSON and written to $HOME/.config/Code/User/settings.json.

Please reference Visual Studio Code’s official documentation for more information.

Default: { }
Example:
{
  catppuccin = {
    accentColor = "red";
  };
  "editor.fontFamily" = "Fira Code Nerdfont";
  "editor.fontLigatures" = true;
  "workbench.colorTheme" = "Catppuccin Mocha";
}

rum.programs.zsh.enable Link copied!

Type: boolean

Whether to enable zsh.

Default: false
Example: true

rum.programs.zsh.initConfig Link copied!

Type: strings concatenated with "\n"

Commands that will be added verbatim to .zshrc.

A good starting point for learning how to configure zsh is the Arch Wiki entry.

Default: ""

rum.programs.zsh.loginConfig Link copied!

Type: strings concatenated with "\n"

Commands that will be added verbatim to .zlogin.

A good starting point for learning how to configure zsh is the Arch Wiki entry.

Default: ""

rum.programs.zsh.logoutConfig Link copied!

Type: strings concatenated with "\n"

Commands that will be added verbatim to .zlogout.

A good starting point for learning how to configure zsh is the Arch Wiki entry.

Default: ""

rum.programs.zsh.package Link copied!

Type: package

The zsh package to use.

Default: pkgs.zsh

rum.programs.zsh.plugins Link copied!

Type: attribute set of (submodule)

An attrset of plugins to load into zsh. Configuration of the former can be done and is advised to be done at this level, for the sake of organization.

Default: { }

rum.programs.zsh.plugins.<name>.completions Link copied!

Type: list of absolute path

A list of completions that will be loaded into fpath.

Default: [ ]
Example: ["\${pkgs.nix-zsh-completions}/share/zsh/site-functions"]

rum.programs.zsh.plugins.<name>.config Link copied!

Type: strings concatenated with "\n"

Commands that will be added verbatim to .zshrc right after the plugin import..

A good starting point for learning how to configure zsh is the Arch Wiki entry.

Default: ""

rum.programs.zsh.plugins.<name>.source Link copied!

Type: null or absolute path

Path to the plugin file to load.

Default: null
Example: "\${pkgs.nix-zsh-completions}/share/zsh/plugins/nix/nix-zsh-completions-plugin.zsh\"