limbo/cli/docs/config.md
2025-05-17 15:51:17 -03:00

1.9 KiB

Config

Config folder should be located at $HOME/.config/limbo. The config file inside should be named limbo.toml. Optionally you can have a themes folder whithin to store .tmTheme files to be discovered by the CLI on startup.

Describes the Limbo Config file for the CLI\

Note: Colors can be inputted as

  • Rrggbb string -> "#010101"
  • Rgb string -> "#A3F"
  • 256 Ansi Color -> "100"
  • Predefined Color Names:
    • "black"
    • "red"
    • "green"
    • "yellow"
    • "blue"
    • "purple"
    • "cyan"
    • "magenta"
    • "white"
    • "grey"
    • "bright-black"
    • "bright-red"
    • "bright-green"
    • "bright-yellow"
    • "bright-blue"
    • "bright-cyan"
    • "bright-magenta"
    • "bright-white"
    • "dark-red"
    • "dark-green"
    • "dark-yellow"
    • "dark-blue"
    • "dark-magenta"
    • "dark-cyan"
    • "dark-grey"

table

column_colors

Type: List[Color]
Example: ["cyan"]

header_color

Type: Color
Example: "red"

highlight

enable

Type: bool
Example: true

theme

Type: String
Example: "base16-ocean.dark"

Preloaded themes:

  • base16-ocean.dark
  • base16-eighties.dark
  • base16-mocha.dark
  • base16-ocean.light

You can reference a custom theme in your themes folder directly by name from the config file.

Example:

Folder structure

limbo
├── limbo.toml
└── themes
    └── Amy.tmTheme

limbo.toml

[highlight]
theme = "Amy"

prompt

Type: Color
Example: "green"

hint

Type: Color
Example: "grey"

candidate

Type: Color
Example: "yellow"

Example limbo.toml

[table]
column_colors = ["cyan", "black", "#010101"]
header_color = "red"

[highlight]
enable = true
prompt = "bright-blue"
theme = "base16-ocean.light"
hint = "123"
candidate = "dark-yellow"