Skip to content

Virtual workspaces

Workspace count, names, focus behavior, and rules for assigning windows to workspaces.

See Virtual workspaces for the difference from macOS Spaces and how to navigate them.

Example
[virtual_workspaces]
default_workspace_count = 3
workspace_names = ["Main", "Code", "Chat"]
default_workspace = 0

Rift’s named or numbered work areas. A workspace is a logical layer on top of a macOS Space.

Unavailable

Reserved for future use.

Type
boolean
Default
true

Number of virtual workspaces to create by default. Must be at least 1 and no more than 128.

Type
whole number
Default
4
Unavailable

Reserved for future use.

Type
boolean
Default
true
Unavailable

Reserved for future use.

Type
boolean
Default
true

Switching to the workspace you are already on returns to the previously active workspace.

Type
boolean
Default
false

Stop at the first and last workspace instead of wrapping around.

Type
boolean
Default
false

Names for workspaces in index order. Names make app and workspace rules easier to read; the list cannot be longer than default_workspace_count.

Type
list of text values
Default
["Main", "Development", "Communication", "Utilities"]

Zero-based workspace selected when a new macOS Space is first managed. It must be less than default_workspace_count.

Type
whole number
Default
0

Re-check title-based app rules when a window title changes. Useful for apps that finish naming a window after launch, but it can move a window again later.

Type
boolean
Default
false

Rules that select a layout for a workspace by name or zero-based index.

Example
[[virtual_workspaces.workspace_rules]]
workspace = 1
layout = "traditional"

Workspace name or zero-based index to match.

Type
workspace name or zero-based index
Requirement
Required

Layout to use in the matching workspace.

Type
text
Requirement
Required
Possible values
traditional bsp stack master_stack scrolling