gauge_battery

Battery silhouette for Ratio: framed cell with internal fill bars, a tip cap on the right, and a percent label. Renders as a single-line pill in short slots and as a boxed three-row icon when the slot is tall enough.

Accepts	Animates
ratio	no

Options

Option	Type	Required	Default	Description
label	string	no	payload.label	Optional prefix shown before the battery, e.g. "BAT" → BAT ▕████░▏▮ 75%. Falls back to RatioData.label; omitted when neither is set.
tone	"neutral" | "fill" | "drain"	no	"neutral"	How the fill colour follows the value. neutral is single theme.text (matches the rest of the gauge_* family). fill treats the value as how-full (low → status_error, high → status_ok) — right for battery / quota progress. drain inverts (high → status_error) — right for system_monitor_disk / system_monitor_memory / system_monitor_cpu where the ratio is "fraction used".

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