Add layout background-color setting

3 files changed, 41 insertions, 1 deletions

diff --git a/wiki/Configuration:-Layout.md b/wiki/Configuration:-Layout.md
index 4f2cc112..c76bf82e 100644
--- a/wiki/Configuration:-Layout.md
+++ b/wiki/Configuration:-Layout.md
@@ -11,6 +11,7 @@ layout {
     always-center-single-column
     empty-workspace-above-first
     default-column-display "tabbed"
+    background-color "#003300"
 
     preset-column-widths {
         proportion 0.33333
@@ -526,3 +527,18 @@ layout {
     }
 }
 ```
+
+### `background-color`
+
+<sup>Since: next release</sup>
+
+Set the default background color that niri draws for workspaces.
+This is visible when you're not using any background tools like swaybg.
+
+```kdl
+layout {
+    background-color "#003300"
+}
+```
+
+You can also set the color per-output [in the output config](./Configuration:-Outputs.md#background-color).
diff --git a/wiki/Configuration:-Outputs.md b/wiki/Configuration:-Outputs.md
index 0a86395e..c4e0ab57 100644
--- a/wiki/Configuration:-Outputs.md
+++ b/wiki/Configuration:-Outputs.md
@@ -210,7 +210,7 @@ output "HDMI-A-1" {
 Set the backdrop color that niri draws for this output.
 This is visible between workspaces or in the overview.
 
-The alpha channel for this color will be ignored.
+<sup>Until: next release</sup> The alpha channel for this color will be ignored.
 
 ```kdl
 output "HDMI-A-1" {
diff --git a/wiki/Overview.md b/wiki/Overview.md
index 5c9bae11..aa12b194 100644
--- a/wiki/Overview.md
+++ b/wiki/Overview.md
@@ -76,3 +76,27 @@ This will only work for *background* layer surfaces that ignore exclusive zones
 
 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.
+
+You can also combine this with a transparent background color if you don't like the wallpaper moving together with workspaces:
+
+```kdl
+// Make the wallpaper stationary, rather than moving with workspaces.
+layer-rule {
+    // This is for swaybg; change for other wallpaper tools.
+    // Find the right namespace by running niri msg layers.
+    match namespace="^wallpaper$"
+    place-within-backdrop true
+}
+
+// Set transparent workspace background color.
+layout {
+    background-color "transparent"
+}
+
+// Optionally, disable the workspace shadows in the overview.
+overview {
+    workspace-shadow {
+        off
+    }
+}
+```