Skip to content

Configuration

LazyFire can be configured via a YAML configuration file.

Config File Location

LazyFire searches for config.yaml in:

  1. ~/.lazyfire/config.yaml (recommended)
  2. ./config.yaml (current directory)

Configuration Options

yaml
ui:
  showIcons: true           # Enable/disable icons
  nerdFontsVersion: "3"     # "2", "3", or "" to disable
  theme:
    activeBorderColor: ["#ed8796", "bold"]
    inactiveBorderColor: ["#5f626b"]
    optionsTextColor: ["#8aadf4"]
    selectedLineBgColor: ["#494d64", "bold"]

UI Options

OptionTypeDefaultDescription
showIconsbooltrueShow icons in the UI
nerdFontsVersionstring"3"Nerd Fonts version ("2", "3", or "" to disable)

Theme Colors

Colors can be specified as:

  • Named colors: cyan, blue, red, green, yellow, magenta, white, black, default
  • Hex colors: #ed8796
  • 256-color numbers: 0 to 255
  • Attributes: bold, underline, reverse
OptionDescription
activeBorderColorFocused panel border and title
inactiveBorderColorUnfocused panel borders
optionsTextColorHelp text in footer
selectedLineBgColorHighlighted row background

Example Configurations

Minimal (Disable Icons)

yaml
ui:
  showIcons: false
  nerdFontsVersion: ""

Custom Theme

yaml
ui:
  theme:
    activeBorderColor: ["cyan", "bold"]
    inactiveBorderColor: ["#444444"]
    optionsTextColor: ["green"]
    selectedLineBgColor: ["#333333"]

Catppuccin-style

yaml
ui:
  theme:
    activeBorderColor: ["#f5c2e7", "bold"]
    inactiveBorderColor: ["#6c7086"]
    optionsTextColor: ["#89b4fa"]
    selectedLineBgColor: ["#313244", "bold"]

Default Values

If no config file exists, LazyFire uses these defaults:

yaml
ui:
  showIcons: true
  nerdFontsVersion: "3"
  theme:
    activeBorderColor: ["#ed8796", "bold"]
    inactiveBorderColor: ["#5f626b"]
    optionsTextColor: ["#8aadf4"]
    selectedLineBgColor: ["#494d64", "bold"]

Released under the MIT License.