Ryoku documentation

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.

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`).

Get started

The desktop

Apps & theming

Extras & plugins

Control & config

Maintenance & help

Advanced

Keybindings

The ones to learn first

Windows

Focus, move, resize

Apps

Shell surfaces and tools

Workspaces

Media and hardware keys

​The ones to learn first

​Windows

​Focus, move, resize

​Apps

​Shell surfaces and tools

​Workspaces

​Media and hardware keys

The ones to learn first

Windows

Focus, move, resize

Apps

Shell surfaces and tools

Workspaces

Media and hardware keys