gauge_thermometer

Vertical mercury tube for Ratio: rounded glass walls with a bulb at the bottom and a mercury column rising from it, with the label and percent on the mid row. The vertical sibling of gauge_line — pick this for tall, narrow slots where height carries the meaning.

Accepts	Animates
ratio	no

Options

Option	Type	Required	Default	Description
label	string	no	payload.label	Optional prefix shown left of the tube on the mid row, e.g. "CPU" → CPU ╭─╮ 32%. Falls back to RatioData.label; omitted when neither is set.
tone	"neutral" | "fill" | "drain"	no	"neutral"	How the mercury colour follows the value. neutral is single theme.text (matches the rest of the gauge_* family). fill treats value as how-full (low → status_error, high → status_ok) — right for quota / progress. drain inverts (high → status_error) — right for system_cpu / system_memory / disk_usage where the ratio is "fraction used".
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).
status_ok	Healthy / passing status (badges, table rows, timeline titles).
status_warn	Degraded / warning status — visually distinct from both ok and error.
status_error	Failing / error status — reserved for attention-grabbing failures.

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_thermometer"