Skip to content

media_image

  • Accepts: image
  • Animates: no
OptionTypeRequiredDefaultDescription
align"left" | "center" | "right"no"left"Horizontal placement within the available cell when the image is narrower (after max_width / fit = "contain").
fit"contain" | "cover" | "stretch"no"contain"How the image is sized into its box. contain preserves aspect; cover fills the box and crops overflow; stretch warps to fit.
max_widthcells (u16)noarea widthUpper bound on image width in cells.
max_heightcells (u16)noarea heightUpper bound on image height in cells.
paddingcells (u16)no0Uniform inset inside the image cell (all four sides). Applied before alignment and sizing.

Overridable via the [theme] section of config.toml.

KeyDescription
textPrimary 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.
ShapeFetchers
imagebasic_read_store, github_avatar