Configuration

Configuration provides application-level settings, as opposed to collection-level settings.

Location & Creation

By default, configuration is stored in a platform-specific configuration directory, according to dirs::config_dir.

PlatformPath
Linux$HOME/.config/slumber/config.yml
MacOS$HOME/Library/Application Support/slumber/config.yml
WindowsC:\Users\<User>\AppData\Roaming\slumber\config.yml

You can also find the config path by running:

slumber show paths

If the config directory doesn't exist yet, Slumber will create it automatically when starting the TUI for the first time.

Note: Prior to version 2.1.0, Slumber stored configuration in a different location on Linux (~/.local/share/slumber/config.yml). If that file exists on your system, it will be used in place of the newer location. For more context, see issue #371.

You can change the location of the config file by setting the environment variable SLUMBER_CONFIG_PATH. For example:

SLUMBER_CONFIG_PATH=~/dotfiles/slumber.yml slumber

Fields

The following fields are available in config.yml:

debug

Type: boolean

Default: false

Enable developer information in the TUI

editor

Type: string

Default: VISUAL/EDITOR env vars, or vim

Command to use when opening files for in-app editing. More info

ignore_certificate_hosts

Type: string

Default: []

Hostnames whose TLS certificate errors will be ignored. More info

input_bindings

Type: mapping[Action, KeyCombination[]]

Default: {}

Override default input bindings. More info

large_body_size

Type: number

Default: 1000000 (1 MB)

Size over which request/response bodies are not formatted/highlighted, for performance (bytes)

preview_templates

Type: boolean

Default: true

Render template values in the TUI? If false, the raw template will be shown.

theme

Type: Theme

Default: {}

Visual customizations for the TUI. More info

pager

Alias: viewer (for historical compatibility)

Type: string

Default: less (Unix), more (Windows)

Command to use when opening files for viewing. More info