Skip to content
splashboard

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.

KindSafetyShapes
realtimeSaferatio, text, entries, badge, pixel_art

Options

Section titled “Options”
OptionTypeRequiredDefaultDescription
kind"summary" | "percent" | "status" | "time_remaining"no"summary"Selects the format of the Text shape. Ignored by Ratio / Entries.
indexintegerno0Index of the battery to read on multi-battery systems.

Compatible renderers

Section titled “Compatible renderers”
ShapeRenderers
ratioanimated_boot, animated_postfx, animated_scanlines, animated_splitflap, animated_wave, gauge_battery, gauge_circle, gauge_line, gauge_segment, gauge_thermometer
textanimated_boot, animated_figlet_morph, animated_postfx, animated_scanlines, animated_splitflap, animated_typewriter, animated_wave, text_ascii, text_plain
entriesanimated_boot, animated_postfx, animated_scanlines, animated_splitflap, animated_wave, grid_table
badgeanimated_boot, animated_postfx, animated_scanlines, animated_splitflap, animated_wave, status_badge
pixel_artmedia_pixel

Preview

Section titled “Preview”

ratio via gauge_battery

Section titled “ratio via gauge_battery”
                                        
        ┌─────────────────────────┐     
battery │██████████████████████░░░│▮ 87%
        └─────────────────────────┘     
                                        

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

ratio via gauge_circle

Section titled “ratio via gauge_circle”
███████████████████████████████████     
████████████████battery ███████████     
███████████████████████████████████     

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

ratio via gauge_line

Section titled “ratio via gauge_line”
battery: ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓░░░ 87% 

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

ratio via gauge_segment

Section titled “ratio via gauge_segment”
                                        
                                        
battery ▰▰▰▰▱ 87%                       
                                        
                                        

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

ratio via gauge_thermometer

Section titled “ratio via gauge_thermometer”
        ╭─╮         
        │░│         
        │█│         
        │█│         
battery │█│ 87%     
        │█│         
        │█│         
        ╰●╯         

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

text via text_ascii

Section titled “text via text_ascii”
▟▀▙ █▀█ ▄ ▗▖            ▗▛▜▖▜▌               ▀                      ▗█  ▜▌      
▜▄▛  ▗▛ ▀▗▛             █   ▐▙▜▖▝▀▙ ▜▟▜▖▟▀▟▘▝█  █▀▙ ▟▀▟▘             █  ▐▙▜▖    
█ █  █  ▗▛▗▖            ▜▖▗▖▐▌▐▌▟▀█ ▐▌▝▘▜▄█  █  █ █ ▜▄█              █  ▐▌▐▌    
▝▀▘  ▀  ▀ ▝▘             ▀▀ ▀▘▝▘▝▀▝▘▀▀  ▄▄▛ ▝▀▘ ▀ ▀ ▄▄▛             ▀▀▀ ▀▘▝▘    
                                                                                

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

text via text_plain

Section titled “text via text_plain”
87% • Charging • 1h 23m                 
                                        

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

entries via grid_table

Section titled “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

Section titled “badge via status_badge”
● 87% · Charging                        

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

pixel_art via media_pixel

Section titled “pixel_art via media_pixel”
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀    
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀    
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀    
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀    
87% · Charging      

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