Configuration: Named Workspaces - niri

Table of Contents

Overview

Overview

^{Since: 0.1.6}

You can declare named workspaces at the top level of the config:

workspace "browser"

workspace "chat" {
    open-on-output "Some Company CoolMonitor 1234"
}

Contrary to normal dynamic workspaces, named workspaces always exist, even when they have no windows. Otherwise, they behave like any other workspace: you can move them around, move to a different monitor, and so on.

Actions like focus-workspace or move-column-to-workspace can refer to workspaces by name. Also, you can use an open-on-workspace window rule to make a window open on a specific named workspace:

// Declare a workspace named "chat" that opens on the "DP-2" output.
workspace "chat" {
    open-on-output "DP-2"
}

// Open Fractal on the "chat" workspace, if it runs at niri startup.
window-rule {
    match at-startup=true app-id=r#"^org\.gnome\.Fractal$"#
    open-on-workspace "chat"
}

Named workspaces initially appear in the order they are declared in the config file. When editing the config while niri is running, newly declared named workspaces will appear at the very top of a monitor.

If you delete some named workspace from the config, the workspace will become normal (unnamed), and if there are no windows on it, it will be removed (as any other normal workspace). There's no way to give a name to an already existing workspace, but you can simply move windows that you want to a new, empty named workspace.

^{Since: 0.1.9} open-on-output can now use monitor manufacturer, model, and serial. Before, it could only use the connector name.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Overview

Usage

Configuration

Development