Shortcuts and gestures

Super is usually the Windows key. These are the built-in defaults. Open Settings → Shortcuts to change bindings and gestures or disable the login guide. Your saved bindings can override these defaults.

Move and resize with the mouse

Action	Result
Super + left-button drag on a floating window	Move the window
Super + right-button drag on a floating window	Resize from the nearest corner
Super + Shift + Space	Switch the focused window between tiled and floating

You can drag from inside the window; a title bar or resize border is not required. To place an app freely, toggle it to floating, then Super-drag it.

Focus, move, and resize

H, J, K, and L mean left, down, up, and right.

Shortcut	Action
Super + H / J / K / L	Focus in that direction
Super + Shift + H / J / K / L	Move the focused window in that direction
Super + Ctrl + H / J / K / L	Resize in that direction
Super + Q	Close the focused window
Super + F	Maximize or restore the window
Super + Shift + F	Enter or leave fullscreen

Maximize fills the available workspace. Fullscreen also hides the bar and window decorations.

Columns and layouts

Shortcut	Action
Super + R	Cycle column width
Super + C	Center the focused column
Super + [	Place the window in a neighbouring column
Super + ]	Extract the window into its own column
Super + M	Switch scrolling / tree layout
Super + Tab	Open or close overview

In scrolling mode, Super + [ uses the left neighbour when available, otherwise the right. Try it with two terminals to place them vertically in one column. Super + ] separates the focused window again.

In overview, select a workspace to see its windows, then click the window you want. Directional focus keys move selection; Enter activates it and Escape closes overview.

Workspaces

Shortcut	Action
Super + 1–9	Switch to that workspace
Super + Shift + 1–9	Move the window to that workspace
Super + Escape	Toggle between the last two visited workspaces on this monitor

Workspaces are created as needed. Selecting one visible on another monitor focuses that monitor.

To make pressing the current workspace's shortcut toggle back too, enable Settings → Windows → Toggle back with the same workspace shortcut. It is off by default. The action can also be bound as workspace-back-and-forth or run with feresectl workspace-back-and-forth.

Desktop actions

Shortcut	Action
Super + Enter	Open the configured terminal (`foot` by default)
Print Screen	Capture the active monitor and open Satty
Super + Shift + S	Select a screenshot area and open Satty
Super + Shift + E	Ask to log out

In Satty, Enter saves the edited screenshot and copies it to the clipboard; Escape discards it. See Configuration for dependencies and custom screenshot commands.

Touchpad gestures

Three-finger swipe	Action on release
Up / down	Next / previous workspace on this monitor
Left / right	Focus the window to the right / left

Short, diagonal, or cancelled swipes do nothing. Gestures can use the same actions as keyboard bindings, including overview or moving a window. Four- and five-finger bindings are supported too.

Add a shortcut

For example, bind a lock command and use a swipe to open overview:

commands {
    lock "ferese-lock"
}
binding "Super+Alt+L" "spawn" "lock"
binding "Swipe3Up" "toggle-overview"

These are examples, not defaults. To disable a built-in binding:

binding "Super+Q" disabled=#true

See Commands and bindings for action names, arguments, and physical-key matching.

3.8 KiB Raw Blame History Unescape Escape