button_size will set the size of the buttons, in pixels. Default is 20;

button_style is a string that sets the style used for the buttons. By default, there are these styles:

• simple, where the buttons have no symbols inside of them, they are simple circles.
• reform, minimalistic — □ ⨯ buttons.
• other styles will be removed.

If you place anything else on this string, say, something like my_theme, you will have to provide pngs or svgs so that the plugin can draw custom buttons. To accomplish that, do the following:

1. Create the folder /usr/share/cosmodecor/button-styles/;
2. In it, create a folder with the name my_theme;
3. Place figures for the buttons. They'll have to be called something like type-status.png, where type can be close, minimize, or toggle-maximize, and status can be hovered, pressed, or nothing. E.g. close.png, toggle-maximize-hover.png, minimize-pressed.png. Additionally, if inactive_buttons is set to true, you have to add a additional images with the status of inactive. You Must provide an image for each of the types and statuses listed above, so 9 images if inactive_buttons == false, and 12 images if inactive_buttons == true. The images can be equal to each other, if you don't want do differentiate between different types or statuses, just make sure that every entry is placed.

normal_min, normal_max, and normal_close set their respective button colors when the button isn't hovered. Default values are #c89e2bff, #2ebb3aff, and #c24045ff, respectively.

hovered_min, hovered_max, and hovered_close set their respective button colors when the button is hovered. Default values are #ffe450ff, #60fc79ff, and #ff6572ff, respectively.

inactive_buttons is a bool that tells the plugin to draw buttons differently, depending on them being in an active or an inactive window. Default is false; The default is wayfire;

layout is a long string that determines where things should be placed on the edges of a window. Here's how it works:

• Every symbol must be separated by a space;
• The symbols title, icon, maximize, minimize, and close, will place their respective symbols on the window;
• The symbol p will introduce a standardized padding, set by the padding_size option. The symbol P followed by a number, will place that many pixels of padding, for example, P7 places 7 pixels of padding on the edge;
• The symbol | changes where the symbols are being placed. Normally, they're on the left of the edge, if you place a |, they will be on the center, if you place another |, they will be placed on the right. Further |s will not change position;
• The symbol - will change the edge the symbols are being placed in. By default, it will be the top edge, and every - will change the edge, counter-clockwise. In previous versions of wayfire-cosmodecor, you needed to end the layout with -, that is no longer the case.
• The symbol a will initiate/end an accented area, it will start one if there wasn't one already, and it will end one if there was. You can more precisely position accents by using paddings, for example a P5 title P5 a will place a padding between each end of the accent, giving some space for the title. All corners will be rounded with this option.
• The symbol A is much like a, but it is followed by a spaceless string, which tells the program what should be done to the edges of the accent. The default behaviour is to create 2 flat edges, and the available options are:
  • Any of br tr tl bl will round the respective corner (top and bottom left and right). These can be placed in any order, e.g. Abltr will round the top right and bottom left corners.
  • / and \\ (must be 2 backslashes) will create a diagonal ending on the respective edge. For example, A\\/ will create a diagonal that looks like \ on the left edge, and / on the right. This is positioned in relation to the text direction, specifically, they rotate based on the edge they're on. This option will not work if one of the corners on a respective edge is rounded, e.g. Atr// will only diagonalize the left edge.
  • ! is a flat edge. This is just used to skip diagonalization of the left edge, for example, A!\\ will diagonalize the right edge but keep the left edge flat.

The default layout is P5 title | | minimize p maximize p close P5 -. Here's what this means:

1. Place a padding with 5 pixels of size, followed by title on the left;
2. Move to the center, do nothing;
3. Move to the right;
4. Place a minimize button, followed by a toggle maximize button and a close button, all separated by a standardized padding;
5. Place a padding with 5 pixels of size;
6. Finish the top edge and move on to the left edge, do nothing there;

padding_size determines the size used for p on layout. Default is 2;