A succinct summary of features and keybindings

[rubaboo]

I tried my best to present them in a way that is compact, logical and consistent. No AI was used. This is a product of my laboring to grok PaperWM and memorize it's keybindings. Hopefully other people find it useful.

Feel free to proof-read and suggest improvements.

Note,

• At times, I did not follow rigidly the naming used in the Readme and the application itself. Hopefully this does not cause much confusion.
• For the sake of my own comprehension/memorization, I used "Enter" and "Win", and changed the order of the modifier keys - it should not be too difficult to re-work that as desired.

Here it comes.

---

PaperWM presents a Workspace as a scrollable horizontal strip occupying the full height of a display. Each display can contain multiple workspaces.

Empty workspaces (unless currently displayed) are not associated with a particular display and are available on all displays when moving between/switching workspaces.

PaperWM is aware of how multiple displays are arranged in GNOME Display Settings — use Arrows accordingly.

• Ctrl Alt Shift Arrows : move workspace to adjacent monitor.
• Win Alt Arrows : swap workspaces with adjacent monitor.

A workspace is divided into Columns containing one or more windows. A column is always one widow wide, there are no multiple windows in a same column side by side. Each window occupies the full width of the column.

PaperWM has a Position Bar that indicates the active column. Position Bar can be toggled on/off, together with GNOME TobBar or independently (keyboard shortcut not set by default).

• Win Ctrl B : toggle visibility for both GNOME TopBar and PaperWM Position Bar.

A new window is placed into a new or existing column according to "Open Window Position" preference.

• Win Shift W : cycle through Window Position preference, right-left-down-up.
• Win Enter : open a new window of the same type as the active one, given the application allows for that.
• Win Bksp : close the active window.

A window can be moved to/from an adjacent column. "Adjacent" typically means the column to the right of the current, except when Position preference is LEFT. (However, "end" is always bottom, even when Position preference is UP.)

• Win I : move top window from the adjacent column in to the end of the current column.
• Win O : move bottom window out to a new column.
• Win Shift O : move active window out to a new column.

An active column is always fully visible, but it's position on the display depends on "Window Focus Mode" preference.

• Win Shift C : cycle through Focus Modes, center-edge-default.

Current column can also be centered on the display without changing the Focus Mode.

• Win C : center the active column on the display.

Resizing windows and columns:

• Win F : expand to display width ( +Shift toggle full-screen for the active window)
• Win +,- : increase/decrease window/column width ( +Shift for height — when stacked more than one in a column or free-floating (more on that later))
• Win R : cycle through preset widths ( +Shift for heights )

Navigating:

• Win Tab : cycle recent windows (also Alt Tab) ( +Shift to change direction )
• Win Arrows/,,./Home,End : move focus between windows on the workspace

Add Ctrl to take the active window along:

• Win Shift Arrows : move focus between monitors
• Win PgUp,PgDn : move between workspaces
• Win ` : cycle recent workspaces ( +Shift to change direction )

Multi-window operations are possible, within the same display only.
While holding Win, repeat these actions as necessary:

• Press T to take a window.
• Navigate withing or between workspaces using key combos listed earlier.
• Press Space to drop the last window into the current position.
• Tab to cycle through taken windows ( +Shift to change direction ).
• Q to close all taken windows.

Scratch layer is an additional space, outside workspaces, where windows are free floating and freely resized in any direction.

• Win Ctrl Esc : move curent window to the scratch layer ("escape" the rigid layout of workspaces)
• Win Shift Esc : show/hide scratch layer.
• Win Esc : hide scratch layer/show the most recent scratched window.
• Ctrl Alt Tab : cycle through scratch windows ( +Shift to change direction ).