lemonbuddy_config(5)

NAME
lemonbuddy_config - Configuration for a lemonbuddy(1) bar.

SYNOPSIS
$XDG_CONFIG_HOME/.config/lemonbuddy/config

~/.config/lemonbuddy/config

SYNTAX

The configuration syntax is based on the ini file format.

A sample config section with various field types:
    [section/name]
    str = My string
    ; Quote the value to keep surrounding spaces
    str = "   My string"
    bool = true
    bool = on
    int = 10
    float = 10.0

Values defined in another section can be referenced using:
    key = ${bar/top.foreground}

Read the value of an environment variable using:
    key = ${env:MYVAR}

Use BAR to target the section of the current bar:
    key = ${BAR.foreground}

Most modules define a format-N field. The formats define a set of tags. For example, the mpd module defines the following formats:
    format-online = ... <label-song> <icon-play> ...
    format-offline = the server is offline

The modules will toggle between the formats and only show the one defined for the current module state.

Each format contains the following fields:
    format[-NAME]-padding    = N (unit: whitespaces)
    format[-NAME]-margin     = N (unit: whitespaces)
    format[-NAME]-spacing    = N (unit: whitespaces)
    format[-NAME]-offset     = N (unit: pixels)
    format[-NAME]-foreground = #aa[rrggbb]
    format[-NAME]-background = #aa[rrggbb]
    format[-NAME]-underline  = #aa[rrggbb]
    format[-NAME]-overline   = #aa[rrggbb]

The rest of the drawtypes follow the same pattern.
    label-NAME[-(foreground|background|(under|over)line|font|padding|maxlen|ellipsis)] = ?
    icon-NAME[-(foreground|background|(under|over)line|font|padding)] = ?
    ramp-NAME-[0-9]+[-(foreground|background|(under|over)line|font|padding)] = ?
    animation-NAME-[0-9]+[-(foreground|background|(under|over)line|font|padding)] = ?
    bar-NAME-width = N (unit: characters)
    bar-NAME-format = (tokens: %fill% %indicator% %empty%)
    bar-NAME-foreground-[0-9]+ = #aarrggbb
    bar-NAME-indicator[-(foreground|background|(under|over)line|font|padding)] =
    bar-NAME-fill[-(foreground|background|(under|over)line|font|padding)] =
    bar-NAME-empty[-(foreground|background|(under|over)line|font|padding)] =

APPLICATION SETTINGS
These settings should exist in the `settings` section within the configuration file.

throttle-limit and throttle-ms
    Limit the amount of update events within a set timeframe. Allow at most throttle-limit updates within throttle-ms milliseconds.

BAR SETTINGS
These settings should be defined in the [bar/BAR-NAME] section.

monitor
    Which display to output the bar to. You can get a list of available outputs by using the command `xrandr -q | grep " connected" | cut -d ' ' -f1`. If unspecified, the application will pick the first one it finds.

width, height
    How large the bar should be. You can specify the values as a percentage of the screen, for example `85%`, or omit the `%` and give the dimension(s) in pixels.

offset-x, offset-y
    The window offset value in pixels.

bottom
    Put the bar at the bottom of the screen.

dock
    If this boolean is set to `true`, then force the X window to dock itself. If you are using i3(1) it is recommended to use the default value.

spacing
    This integer value is used as a multiplier when adding spaces between elements.

lineheight
    How high underlines and overlines should be.

background, foreground, linecolor
    Specify the colors used to draw the bar.

padding-left, padding-right
    Specify the number of spaces to add at the start or end of the entire bar.

module-margin-left, module-margin-right
    Specify the number of spaces to add before or after each module.

font-id
    Here you can specify which fonts you wish to use. You need to set id to be a positive integer. The font should be specified in the following format: `FONT-NAME:size=FONT-SIZE;OFFSET`. For example, you could set `font-0` to be `NotoSans-Regular:size=8;0`.

wm-name
    The value to set WM_NAME to when running. This defaults to `lemonbuddy-BAR-NAME_MONITOR`.

locale
    Which locale to use.

modules-left, modules-center, modules-right
    Define which modules to use in the bar.

EXAMPLES
There are no examples yet.

SEE ALSO

lemonbuddy(1)