Components
22 XML elements grouped by role. Use them inside a<wallpaper> or <widget> to lay out and render content. Click any component for its full attribute reference.
Layout
Root-level background element rendered behind all pages. Use for the wallpaper's base color or gradient.
Stacking container — children overlap at the specified alignment. align controls how the box places itself in its parent (Compose Modifier.align); contentAlignment controls how children are placed inside the box (Compose Box(contentAlignment = ...)).
Radial layout — places children at equal angular intervals on a circle of the given ring radius. Powers astrolabes, clock faces, and radial menus.
Content
Icon resolved through IconRegistry. material:foo reaches the full Material Symbols catalogue (~3000 glyphs) with optional axis controls; other prefixes (weather:, astrology:) target specialist icon sets.
Displays a local or remote image with expression-driven source, sizing, and styling.
Decorative geometric shape — rectangle, circle, or line. Supports both fill (color) and stroke (strokeColor/strokeWidth) — either, both, or neither.
Vector path drawn from an SVG-subset d attribute (M/L/H/V/C/Z). Use for constellations, decorative flourishes, and bespoke shapes.
Draws the visible ecliptic arc as a sine-wave curve with solar-system bodies (Sun, Moon, planets) plotted at their true sky positions. Requires a <module type="solarsystem" /> declaration.
Geocentric solar-system disc seen from above Earth's north pole. Earth is a circle at the center with the observer at the top; each body sits on its own concentric ring at its current hour angle (clockwise from top — the Sun is at the top at local solar noon). The sunlit half of Earth glows and travels around the disc once per day. Requires a <module type="solarsystem" /> declaration.
Generative animated background effect. Picks one of a fixed catalog of templates (particles, blobs, topography, aurora) and renders it on a Compose Canvas driven by the shared animation clock. Pauses when the wallpaper engine is not visible. Allowed wherever a <shape> is — typically inside <background> or a <layer>.