gauge_line

Single-row progress bar for Ratio: optional label, shaded fill across the available width, and a percent or fraction suffix. The lightest member of the gauge_* family — pick this for dense dashboards where gauge_circle is too tall.

Accepts	Animates
ratio	no

Options

Option	Type	Required	Default	Description
label	string	no	payload.label	Prefix shown before the bar, e.g. "year" → year: ████░░░ 32%. Falls back to RatioData.label when omitted.
value_format	"percent" | "fraction" | "both"	no	"percent"	Suffix format. fraction and both require RatioData.denominator — otherwise they fall back to percent.

Theme tokens

Overridable via the [theme] section of your dashboard config.

Key	Description
text	Primary 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.
text_dim	Barely-visible chrome text: timeline date prefixes, empty-state placeholder, clip hint. Replaces the old Modifier::DIM usage — set an explicit colour so rendering stays consistent across terminals (some render DIM as invisible, some as a no-op).

Compatible fetchers

Shape	Fetchers
ratio	basic_ratio, basic_read_store, claude_subscription, clock_countdown, clock_ratio, code_comments, code_loc, codex_subscription, lastfm_top_albums, lastfm_top_artists, lastfm_top_tracks, linear_cycle, net_interfaces, steam_owned_games, steam_recently_played, system_monitor_battery, system_monitor_cpu, system_monitor_disk, system_monitor_memory, weather_forecast

Preview

ratio

used: ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓░░░░░░░░░░ 67% 

[[widget]]
id = "clock_ratio"
fetcher = "clock_ratio"
render = "gauge_line"