窗口规则

可以是 true 或 false。匹配在其列中处于“活动”状态的窗口。

与 is-active 不同，每一列中始终会有一个 is-active-in-column 窗口。它指的是该列中最后获得焦点的窗口，即当该列获得焦点时，将会接收到焦点的那个窗口。

Since: 25.01 在窗口初始打开时，此规则将匹配为 true。

window-rule {
    match is-active-in-column=true
}

`is-floating`#

可以是 true 或 false。匹配浮动窗口。

Note

此匹配器仅在窗口已经打开后才会应用。这意味着你不能使用它来更改窗口的打开属性，如 default-window-height 或 open-on-workspace。

window-rule {
    match is-floating=true
}

`is-window-cast-target`#

可以是 true 或 false。对于那写正在进行窗口屏幕录制的目标窗口，匹配为 true。

Note

这仅匹配单个窗口的屏幕录制。例如，它不会匹配在显示器屏幕录制中恰好可见的窗口。

// 用红色指示正在被屏幕录制的窗口。
window-rule {
    match is-window-cast-target=true

    focus-ring {
        active-color "#f38ba8"
        inactive-color "#7d0d2d"
    }

    border {
        inactive-color "#7d0d2d"
    }

    shadow {
        color "#7d0d2d70"
    }

    tab-indicator {
        active-color "#f38ba8"
        inactive-color "#7d0d2d"
    }
}

示例：

一张显示只有 is-window-cast-target=true 的窗口接收特殊的边框颜色的截图

`is-urgent`#

Since: 25.05

可以是 true 或 false。匹配请求用户注意的窗口。

window-rule {
    match is-urgent=true
}

`at-startup`#

可以是 true 或 false。在启动 niri 后的前 60 秒内匹配。

这对于像 open-on-output 这样的属性很有用，你可能希望仅在启动 niri 后的一段时间内应用它们。

// 在 niri 启动时，在 HDMI-A-1 显示器上打开窗口，但之后不这样做。
window-rule {
    match at-startup=true
    open-on-output "HDMI-A-1"
}

窗口打开属性#

这些属性在窗口首次打开时应用一次。

准确地说，它们在 niri 向窗口发送初始配置请求时应用。

`default-column-width`#

为新窗口设置默认宽度。

尽管名称中有“column”，但其实这也适用于浮动窗口。

// 在打开时为 Blender 和 GIMP 提供足够的宽度。
window-rule {
    match app-id="^blender$"

    // GIMP 应用 ID 包含版本号，如 "gimp-2.99"，
    // 所以我们只匹配开头（用 ^）而不匹配结尾。
    match app-id="^gimp"

    default-column-width { fixed 1200; }
}

`default-window-height`#

为新窗口设置默认高度。

// 以浮动窗口打开 Firefox 画中画窗口，大小为 480×270 。
window-rule {
    match app-id="firefox$" title="^Picture-in-Picture$"

    open-floating true
    default-column-width { fixed 480; }
    default-window-height { fixed 270; }
}

`open-on-output`#

使窗口在特定的输出上打开。

如果这样的输出不存在，窗口将照常地在当前聚焦的输出上打开。

如果窗口在当前未获得焦点的输出上打开，该窗口将不会自动获得焦点。

// 在特定的显示器上
// 打开 Firefox 和 Telegram（但不包括其媒体查看器）。
window-rule {
    match app-id="firefox$"
    match app-id=r#"^org\.telegram\.desktop$"#
    exclude app-id=r#"^org\.telegram\.desktop$"# title="^Media viewer$"

    open-on-output "HDMI-A-1"
    // 或者：
    // open-on-output "Some Company CoolMonitor 1234"
}

Since: 0.1.9 open-on-output 现在可以使用显示器的制造商、型号和序列号。在此版本之前，它只能使用连接器名称。

`open-on-workspace`#

使窗口在特定的命名工作区上打开。

如果这样的工作区不存在，窗口将照常地在当前聚焦的工作区上打开。

如果窗口在当前未获得焦点的输出上打开，该窗口将不会自动获得焦点。

// 在 "chat" 工作区上打开 Fractal。
window-rule {
    match app-id=r#"^org\.gnome\.Fractal$"#

    open-on-workspace "chat"
}

