Skip to content
Rift

General

Animation, pointer behavior, Space activation, hot reload, and dragging tiled windows.

Example
[settings]
animate = true
animation_duration = 0.2

[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

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

[settings.window_snapping]

Section titled “[settings.window_snapping]”

Mouse-drag behavior for swapping tiled windows.

drag_swap_fraction

Section titled “drag_swap_fraction”

Overlap needed to select a drag-swap target. Rift divides the intersection area by the union area of the two windows. Lower values make swaps easier to trigger.

Type
number
Default
0.3
Example
[settings.window_snapping]
drag_swap_fraction = 0.3

See also

Section titled “See also”