aboutsummaryrefslogtreecommitdiff
path: root/wiki
diff options
context:
space:
mode:
Diffstat (limited to 'wiki')
-rw-r--r--wiki/Configuration:-Layer-Rules.md23
-rw-r--r--wiki/Overview.md19
2 files changed, 40 insertions, 2 deletions
diff --git a/wiki/Configuration:-Layer-Rules.md b/wiki/Configuration:-Layer-Rules.md
index 84a8f7d6..8688295c 100644
--- a/wiki/Configuration:-Layer-Rules.md
+++ b/wiki/Configuration:-Layer-Rules.md
@@ -32,6 +32,8 @@ layer-rule {
}
geometry-corner-radius 12
+
+ place-within-backdrop true
}
```
@@ -129,7 +131,7 @@ That is, enabling shadows in the layout config section won't automatically enabl
// Add a shadow for fuzzel.
layer-rule {
match namespace="^launcher$"
-
+
shadow {
on
}
@@ -149,6 +151,25 @@ This setting will only affect the shadow—it will round its corners to match th
```kdl
layer-rule {
+ match namespace="^launcher$"
+
geometry-corner-radius 12
}
```
+
+#### `place-within-backdrop`
+
+<sup>Since: next release</sup>
+
+Set to `true` to place the surface into the backdrop visible in the [Overview](./Overview.md) and between workspaces.
+
+This will only work for *background* layer surfaces that ignore exclusive zones (typical for wallpaper tools).
+
+```kdl
+// Put swaybg inside the overview backdrop.
+layer-rule {
+ match namespace="^wallpaper$"
+
+ place-within-backdrop true
+}
+```
diff --git a/wiki/Overview.md b/wiki/Overview.md
index c907eb67..5c9bae11 100644
--- a/wiki/Overview.md
+++ b/wiki/Overview.md
@@ -14,7 +14,7 @@ While in the overview, all keyboard binds keep working, while pointing devices g
> [!TIP]
> The overview needs to draw a background under every workspace.
-> So, layer-shell surfaces work this way: the *background* and *bottom* layers zoom out and remain under workspaces, while the *top* and *overlay* layers remain on top of the overview.
+> So, layer-shell surfaces work this way: the *background* and *bottom* layers zoom out and remain on the workspaces, while the *top* and *overlay* layers remain on top of the overview.
>
> Put your bar on the *top* layer.
@@ -59,3 +59,20 @@ gestures {
}
}
```
+
+### Backdrop customization
+
+Apart from setting a custom backdrop color like described above, you can also put a layer-shell wallpaper into the backdrop with a [layer rule](./Configuration:-Layer-Rules.md#place-within-backdrop), for example:
+
+```kdl
+// Put swaybg inside the overview backdrop.
+layer-rule {
+ match namespace="^wallpaper$"
+ place-within-backdrop true
+}
+```
+
+This will only work for *background* layer surfaces that ignore exclusive zones (typical for wallpaper tools).
+
+You can run two different wallpaper tools (like swaybg and swww), one for the backdrop and one for the normal workspace background.
+This way you could set the backdrop one to a blurred version of the wallpaper for a nice effect.