Skip to content

chart_bar

  • Accepts: bars
  • Animates: no
OptionTypeRequiredDefaultDescription
horizontalboolnofalseOrient bars horizontally instead of vertical. Useful for wide/narrow widget slots.
stackedboolnofalsePlaceholder — the current Bars shape is single-series, so this is a no-op until the shape gains series support. Accepted so configs stay forward-compatible.
max_barspositive integernoall barsCap on rendered bars, keeping the top N by value. Omit to render every bar.
bar_widthcells (u16)no3 for vertical, 1 for horizontalThickness of each bar along the axis perpendicular to its growth. Horizontal bars default to 1 cell so several fit into a compact slot without stacking tall; vertical bars default to 3 so labels under them have room.

Overridable via the [theme] section of config.toml.

KeyDescription
textPrimary body text colour for plain renderers (text_plain, text_ascii, list_plain, animated_typewriter). The top step of the chrome ladder — brighter than text_secondary, reads as diffuse daylight on the ocean surface. Set text = "reset" to inherit the terminal's own foreground instead.
ShapeFetchers
barsbasic_read_store, git_contributors, github_contributors_monthly, github_languages, system_disk_usage