> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ryoku.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Keybindings

> Every shipped Ryoku keybinding, grouped by purpose.

`Mod` is `Super` (the Windows or Cmd key) on a normal Ryoku install. These are
the binds shipped by `ryoku/hyprland/modules/binds.lua`.

To swap a chord for your own, use the Keybinds page in Ryoku Settings
(`Mod + ,`): it generates `rebinds.lua`, so the shipped chord is simply never
registered. Brand-new binds of your own go in `~/.config/hypr/user.lua`
(loaded last, never touched by updates). See [Customize](/docs/customize).

## The ones to learn first

| Binding        | Action                                                              |
| -------------- | ------------------------------------------------------------------- |
| `Mod + Space`  | App launcher.                                                       |
| `Mod + Return` | Terminal.                                                           |
| `Mod + Escape` | Quick settings: connectivity, sound, calendar, power.               |
| `Mod + Tab`    | Workspace overview: live previews, drag windows between workspaces. |
| `Mod + ,`      | Ryoku Settings.                                                     |
| `Mod + Q`      | Close the active window.                                            |
| `Mod + L`      | Lock the session.                                                   |

## Windows

| Binding   | Action                                                    |
| --------- | --------------------------------------------------------- |
| `Mod + Q` | Close the active window.                                  |
| `Mod + F` | Toggle fullscreen.                                        |
| `Mod + A` | Float at 1000 x 660, centred. Press again to tile back.   |
| `Mod + R` | Enter resize mode. Arrows or `hjkl` resize, `Esc` exits.  |
| `Mod + P` | Toggle mirror / extend displays (`ryoku-monitor toggle`). |

## Focus, move, resize

| Binding                                  | Action                                                    |
| ---------------------------------------- | --------------------------------------------------------- |
| `Mod + Left / Right / Up / Down`         | Focus the neighbour in that direction.                    |
| `Mod + Shift + Left / Right / Up / Down` | Move the active window.                                   |
| `Mod + Ctrl + Left / Right / Up / Down`  | Resize the active window in 40 px steps (hold to repeat). |
| `Mod + Left-drag`                        | Move the window under the cursor.                         |
| `Mod + Right-drag`                       | Resize the window under the cursor.                       |

Focus is direction-only. `hjkl` is the resize-mode vocabulary, not a focus
binding, and `Mod + H` belongs to the scratchpad (see Workspaces).

## Apps

| Binding         | Action                           |
| --------------- | -------------------------------- |
| `Mod + Return`  | Terminal.                        |
| `Mod + E`       | File manager.                    |
| `Mod + Alt + E` | Yazi, the terminal file manager. |
| `Mod + B`       | Browser.                         |
| `Mod + N`       | Editor.                          |
| `Mod + O`       | Notes.                           |

Each launches your chosen app for that role; pick them on the Default Apps
page in Ryoku Settings.

## Shell surfaces and tools

| Binding           | Action                                                                                              |
| ----------------- | --------------------------------------------------------------------------------------------------- |
| `Mod + Space`     | App launcher.                                                                                       |
| `Mod + Escape`    | Quick settings menu.                                                                                |
| `Mod + L`         | Lock the session.                                                                                   |
| `Mod + W`         | Wallpaper and theme menu: scrolling image and live-video belts, a colour filter, and the theme row. |
| `Mod + Shift + W` | Random wallpaper with a random transition.                                                          |
| `Mod + V`         | Clipboard history (a quick settings deep link).                                                     |
| `Mod + T`         | The Stash. Dragging a file to the right screen edge opens it too; dropping stashes the file.        |
| `Mod + Tab`       | Workspace overview.                                                                                 |
| `Mod + Alt + Tab` | Workspace overview stepping desktops; `Alt + Tab` again inside cycles them.                         |
| `Mod + M`         | Toggle the desktop audio visualiser.                                                                |
| `Mod + Shift + M` | Raise the visualiser over windows; again to send it back.                                           |
| `Mod + G`         | Ryolayer, the tool overlay: music, EQ, mic, pinned over the desktop.                                |
| `Mod + Grave`     | Voxtype speech-to-text; tap again to stop.                                                          |
| `Mod + ,`         | Ryoku Settings.                                                                                     |
| `Mod + S`         | Quick capture menu (screenshot, no confirmation).                                                   |
| `Mod + Shift + S` | Ryoshot: screenshot with beautify and annotation.                                                   |
| `Mod + Shift + C` | Pick a colour (`hyprpicker`).                                                                       |
| `Mod + Shift + V` | Summon ryovm (virtual machines) to the current workspace.                                           |

## Workspaces

A **desktop** is a block of ten workspaces, so every desktop keeps its own
`1..10` and windows never jump desktops. The number keys always mean "of the
current desktop", and they drive whichever monitor the mouse is on instead of
yanking focus to the laptop panel.

| Binding              | Action                                                          |
| -------------------- | --------------------------------------------------------------- |
| `Mod + 1 .. 0`       | Focus that slot of the current desktop.                         |
| `Mod + Alt + 1 .. 0` | Send the active window to that slot, staying here.              |
| `Mod + Scroll`       | Previous / next workspace.                                      |
| `Mod + H`            | Toggle the scratchpad (special workspace).                      |
| `Mod + Shift + H`    | Stash the active window in the scratchpad, floated and centred. |

## Media and hardware keys

These work everywhere, including on the lockscreen.

| Binding                              | Action                                                                                                    |
| ------------------------------------ | --------------------------------------------------------------------------------------------------------- |
| `XF86AudioRaiseVolume / LowerVolume` | Default output volume in 5% steps (hold to repeat).                                                       |
| `XF86AudioMute`                      | Toggle mute.                                                                                              |
| `XF86AudioPlay / Next / Prev`        | Media control through `playerctl`.                                                                        |
| `XF86MonBrightnessUp / Down`         | Screen brightness in 5% steps, laptop backlight and external DDC monitors alike (`ryoku-cmd-brightness`). |