Widget basics

Every widget in Themia shares the same frame and the same set of controls. Learn them once and the other 49 pages become mostly about what data each one shows.

The header

Most widgets render a header row: an icon, a title, and sometimes a compact status readout. It is also the drag handle.

The header has three modes, set per widget instance from its right-click menu:

• Normal: always visible.
• On hover: hidden until you point at the widget, which suits ambient widgets you mostly read at a glance.
• Hidden: never drawn. The widget’s content fills the whole frame.

A handful of widgets ship with no header at all because their content is self-explanatory. The clock is the obvious one.

Renaming

Every widget carries a label. Leave it empty and the widget shows its default name; set it and that text replaces the title. This is what turns three folder widgets into “Projects”, “Invoices” and “Screenshots”.

Because the label is shared by every widget, it is documented here rather than repeated in each widget’s option table.

Settings

Right-click a widget and choose Configure to open its settings. Widgets with nothing to configure (the calculator, for instance) say so instead of showing an empty panel.

Each widget’s reference page lists its options and the value each one ships with.

Transparent background

Some widgets offer a Transparent background toggle, which drops the card surface and lets the wallpaper show through.

It is deliberately not offered everywhere. Glanceable widgets (a clock, a temperature, an icon grid) read fine over a photo. Dense list and editing widgets need their opaque surface to stay legible, so they don’t get the toggle. Each reference page states whether the widget has it.

Open in window

Content and editing widgets can be popped out into their own resizable desktop window from the right-click menu. Useful when you want to actually work in a widget (writing a note, triaging mail) rather than glance at it.

Ambient widgets don’t offer it; there’s nothing to expand into.

Stacking and grouping

Widgets can be combined into containers:

• Stack: several widgets in one frame, one visible at a time.
• Tabs: the same idea with a visible tab strip.
• Group: an area that moves and resizes as a unit without re-laying out its contents.

Containers never nest inside each other. See Layout and grid for how they behave when you drag things around.