# Hyprland Cheat Sheet

> Mod key = **SUPER** (Windows key). Matches `~/.config/hypr/hyprland.conf`.

## Launch / quit

| Keys | Action |
|---|---|
| `SUPER + Return` | Open terminal (kitty) |
| `SUPER + D` | App launcher (fuzzel) |
| `SUPER + E` | File manager (yazi in kitty) |
| `SUPER + Q` | Close focused window |
| `SUPER + SHIFT + Q` | Exit Hyprland (logout) |

DMS also has its own spotlight launcher — usually reachable from the bar; check `dms --help` for the binding if you want to rebind.

## Window control

| Keys | Action |
|---|---|
| `SUPER + F` | Fullscreen |
| `SUPER + V` | Toggle floating |
| `SUPER + P` | Pseudotile (shrink in its tile) |
| `SUPER + J` | Toggle split direction |
| `SUPER + drag mouse` (left btn) | Move window |
| `SUPER + drag mouse` (right btn) | Resize window |

## Focus and movement

| Keys | Action |
|---|---|
| `SUPER + ←/→/↑/↓` or `h/l/k/j` | Focus window in that direction |
| `SUPER + SHIFT + ←/→/↑/↓` | Move window in that direction |

## Workspaces

| Keys | Action |
|---|---|
| `SUPER + 1..9, 0` | Switch to workspace 1..10 |
| `SUPER + SHIFT + 1..9, 0` | Move window to workspace 1..10 |
| `SUPER + scroll wheel` | Cycle workspaces |
| `SUPER + S` | Show/hide scratchpad (`magic`) |
| `SUPER + SHIFT + S` | Send window to scratchpad |

Workspaces are numbered and per-monitor — no "activities" overview. Jump directly with SUPER+N.

## Screenshots

Saved to `~/Pictures/Screenshots/`.

| Keys | Action |
|---|---|
| `Print` | Whole output |
| `SHIFT + Print` | Region select |
| `CTRL + Print` | Active window |

## Media / brightness (laptop keys)

Volume, mute, mic mute, brightness up/down, play/pause/next/prev all mapped to the corresponding `XF86*` keys.

## Clipboard history

`cliphist` records everything copied. To paste from history:

```
cliphist list | fuzzel -d | cliphist decode | wl-copy
```
Bind that to `SUPER + SHIFT + V` later if you use it a lot.

## Recovery

- **Stuck session:** `Ctrl+Alt+F3` → TTY login → `loginctl terminate-user $USER`.
- **Logs:** `~/.cache/hyprland/hyprland.log` and `journalctl --user -b`.
- **Fallback session:** log out, pick **GNOME** or **Sway** from the GDM session gear.
- **Reload config without logout:** `hyprctl reload`.
- **Inspect state:** `hyprctl clients`, `hyprctl monitors`, `hyprctl workspaces`.

## DMS basics

- Config lives at `~/.config/DankMaterialShell/` (or under `~/.config/quickshell/`).
- `dms setup` — re-run to regenerate baseline.
- `dms run` — manually start the shell (already in autostart).
- Bar usually has a right-click menu for quick settings, theme, widgets.

## Cheatsheet upkeep

Edit this file whenever you change a binding in `hyprland.conf`. Commit alongside the config change.