media_pixel

Draws a small pixel-art sprite cell-by-cell with truecolor half-blocks. Works in any terminal with 24-bit colour. Two stacked pixels fit into one cell, so a 16x16 sprite renders as 16 columns × 8 rows. Transparent pixels (a = 0) blend with the theme background.

Accepts	Animates
pixel_art	no

Options

Option	Type	Required	Default	Description
align	"left" | "center" | "right"	no	"left"	Horizontal placement of the sprite within the available cell.
max_width	cells (u16)	no	area width	Upper bound on the rendered sprite width in cells. Overflow is clipped from the right.
max_height	cells (u16)	no	area height	Upper bound on the rendered sprite height in cells (each cell = 2 pixel rows). Overflow is clipped from the bottom.

Theme tokens

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

Key	Description
bg	Viewport background. Painted across the entire splash area before widgets draw. The default is a deep-ocean navy; set bg = "reset" to inherit the terminal's own background instead (recommended on light terminals).
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.

Compatible fetchers

Shape	Fetchers
pixel_art	basic_read_store, clock_derived, system_monitor_battery, system_monitor_cpu, weather

Preview

pixel_art

▀▀▀▀                
▀▀▀▀                
hello               
                    
                    

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