Skip to content
rift

General

Animation, focus behavior, Space activation, and hot reload.

Example

[settings]
animate = true
animation_duration = 0.2

Table

[settings]

Section titled “[settings]”

Global behavior shared by the active layout and the rest of Rift.

animate

Section titled “animate”

Animate layout changes and focus transitions. Keep this off while troubleshooting layout behavior.

Type
boolean
Default
false

animation_duration

Section titled “animation_duration”

Animation duration in seconds when animate is enabled. Must not be negative.

Type
number
Default
0.3

animation_fps

Section titled “animation_fps”

Target animation frame rate. Higher values look smoother but use more CPU. Must be greater than zero.

Type
number
Default
100

animation_easing

Section titled “animation_easing”

Curve used to accelerate and decelerate animations.

Type
text
Default
"ease_in_out"

Possible values

  • ease_in_out
  • linear
  • ease_in_sine
  • ease_out_sine
  • ease_in_out_sine
  • ease_in_quad
  • ease_out_quad
  • ease_in_out_quad
  • ease_in_cubic
  • ease_out_cubic
  • ease_in_out_cubic
  • ease_in_quart
  • ease_out_quart
  • ease_in_out_quart
  • ease_in_quint
  • ease_out_quint
  • ease_in_out_quint
  • ease_in_expo
  • ease_out_expo
  • ease_in_out_expo
  • ease_in_circ
  • ease_out_circ
  • ease_in_out_circ

default_disable

Section titled “default_disable”

Start each newly encountered macOS Space inactive. Press your activation key before Rift manages it.

Type
boolean
Default
true

mouse_follows_focus

Section titled “mouse_follows_focus”

Allow Rift to move the pointer with keyboard-driven focus and workspace changes.

Type
boolean
Default
true

mouse_hides_on_focus

Section titled “mouse_hides_on_focus”

Hide the pointer after Rift changes the focused window. Rift also hides it after a pointer warp when mouse_follows_focus is enabled.

Type
boolean
Default
true

focus_follows_mouse

Section titled “focus_follows_mouse”

Ask Rift to focus a managed window when the pointer moves over it.

Type
boolean
Default
true

horizontal_mouse_warp

Section titled “horizontal_mouse_warp”

Treat displays stacked in macOS as a horizontal mouse chain when they are physically side-by-side. top-to-bottom puts the upper display logically left; bottom-to-top reverses that order. Crossing a left/right edge enters the neighboring display at the same vertical offset only if that position exists. This does not change macOS display arrangement.

Type
top-to-bottom or bottom-to-top (optional)
Default
Not set

Example

[settings]
horizontal_mouse_warp = "top-to-bottom"

focus_follows_mouse_disable_hotkey

Section titled “focus_follows_mouse_disable_hotkey”

Optional hotkey held to temporarily suspend focus-follows-mouse. Use a full hotkey such as Ctrl + A or a modifier such as Ctrl.

Type
hotkey (optional)
Default
Not set

Example

[settings]
focus_follows_mouse_disable_hotkey = "Ctrl"

auto_focus_blacklist

Section titled “auto_focus_blacklist”

Bundle identifiers that should not cause Rift to switch workspaces when those applications become active, such as Spotlight.

Type
list of text values
Default
Empty list

hot_reload

Section titled “hot_reload”

Reload the config file when it changes. Even when this is false, Rift watches for keymap changes and reloads when the parsed bindings differ.

Type
boolean
Default
true

See also

Section titled “See also”