Configuration

General

Configuration is done with yaml, a human- and machine-friendly markup language.

The config file is located at $XDG_CONFIG_HOME/kherson/config.yml

If the config does not exist or cannot be loaded, the minimal default hardcoded config is used.

Config structure

Modules:
 - ...
 - ...
Colors:
 - ...
 - ...

Modules

Example with all fields (only Name and Command are mandatory):

 - Name: time
   ForegroundColor: "*green"   # default: "*white"
   BackgroundColor: "#111111"  # default: "*black"
   Pre: "⏰ "                  # default: ""
   Post: " "                   # default: ""
   Command: "date"
   Args: ["+%d.%m.%Y - %R:%S"] # default: []
   Interval: 1                 # default: 1
   Markup: "none"              # default: "none"
   Signal: 2                   # default: 0

Name

Key that is used by i3bar/swaybar and kherson to identify the blocks.

Possible values: any string

ForegroundColor

Text color of the block.

Possible values: any color in hex notation (#123456) / color reference (*red). If color reference is used, the repective color is loaded from the Colors section.

BackgroundColor

Background color of the block.

Possible values: see ForegroundColor

Pre

String added before the block text.

Possible values: any string.

Post

String added after the block text.

Possible values: any string.

Command

Command that is executed to get the block text. The output lines are read similar to i3blocks:

Block text (full_text)
-ignored-
ForegroundColor
BackgroundColor

Possible values: any executable on your system.

Args

Command-line arguments that are passed to the command.

Possible values: any array of any strings.

Interval

How often (in seconds) the command output is re-loaded.

Possible values: any positive integer.

Markup: "none"

Whether i3bar should format the output using markup.

Possible values: none / pango

Signal

Number of signal (SIGRTMIN+n) that can be sent to kherson to reload the block.

Possible values: 1-15

Colors

The colors array is optional, colors are loaded from these locations before (later locations override previous ones):

1. Hardcoded defaults (gruvbox dark theme).
2. Environment. Any environmental variable that starts with COLOR_ is considered a color value. Example: $COLOR_RED is loaded as RED
3. Your config