Widget reference

A “widget” here is a view: an XML tag that a screen template can emit, which renders itself (and, for containers, its children) into a PIL.Image. Every tag not in this list still “works” — it’s silently treated as the inert base View, which renders as nothing — so a typo in a tag name fails quietly rather than with an error. If a screen renders blank where you expected something, check the tag name first.

Tag	Category	Renders
<box>	Layout: box, column, row, screen	Free-form container; positions children by x/y/align/valign.
<column>	Layout: box, column, row, screen	Stacks children top to bottom.
<row>	Layout: box, column, row, screen	Stacks children left to right.
<screen>	Layout: box, column, row, screen	The document root; a <box> with a filled background at the panel’s full size.
<text>	<text>	A run of (optionally word-wrapped) text.
<image>	Image widgets: <image>, <gocomics>, <weather.icon>	An image file loaded from config storage.
<gocomics>	Image widgets: <image>, <gocomics>, <weather.icon>	Today’s strip from a GoComics title.
<weather.icon>	Image widgets: <image>, <gocomics>, <weather.icon>	A weather condition icon, from either bundled icon set.
<line>	Shapes: <line>, <rectangle>	A straight line between two points.
<rectangle>	Shapes: <line>, <rectangle>	An outlined or filled (optionally rounded) rectangle.

Every attribute value in the template is a plain string pulled straight off the XML element — there’s no schema validation, so a misspelled attribute name is silently ignored (the widget just falls back to its default) rather than raising an error. Keep that in mind when a screen doesn’t look the way an attribute name suggests it should.