# Theme structure

## PDecor

The block for decoration sets, any amount of Decor sections can exist inside this block.

### Decor

A list of blocks with theme specifications the various types of decorations.

#### Title

Theming of the frame.

- Height (pixels): Amount of pixels the titlebar should height.

- HeightAdapt (boolean): If true, Height is adapted to fit the Title font.

- Pad (pixels t,l,r,b): How many pixels are left around a title text.

- Focused (texture): Background texture for a focused titlebar.

- UnFocused (texture): Background texture for an unfocused titlebar.

- WidthMin (pixels): Minimum width of title in pixels, will also place the titlebar outside of the window borders. Use 0 to place titlebar inside borders.

- WidthMax (percent): Maximum width of titles relative to window width, when this value ends up being smaller than the value in WidthMin, WidthMin is overridden.

- WidthSymetric (boolean): Set true to constant width titles or false to use titles that only are as big as the clients title text string requires (note, asymmetric width is not fully implemented yet, always set this true for now to avoid problems).

##### Tab

Theming of a titlebar tabs.

- Focused (texture): Background texture for a tab of a focused window.

- Unfocused (texture): Background texture for a tab of an unfocused window.

- FocusedSelected (texture): Background texture for the currently selected tab of a focused window.

- UnFocusedSelected (texture): Background texture for the currently selected tab of an unfocused window.

##### FontColor

Theming of font colors.

- Focused (colour colour): Text colour for a tab of a focused window. second value is the shadow colour.

- Unfocused (colour colour): Text colour for a tab of an unfocused window. second value for shadow.

- FocusedSelected (colour colour): Text colour for the currently selected tab of a focused window. second value for shadow.

- UnFocusedSelected (colour colour): Text colour for the currently selected tab of an unfocused window. second value for shadow.

##### Font

Theming of the titlebar fonts.

- Focused (fontstring): Font of the text of a tab of a focused window.

- Unfocused (fontstring): Font of the text of a tab of an unfocused window.

- FocusedSelected (fontstring): Font of the text of the currently selected tab of a focused window.

- UnFocusedSelected (fontstring): Font of the text of the currently selected tab of an unfocused window.

##### Separator

Theming of the tab separator.

- Focused (texture): Separator texture for a focused window.

- Unfocused (texture): Separator texture for an unfocused window.

##### Buttons

Theming of titlebar buttons.

###### Right = "Name"

Places the button on the right end of the titlebar.

###### Left = "Name"

Places the button on the left end of the titlebar.

- Focused (texture): Texture for button of a focused window.

- Unfocused (texture): Texture for button of an unfocused window.

- Pressed (texture): Texture for button that is pressed.

- Hover (texture): Texture for button when pointer is placed on it.

- SetShape (bool): If true, the shape of the button is derived from the alpha-channel. If false, the alpha-channel sets only the transparency. (defaults to true)

- Button (buttonactions): Configures what to do when a button is pressed.

##### Border

Theming of the borders.

Focused: borders for focused windows.

UnFocused: borders for unfocused windows.

- TopLeft (texture): Texture for the top left corner.

- Top (texture): Texture for the top border.

- TopRight (texture): Texture for the top right corner.

- Left (texture): Texture for the left border.

- Right (texture): Texture for the right birder.

- BottomLeft (texture): Texture for the bottom left corner.

- Bottom (texture): Texture for the bottom border.

- BottomRight (texture): Texture for the bottom right border.

### Harbour

Enables theming of the harbour.

- Texture, texture: Texture to use as the harbour background.

### Menu

Themes the insides of a menu window.

- Pad (padding): How many pixels of space around an entry is reserved.

#### State

One of Focused, Unfocused and Selected defining the appearance when the menu/submenu is focused, not focused and the menu entry currently selected.

- Font (fontstring): What font to use.

- Background (texture): A texture that starts from the top of the menu and ends on the bottom.

- Item (texture): A texture that starts from the top of a menu entry and ends on the bottom of the entry.

- Text (colour): Colour of text to use.

- Separator (texture): Texture to use as separator (required, client menu will break if none is defined).

- Arrow (texture): Texture to use for indicating submenus (you want this to be defined too).

### CmdDialog

Themes the insides of a command dialog window.

- Font (fontstring): What font to use.

- Texture (texture): Texture to use as the background.

- Text (colour): Colour of text.

- Pad (padding): Amount of pixels of space around font to reserve.

### Status

Themes the insides of the status window that shows up when moving windows and so on.

- Font (fontstring): What font to use.

- Texture (texture): Texture to use as the background.

- Text (colour): Colour of text.

- Pad (padding): Amount of pixels of space around font to reserve.

### WorkspaceIndicator

Themes the workspace indicator that shows up when switching workspace.

- Font (fontstring): What font to use.

- Background (texture): Background for the whole window.

- Workspace (texture): Texture to use when rendering a workspace.

- WorkspaceActive (texture): Texture to use when rendering the active workspace.

- Text (colour): Colour of text.

- EdgePadding (padding): Amount of pixels of space around window edges and workspaces.

- WorkspacePadding (padding): Amount of pixels of space between workspaces.