Decorations
fht-compositor provides decorations: optional visual effects that can give off a nice looking effect. While they are not strictly required, they still enhance the looks of the desktop session
Window rules
All the decorations values can be overriden for specific windows using window rules!
Borders
Borders are an outline drawn around windows in a workspace. The focused window will get a different border color to indicate that it is focused and that it has active keyboard focus. Borders can also apply rounded corner radius aroud windows.
border.focused-color, border.normal-color
The border color for the focused and unfocused windows. The compositor optionally supports gradient borders, akin to CSS' linear-gradient, taking a start color, end color, and an angle (in degrees).
Color values itself are strings, and can make use of CSS color declarations (let that be color functions, named colors, etc.)
[decorations.border]
focused-color = "#6791c9"
normal-color = "transparent"TIP
When deserializing the configuration, we make use of tagged unions. Depending on the value that you assign to the color value, we automatically detect which kind of border color you want. Note however that you must specify all fields of gradient color for the configuration to be (re)loaded successfully
border.thickness, border.radius
Controls the size and corner radius of the border. Having a thickness of 0 will disable all border logic.
Shadows
Drop shadows can be rendered behind windows. With floating windows, this becomes requires to distinguish the stacking order of windows.
shadow.disable, shadow.floating-only
Toggles to disable completely shadows, or only for non-floating/tiled windows. Both are false by default
shadow.color
Color of the shadow. You can also make use of CSS color functions to specify this. Default is fully black with opacity of 0.75
shadow.sigma
The blur sigma of the shadow. This controls how much the shadow will "spread" below the window. Default is 10.0
Blur
Blur is a nice-looking effect behind semi-transparent windows. The actual implementation in the compositor is Dual Kawase, a fast approximation of Gaussian blur.
blur.radius
How much we should offset when sampling the blurred texture. In layman's terms, the higher the number the blurrier the result. Most values above 20 will just make everything blend together
blur.passes
The number of passes for the blur. More blur passes are required to get correct sampling for higher radius values. They more or less correlate together, though nothing stops you from using high number of passes with low blur values, if you care about the accuracy of the results.
CAUTION
Higher blur passes will cause more rendering to happen, and thus put more strain on your GPU. It is recommended to keep this value below 3 or 4, because otherwise it will kill your performance and framerates
blur.noise
Additional noise effect to add when rendering blur. It just looks nice and can give off the "glassy blur" effect, similar to Windows 11 Acrylic blur look.