Skip to content
BETA Documentation
Themes
Theme Elements

Theme Elements

Every Theme group has separate Background, Border, and Border Thickness properties. Default applies to that property only; it does not reset the other two properties in the group.

Theme groupWhat it changes
TaskbarThe TaskManSync taskbar surface.
TasksNormal Tasks that are not currently active.
Active TaskThe visual state of the currently active Task. Its Theme properties are independent of the normal Task properties. If an Active Task property is Default, the normal active-task appearance is used; the corresponding Tasks Theme property is not substituted.
LaunchersLauncher appearance only; it does not change a Launcher’s target or position.
DecorationsFallback appearance for Decoration surfaces and borders when no higher-priority Decoration setting supplies a value.

Theme appearance is not orientation-specific. The same values apply when a TaskManSync applet is horizontal or vertical; orientation still affects layout. For example, the Maximum Task Width setting only affects horizontal task items. See Other Settings.

Decoration precedence

Decoration backgrounds can come from several places. The first applicable value wins:

  1. A nonempty Scripted Decoration decoration.backgroundColor value.
  2. TDML dcolor / dc, when set.
  3. The Decoration definition’s Background color, when set.
  4. The Active Theme’s Decoration Background.
  5. The Active Theme’s Taskbar Background.
  6. KDE/Plasma’s normal Decoration appearance.

This explains why changing a Theme may not change one Decoration: a Scripted runtime value, TDML surface color, or explicit definition Background color takes precedence. TDML bgc colors only the affected text run; it does not set the Decoration surface background. An empty Scripted runtime background clears that override and reveals the next applicable value. See Colors and Appearance and the TDML color reference.

Decoration borders use the Active Theme’s Decoration Border first, then the Active Theme’s Taskbar Border, then the existing renderer behavior. Decoration definitions do not have their own border setting. Default thickness leaves the current renderer behavior unchanged; an explicit 0 px thickness removes the border.

Themes do not control Decoration text color, TDML text formatting, or a Decoration’s width, placement, or per-applet visibility. Those are configured separately; see Decoration colors and appearance, Decoration width, and Placing Decorations.