aboutsummaryrefslogtreecommitdiff
path: root/wiki/Overview.md
diff options
context:
space:
mode:
authorIvan Molodetskikh <yalterz@gmail.com>2025-05-06 16:51:18 +0300
committerIvan Molodetskikh <yalterz@gmail.com>2025-05-06 17:34:40 +0300
commit3e31c134a602dd876f2b446071e5802fa4a0c3ec (patch)
tree0c162b432ee4964e66d24521b3728b447d90afdb /wiki/Overview.md
parentfe682938db2a0aa6e6ffb105a51051a5946a8143 (diff)
downloadniri-3e31c134a602dd876f2b446071e5802fa4a0c3ec.tar.gz
niri-3e31c134a602dd876f2b446071e5802fa4a0c3ec.tar.bz2
niri-3e31c134a602dd876f2b446071e5802fa4a0c3ec.zip
Implement place-within-backdrop layer rule
Diffstat (limited to 'wiki/Overview.md')
-rw-r--r--wiki/Overview.md19
1 files changed, 18 insertions, 1 deletions
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.