basic_image

Emits a user-configured file path as an Image payload. Right for repo logos, per-directory branding, or any static image — the renderer (media_image) is what actually loads the bytes. Path expansion is deferred to the renderer so this fetcher is pure and infallible at compute time.

Kind	Safety	Shapes
realtime	Safe	image

Options

Option	Type	Required	Default	Description
path	string (file path)	yes	—	Absolute or ~-expanded path to a PNG / JPEG / GIF / WebP. Loaded by media_image at draw time; this fetcher only passes the string through.

Compatible renderers

Shape	Renderers
image	animated_boot, animated_postfx, animated_scanlines, animated_splitflap, animated_wave, media_image

Preview

image via media_image

[image: No such file or directory (os er
                                        
                                        
                                        
                                        

[[widget]]
id = "basic_image"
fetcher = "basic_image"
render = "media_image"