Scrolling layout
Settings for the scrolling-column layout and its optional trackpad gestures.
See Scrolling for column navigation and multiple-display limitations.
[settings.layout]mode = "scrolling"
[settings.layout.scrolling]column_width_ratio = 0.7alignment = "center"[settings.layout.scrolling]
Section titled “[settings.layout.scrolling]”Options specific to the Scrolling layout.
window_insertion_point
Section titled “window_insertion_point”Override the layout-wide insertion point for Scrolling. Leave it unset to inherit [settings.layout].window_insertion_point.
animate
Section titled “animate”Animate transitions in Scrolling workspaces independently of settings.animate and Low Power Mode. Set to false to disable scrolling animations. Leave unset to enable them.
column_width_ratio
Section titled “column_width_ratio”Normal width of a column as a fraction of the tiling area. It must stay between min_column_width_ratio and max_column_width_ratio.
preset_column_widths
Section titled “preset_column_widths”Proportional column widths cycled in configured order.
preserve_window_sizes
Section titled “preserve_window_sizes”Keep a window's existing column width when it enters scrolling layout.
expand_single_column
Section titled “expand_single_column”Fill the usable width when a workspace has only one scrolling column. The column's stored width is restored when another column is added.
min_column_width_ratio
Section titled “min_column_width_ratio”Smallest column width allowed by resize commands, from 0.0 through 1.0.
max_column_width_ratio
Section titled “max_column_width_ratio”Largest column width allowed by resize commands, from 0.0 through 1.0.
per_display
Section titled “per_display”Sparse width overrides keyed by display UUID.
alignment
Section titled “alignment”Position used when aligning the focused column: left edge, center, or right edge. focus_navigation_style determines when that alignment is applied.
focus_navigation_style
Section titled “focus_navigation_style”Choose how horizontal focus reveals a column. niri scrolls only as needed in the navigation direction; anchored always places the focused column at the chosen alignment.
[settings.layout.scrolling.gestures]
Section titled “[settings.layout.scrolling.gestures]”Optional horizontal gestures for moving between columns in a Scrolling workspace. The finger count is configurable.
enabled
Section titled “enabled”Enable horizontal swipes for moving between columns in a Scrolling workspace.
animate
Section titled “animate”Animate gesture release independently of structural layout animations. When omitted, inherit the scrolling layout/global animation setting.
invert_horizontal
Section titled “invert_horizontal”Reverse the meaning of left and right column swipes.
vertical_tolerance
Section titled “vertical_tolerance”Allowed vertical finger movement while recognizing the start of a column scroll. Measured in trackpad coordinates: 0.4 and 40 both mean 40% of the trackpad height.
fingers
Section titled “fingers”Number of fingers required for a column swipe.
distance_pct
Section titled “distance_pct”Accumulated horizontal finger travel before Rift sends a scroll update, measured in trackpad coordinates. Smaller values send updates more often. Rift clamps the value from 0.01 to 1.0.
propagate_to_workspace_swipe
Section titled “propagate_to_workspace_swipe”After reaching the end of the column strip, continue the gesture into the adjacent virtual workspace.
workspace_switch_threshold
Section titled “workspace_switch_threshold”Overscroll, in normalized steps, required before the gesture switches workspaces.