`open-maximized`#

使窗口作为最大化列打开。

// 默认最大化 Firefox。
window-rule {
    match app-id="firefox$"

    open-maximized true
}

`open-maximized-to-edges`#

Since: 25.11

让窗口以最大化到边缘的形式打开。

window-rule {
    open-maximized-to-edges true
}

你也可以将其设置为 false 来防止窗口以最大化到边缘的形式打开。

window-rule {
    open-maximized-to-edges false
}

`open-fullscreen`#

使窗口全屏打开。

window-rule {
    open-fullscreen true
}

你也可以将其设置为 false 以阻止窗口全屏打开。

// 让 Telegram 媒体查看器以窗口模式打开。
window-rule {
    match app-id=r#"^org\.telegram\.desktop$"# title="^Media viewer$"

    open-fullscreen false
}

`open-floating`#

使窗口以浮动布局打开。

// 让 Firefox 画中画窗口作为浮动窗口打开。
window-rule {
    match app-id="firefox$" title="^Picture-in-Picture$"

    open-floating true
}

你也可以将其设置为 false 以阻止窗口以浮动布局打开。

// 在平铺布局中打开所有窗口，覆盖任何自动浮动逻辑。
window-rule {
    open-floating false
}

`open-focused`#

将此项设置为 false 以防止此窗口在打开时自动获取焦点。

// 不要将焦点给予 GIMP 启动画面。
window-rule {
    match app-id="^gimp" title="^GIMP Startup$"

    open-focused false
}

你也可以将其设置为 true 来聚焦窗口，即使通常情况下它不会自动获得焦点。

// 始终聚焦 KeePassXC-Browser 解锁对话框。
//
// 此对话框作为 KeePassXC 窗口的子窗口打开，而不是浏览器的，
// 因此默认情况下它不会自动获得焦点。
window-rule {
    match app-id=r#"^org\.keepassxc\.KeePassXC$"# title="^Unlock Database - KeePassXC$"

    open-focused true
}

动态属性#

这些属性持久生效于已打开的窗口。

`block-out-from`#

你可以阻止窗口出现在 xdg-desktop-portal 屏幕录制中。它们将被替换为纯黑色矩形。

这对于密码管理器或聊天窗口等很有用。对于 layer-shell 通知弹出窗口等类似的玩意儿，你可以使用 block-out-from 层规则。

截图显示一个窗口在正常情况下可见，但在 OBS 中被阻止。

要预览和设置此规则，请检查配置中调试（debug）部分的 preview-render 选项。

Caution

该窗口在第三方截图工具中不会被屏蔽如果你在屏幕录制时打开某个带预览的截图工具，被阻止的窗口将在屏幕录制中可见。

不过，内置的截图界面不受此问题影响。若在录屏期间打开截图界面，您将能正常看到所有窗口并选择截图区域，但在最终的录屏画面中，该选择界面会显示出来，而其中的窗口则会被屏蔽。

// 在屏幕录制中屏蔽密码管理器。
window-rule {
    match app-id=r#"^org\.keepassxc\.KeePassXC$"#
    match app-id=r#"^org\.gnome\.World\.Secrets$"#

    block-out-from "screencast"
}

或者，你可以将窗口从所有屏幕捕获中屏蔽，包括第三方截图工具。这样，在打开第三方截图预览时，你就可以避免该窗口在屏幕录制中被意外显示。

此设置仍然允许你使用交互式内置截图界面，但它会阻止窗口出现在完全自动的截图操作中，例如 screenshot-screen 和 screenshot-window。这样做的原因是，通过交互式选择，你可以确保避免截取敏感内容。

window-rule {
    block-out-from "screen-capture"
}

Warning

根据动态变化的窗口标题来屏蔽窗口时要小心。

例如，你可能会尝试像这样阻止特定的 Firefox 标签页：

window-rule {
    // 不太起作用！尝试阻止 Gmail 标签页。
    match app-id="firefox$" title="- Gmail "

    block-out-from "screencast"
}

它会起作用，但是当从一个敏感标签页切换到一个普通标签页时，敏感标签页的内容会在屏幕录制中显示一瞬间。

