Skip to content
Rift

User interface

Optional indicators for the menu bar, stack line, and Mission Control.

All three features are disabled by default.

Example
[settings.ui.menu_bar]
enabled = true
display_style = "label"
active_label = "name"

[settings.ui]

Section titled “[settings.ui]”

Optional visual indicators. All UI helpers are disabled by default.

[settings.ui.menu_bar]

Section titled “[settings.ui.menu_bar]”

Show workspace status in the macOS menu bar.

enabled

Section titled “enabled”

Enable the menu bar workspace indicator.

Type
boolean
Default
false

show_empty

Section titled “show_empty”

Include workspaces that currently have no windows.

Type
boolean
Default
false

mode

Section titled “mode”

Show every workspace or only the active one.

Type
all or active
Default
"all"

active_label

Section titled “active_label”

Label a workspace with its one-based workspace number or its configured name.

Type
index or name
Default
"index"

display_style

Section titled “display_style”

Draw a miniature representation of each workspace’s windows (layout) or show a number or name (label).

Type
layout or label
Default
"layout"

layout_folder

Section titled “layout_folder”

Folder containing saved .ron layouts shown in the menu bar’s restore menus. ~ expands to your home directory.

Type
path
Default
"~/.config/rift/layouts"

[settings.ui.stack_line]

Section titled “[settings.ui.stack_line]”

Show a small edge indicator for stacked windows.

enabled

Section titled “enabled”

Enable the stack-line indicator.

Type
boolean
Default
false
Example
[settings.ui.stack_line]
enabled = true
hover = "click"

hover

Section titled “hover”

Choose whether the indicator responds to a click or pointer hover.

Type
click or hover
Default
"hover"

thickness

Section titled “thickness”

Thickness of the stack-line indicator in points.

Type
number
Default
20

horiz_placement

Section titled “horiz_placement”

Place the stack line at the top or bottom edge of the window.

Type
top or bottom
Default
"top"

vert_placement

Section titled “vert_placement”

Place the stack line at the left or right edge of the window.

Type
left or right
Default
"left"

spacing

Section titled “spacing”

Distance from the window edge to the indicator, in macOS points.

Type
number
Default
1

[settings.ui.mission_control]

Section titled “[settings.ui.mission_control]”

Rift’s own Mission Control-style workspace overview.

enabled

Section titled “enabled”

Enable Rift’s Mission Control helper.

Type
boolean
Default
false
Example
[settings.ui.mission_control]
enabled = true

fade_enabled

Section titled “fade_enabled”

Fade managed windows during Mission Control transitions.

Type
boolean
Default
false

fade_duration_ms

Section titled “fade_duration_ms”

Fade duration in milliseconds.

Type
number
Default
180

See also

Section titled “See also”