User interface

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

All three features are disabled by default.

Examples are config fragments

Edit matching tables in your existing config; do not repeat their headers. Keep your [keys] shortcuts. For a complete file, start with Quick start.

Example

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

[settings.ui]

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

[settings.ui.menu_bar]

Show workspace status in the macOS menu bar.

enabled

Enable the menu bar workspace indicator.

Type

boolean

Default

true

show_empty

Include workspaces that currently have no windows.

Type

boolean

Default

false

mode

Show every workspace or only the active one.

Type

all or active

Default

"all"

active_label

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

Type

index or name

Default

"index"

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

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]

Show a small edge indicator for stacked windows.

enabled

Enable the stack-line indicator.

Type

boolean

Default

false

Example

[settings.ui.stack_line]
enabled = true
hover = "click"

hover

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

Type

click or hover

Default

"hover"

thickness

Thickness of the stack-line indicator in points.

Type

number

Default

20

NoteOmitting the entire containing table gives 0 instead.

horiz_placement

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

Type

top or bottom

Default

"top"

vert_placement

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

Type

left or right

Default

"left"

spacing

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

Type

number

Default

1

NoteOmitting the entire containing table gives 0 instead.

[settings.ui.mission_control]

Rift’s own Mission Control-style workspace overview.

show_empty_workspaces

Include workspaces without windows in Overview.

Type

boolean

Default

true

window_previews

Show window previews in Rift’s Mission Control overview.

Type

boolean

Default

true

NoteOmitting the entire containing table gives false instead.

enabled

Enable Rift’s Mission Control helper.

Type

boolean

Default

false

Example

[settings.ui.mission_control]
enabled = true

fade_enabled

Fade managed windows during Mission Control transitions.

Type

boolean

Default

false

fade_duration_ms

Fade duration in milliseconds.

Type

number

Default

180

NoteOmitting the entire containing table gives 0 instead.

[settings.ui.stack_line.selected_color]

RGBA color for the selected stack segment. Each component ranges from 0.0 to 1.0.

r

Red component, from 0.0 to 1.0.

Type

number

Default

0

g

Green component, from 0.0 to 1.0.

Type

number

Default

0

b

Blue component, from 0.0 to 1.0.

Type

number

Default

0

a

Opacity component, from 0.0 to 1.0.

Type

number

Default

1

[settings.ui.stack_line.unselected_color]

RGBA color for unselected stack segments. Each component ranges from 0.0 to 1.0.

r

Red component, from 0.0 to 1.0.

Type

number

Default

0

g

Green component, from 0.0 to 1.0.

Type

number

Default

0

b

Blue component, from 0.0 to 1.0.

Type

number

Default

0

a

Opacity component, from 0.0 to 1.0.

Type

number

Default

1

[settings.ui.stack_line.border_color]

RGBA color for segment borders and separators. Each component ranges from 0.0 to 1.0.

r

Red component, from 0.0 to 1.0.

Type

number

Default

0

g

Green component, from 0.0 to 1.0.

Type

number

Default

0

b

Blue component, from 0.0 to 1.0.

Type

number

Default

0

a

Opacity component, from 0.0 to 1.0.

Type

number

Default

1

See also

• Configuration guide
• Window management