这是因为在 Wayland 协议中，窗口标题（和应用 ID）并未实现双缓冲，因此它们与特定的窗口内容并不绑定。 Firefox 无法以一种可靠的方式，来同步“切换到另一个可见标签页”和“更改窗口标题”这两个操作。

`opacity`#

设置窗口的不透明度。 0.0 是完全透明，1.0 是完全不透明。这是在窗口自身的不透明度之上应用的，因此半透明窗口将变得更加透明。

不透明度会单独应用于窗口的每个界面，因此子界面和弹出菜单将显示其背后的窗口内容。

截图显示带有半透明弹出菜单的 Adwaita Demo 。

此外，焦点环和带背景的边框将在半透明窗口后显示（参见下面的 prefer-no-csd 和 draw-border-with-background 窗口规则）。

可以使用 toggle-window-rule-opacity 动作为窗口切换不透明度的开或关。

// 使非活动窗口半透明。
window-rule {
    match is-active=false

    opacity 0.95
}

`variable-refresh-rate`#

Since: 0.1.9

如果设置为 true，每当此窗口在支持按需 VRR 的输出上显示时，它将在该输出上启用 VRR。

// 配置某个支持按需 VRR 的输出。
output "HDMI-A-1" {
    variable-refresh-rate on-demand=true
}

// 当 mpv 在该输出上显示时启用按需 VRR。
window-rule {
    match app-id="^mpv$"

    variable-refresh-rate true
}

`default-column-display`#

为从此窗口创建的列设置默认显示模式。可以为 normal 或 tabbed。

这在窗口进入自己的列时使用。例如： - 打开一个新窗口。 - 将一个窗口剔出成独立的列。 - 将一个窗口从浮动布局切换到平铺布局。

// 使 Evince 窗口作为标签页式列打开。
window-rule {
    match app-id="^evince$"

    default-column-display "tabbed"
}

`default-floating-position`#

设置此窗口在打开或移动到浮动布局时的初始位置。

之后，窗口将记住其最后的浮动位置。

默认情况下，新的浮动窗口在屏幕中心打开，而从平铺布局来的窗口在其视觉屏幕位置附近打开。

该位置使用相对于工作区的逻辑坐标。默认情况下，它们相对于工作区的左上角，但你可以通过将 relative-to 设置为以下值之一来更改此设置：top-left、top-right、bottom-left、bottom-right、top、bottom、left 或 right。

例如，如果你顶部有一个栏，那么 x=0 y=0 会将窗口的左上角放在栏的正下方。相反，如果你写 x=0 y=0 relative-to="top-right"，那么窗口的右上角将与工作区的右上角对齐，同样在栏的正下方。当只指定一侧时（例如 top），则窗口将与该侧的中心对齐。

坐标方向会根据 relative-to 改变。例如，默认情况下（左上角），x=100 y=200 会将窗口放在左上角的右侧 100 像素、下方 200 像素的位置。如果你使用 x=100 y=200 relative-to="bottom-left"，它会将窗口放在左下角的右侧 100 像素、上方 200 像素的位置。

// 在屏幕的左下角打开 Firefox 画中画窗口，
// 并留有一个小间隙。
window-rule {
    match app-id="firefox$" title="^Picture-in-Picture$"

    default-floating-position x=32 y=32 relative-to="bottom-left"
}

你可以使用单侧 relative-to 来获得类似下拉菜单的效果。

// 示例：一个“下拉”终端。
window-rule {
    // 通过 "dropdown" 应用 ID 匹配。
    // 你需要在运行终端时设置此应用 ID，例如：
    // spawn "alacritty" "--class" "dropdown"
    match app-id="^dropdown$"

    // 将其作为浮动窗口打开。
    open-floating true
    // 锚定到屏幕的上边缘。
    default-floating-position x=0 y=0 relative-to="top"
    // 屏幕高度的一半。
    default-window-height { proportion 0.5; }
    // 屏幕宽度的 80%。
    default-column-width { proportion 0.8; }
}

`scroll-factor`#

为发送到窗口的所有滚动事件设置滚动系数。

这将与你在输入部分中为输入设备设置的滚动系数相乘。

