Skip to main content

Concepts

Screens​

The screen selector chooses the target screen exposed by the active platform adapter. Each screen has an id, label, resolution, and work area. On the current Linux X11 adapter, the work area comes from the root window's _NET_WORKAREA property, with a single detected X11 screen fallback.

Windows​

The catalog contains WindowDescriptor values returned by Rust. A window must have an app name and be movable, resizable, and not fullscreen to reach the arrange view. X11 also filters common non-normal window types such as docks, menus, toolbars, notifications, utility windows, and splash windows.

Zones and layouts​

A layout is a named set of two or three zones. The layout engine turns a screen work area plus margin, gap, columns, rows, and optional ratio into rectangles. The five seeded presets are:

  • Two Columns
  • Three Columns
  • Focus + Stack
  • Main + Sidebar
  • 3 Wide Center

Saved layouts use the same data model as presets but are stored separately by type. See Layouts for the user workflow.