system_monitor_battery

Charge level and state of the primary (or index-selected) battery. Ratio drives gauges, Text formats a summary line whose field is picked by kind, and Entries rolls up charge / state / time-left / cycles / health. Hosts without a battery render a steady "AC" placeholder.

Kind	Safety	Shapes
realtime	Safe	ratio, text, entries, badge

Options

Option	Type	Required	Default	Description
kind	"summary" | "percent" | "status" | "time_remaining"	no	"summary"	Selects the format of the Text shape. Ignored by Ratio / Entries.
index	integer	no	0	Index of the battery to read on multi-battery systems.

Compatible renderers

Shape	Renderers
ratio	animated_boot, animated_postfx, animated_scanlines, animated_splitflap, animated_wave, gauge_battery, gauge_circle, gauge_line, gauge_segment, gauge_thermometer
text	animated_boot, animated_figlet_morph, animated_postfx, animated_scanlines, animated_splitflap, animated_typewriter, animated_wave, text_ascii, text_plain
entries	animated_boot, animated_postfx, animated_scanlines, animated_splitflap, animated_wave, grid_table
badge	animated_boot, animated_postfx, animated_scanlines, animated_splitflap, animated_wave, status_badge

Preview

ratio via gauge_battery

                                        
        ┌─────────────────────────┐     
battery │██████████████████████░░░│▮ 87%
        └─────────────────────────┘     
                                        

[[widget]]
id = "system_monitor_battery"
fetcher = "system_monitor_battery"
render = "gauge_battery"

ratio via gauge_circle

███████████████████████████████████     
████████████████battery ███████████     
███████████████████████████████████     

[[widget]]
id = "system_monitor_battery"
fetcher = "system_monitor_battery"
render = "gauge_circle"

ratio via gauge_line

battery: ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓░░░ 87% 

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

ratio via gauge_segment

                                        
                                        
battery ▰▰▰▰▱ 87%                       
                                        
                                        

[[widget]]
id = "system_monitor_battery"
fetcher = "system_monitor_battery"
render = "gauge_segment"

ratio via gauge_thermometer

        ╭─╮         
        │░│         
        │█│         
        │█│         
battery │█│ 87%     
        │█│         
        │█│         
        ╰●╯         

[[widget]]
id = "system_monitor_battery"
fetcher = "system_monitor_battery"
render = "gauge_thermometer"

text via text_ascii

▟▀▙ █▀█ ▄ ▗▖            ▗▛▜▖▜▌               ▀                      ▗█  ▜▌      
▜▄▛  ▗▛ ▀▗▛             █   ▐▙▜▖▝▀▙ ▜▟▜▖▟▀▟▘▝█  █▀▙ ▟▀▟▘             █  ▐▙▜▖    
█ █  █  ▗▛▗▖            ▜▖▗▖▐▌▐▌▟▀█ ▐▌▝▘▜▄█  █  █ █ ▜▄█              █  ▐▌▐▌    
▝▀▘  ▀  ▀ ▝▘             ▀▀ ▀▘▝▘▝▀▝▘▀▀  ▄▄▛ ▝▀▘ ▀ ▀ ▄▄▛             ▀▀▀ ▀▘▝▘    
                                                                                

[[widget]]
id = "system_monitor_battery"
fetcher = "system_monitor_battery"
render = "text_ascii"

text via text_plain

87% • Charging • 1h 23m                 
                                        

[[widget]]
id = "system_monitor_battery"
fetcher = "system_monitor_battery"
render = "text_plain"

entries via grid_table

charge                               87%
state                           Charging
time_left                         1h 23m
cycles                               284
health                               97%

[[widget]]
id = "system_monitor_battery"
fetcher = "system_monitor_battery"
render = "grid_table"

badge via status_badge

● 87% · Charging                        

[[widget]]
id = "system_monitor_battery"
fetcher = "system_monitor_battery"
render = "status_badge"