// 使 Firefox 中的滚动慢一点。
window-rule {
    match app-id="firefox$"

    scroll-factor 0.75
}

`draw-border-with-background`#

覆写边框和焦点环是否绘制背景。

将此项设置为 true，即使对于同意省略其客户端装饰的窗口，也将它们绘制为纯色矩形。将此项设置为 false，即使对于使用客户端装饰的窗口，也将它们绘制为窗口周围的边框。

此属性对于不支持 xdg-decoration 协议的矩形窗口很有用。

带背景	不带背景

window-rule {
    draw-border-with-background false
}

`focus-ring` 和 `border`#

覆盖窗口的焦点环和边框选项。

这些规则与布局部分中普通的 focus-ring 和 border 配置具有相同的选项，因此请查看那里的文档。

但是，除了用于禁用边框/焦点环的 off 之外，此窗口规则还有一个 on 标志，即使边框/焦点环在其他情况下被禁用，也会为窗口启用它。如果同时设置了 on 和 off 标志，则 on 标志优先级高于 off 标志。

window-rule {
    focus-ring {
        off
        width 2
    }
}

window-rule {
    border {
        on
        width 8
    }
}

`shadow`#

覆写窗口的阴影选项。

此规则与布局部分中普通的 shadow 配置具有相同的选项，因此请查看那里的文档。

但是，除了用于启用阴影的 on 之外，此窗口规则还有一个 off 标志，即使阴影在其他情况下被启用，也会为窗口禁用它。如果同时设置了 on 和 off 标志，on 标志的优先级高于 off 标志。

// 为浮动窗口启用阴影。
window-rule {
    match is-floating=true

    shadow {
        on
    }
}

`tab-indicator`#

覆写窗口的选项卡指示器选项。

此规则中的选项与布局部分中普通的 tab-indicator 配置具有相同的选项，因此请查看那里的文档。

// 让 KeePassXC 标签页具有深红色的非活动颜色。
window-rule {
    match app-id=r#"^org\.keepassxc\.KeePassXC$"#

    tab-indicator {
        inactive-color "darkred"
    }
}

`geometry-corner-radius`#

设置窗口的圆角半径。

仅此设置本身，只会影响边框和焦点环——它们会将其圆角调整为与几何圆角半径匹配。如果你想强制圆角化窗口本身的角，请在此设置之外再设置 clip-to-geometry true。

window-rule {
    geometry-corner-radius 12
}

半径以逻辑像素为单位设置，并控制窗口本身的半径，即边框的内半径：

一张显示一个每个角都圆角的窗口的截图

你可以设置四个半径，而不是一个，分别对应每个角。顺序与 CSS 中的相同：左上、右上、右下、左下。

window-rule {
    geometry-corner-radius 8 8 0 0
}

这样，你可以匹配具有方形底角的 GTK 3 应用程序：

一张显示一个只有顶部圆角的窗口的截图

`clip-to-geometry`#

将窗口裁剪到其视觉几何形状。

这将裁剪掉任何客户端窗口阴影，并根据 geometry-corner-radius 圆角化窗口角。

一张显示一个带有圆角的窗口，被裁剪到视觉几何形状的截图

window-rule {
    clip-to-geometry true
}

启用边框，设置 geometry-corner-radius 和 clip-to-geometry，你就得到了一个经典的设置：

一张显示一个带有圆角和边框的窗口的截图

prefer-no-csd

layout {
    focus-ring {
        off
    }

    border {
        width 2
    }
}

window-rule {
    geometry-corner-radius 12
    clip-to-geometry true
}

`tiled-state`#

Since: 25.05

通知窗口它已被平铺。通常，窗口会通过变为矩形并隐藏其客户端阴影来做出反应。将其大小吸附到网格的窗口（例如像 foot 这样的终端）在被平铺时通常会禁用此吸附。

默认情况下，niri 会将平铺状态设置为 true，同时设置 prefer-no-csd，以改善不支持服务器端装饰的应用程序的行为。你可以使用此窗口规则来覆写此设置，例如，在使用 CSD 的情况下获得矩形窗口。

// 在使用 CSD 的同时使平铺窗口变为矩形。
window-rule {
    match is-floating=false

    tiled-state true
}

`baba-is-float`#