Navigation

Hyprland is a tiling compositor. New windows claim their share of the screen automatically — no dragging, no overlapping stacks to shuffle. You drive the whole desktop from the keyboard, and Mod is Super (the Windows or Cmd key). This page walks the everyday workflow. Keybindings is the exhaustive reference for every shipped bind; come back here for how they fit together.

​

Open a couple of windows

When you log in nothing is open, because a tiling compositor only shows what you launch. Open one window, then a second, and watch Hyprland split the screen between them. Mod + Q closes the active window. The launcher (Mod + Space) opens anything else — type to filter, Enter to launch.

​

Focus and move windows

Focus follows direction, not a fixed cycle order. There is no cycle-through-every-window bind. To jump straight to a specific window, open the launcher (Mod + Space) and type its title or app name — the launcher lists open windows alongside apps and focuses the one you pick. The overview (Mod + Tab) is the visual alternative: click any window to focus it.

​

Resize windows

Two ways, depending on whether you want a quick nudge or a sustained resize.

• Nudge. Mod + Ctrl + Arrow grows or shrinks the active window a step at a time. Hold it to keep resizing.
• Resize mode. Mod + R enters a resize submap and pops a toast. Now the bare arrows — or hjkl — resize the window; Esc (or Return, or Mod + R again) leaves the mode. The submap is exclusive, so plain arrows resize instead of moving focus.

​

Float and fullscreen

• Mod + F toggles fullscreen for the active window.
• Mod + A floats the active window at 1000 × 660, centred. Press it again to tile the window back into the layout. Reach for it when you want a calculator, a small dialog, or one window lifted out of the tiles.

​

Workspaces

Each monitor carries ten workspaces. The number keys are desktop-relative. A desktop is a block of ten workspace ids, so on desktop 2, Mod + 3 focuses workspace 13, never workspace 3 — each desktop keeps its own 1–10 and windows never jump between desktops. The workspace is also pulled to whichever monitor the cursor is on, so the same keys drive every screen instead of always yanking focus to the laptop panel.

​

The overview

Mod + Tab opens a full-screen expo: every workspace on the current desktop as a scaled mini-desktop with live window previews. From here you can:

• Click a workspace to switch to it, or click a window to focus it.
• Drag a window between workspaces, or up onto the top strip to move it to another desktop.
• Hover a window for a ✕ to close it.
• Scroll or Tab to move the selection, Enter to commit, Esc to dismiss.

A second level shows your desktops — each a block of ten workspaces with its own 01–10 set, so you can keep separate groups of workspaces for different work. Mod + Alt + Tab steps between desktops (Tab again inside the overview cycles them).

​

Scratchpad

The scratchpad is a hidden special workspace for a window you want one keypress away — a notes terminal, a chat, a music player.

• Mod + H toggles the scratchpad in and out of view.
• Mod + Shift + H stashes the active window into it (floated at 1280 × 800, centred).

Press Mod + H again to tuck it back out of sight.

​

Mouse

You rarely need the mouse, but it is there when a quick drag is faster:

• Mod + Left-drag moves the window under the cursor.
• Mod + Right-drag resizes it.

​

Multiple monitors

Ryoku is monitor-aware. Because Mod + 1 … 0 pulls the target workspace to the monitor your cursor is on, the workspace keys always act on the screen you are pointing at — you never reach for a different set of binds per display. Mod + P toggles mirror versus extend (ryoku-monitor toggle). Set resolutions, scale, rotation, and layout in Settings → Displays; see Hardware for the details.

​

Next