Skip to main content
Ryoku profiles your hardware at install time and seeds the right defaults, then hands you the controls in Ryoku Settings (the Hub), opened with Mod+,. Most of what you need is a panel away: displays, GPU, input, and power each have their own place. This page is the map. For hand-editing the underlying files, see Customize; for the GUI panels in full, see Settings.

​
Displays

Ryoku Settings > Displays is the display control panel. It lists every connected output and lets you set, per output:
  • Resolution and refresh rate
  • Scale (fractional scaling for HiDPI panels)
  • Rotation
  • Position in the layout
  • Mirror vs extend
  • Named layout profiles you can switch between
Applying a change writes ~/.config/hypr/monitors.lua, the per-machine drop-in generated by ryoku-monitor. Ryoku rewrites this file on hotplug or a GPU reset, and ryoku update never resets it.
Laptop (eDP) panels expose only their native resolution. To get a smaller logical desktop, use the scale options instead of a lower resolution; they are labelled with the logical resolution they produce (for example 2048x1280) and are the Wayland-correct way to downscale. If Apply toasts a rejection, the compositor refused that mode or scale; pick one of the offered clean-divisor scales.

​
Quick mirror / extend toggle

Press Mod+P to toggle mirror and extend across your displays (it runs ryoku-monitor toggle). Handy for plugging into a projector or a TV without opening Settings. See Keybindings for the full bind list.

​
Hand-pinning a layout

When the panel cannot express what a stubborn display needs (a fake-EDID monitor that wants a forced mode or modeline, a precise position), pin it yourself in ~/.config/hypr/monitors_user.lua. It loads after the generated file, so your pins win, and it is never touched by updates. See Customize.

​
GPU

Ryoku Settings > GPU lists every detected GPU and pins the primary render device through ryoku-gpu. On a hybrid laptop (a discrete NVIDIA or Radeon beside the CPU’s integrated GPU) the integrated GPU is the battery-friendly default, following Hyprland’s own recommendation. Pick the discrete or external GPU there to render the desktop on it instead.
The GPU pin is read once when the compositor starts, so a change takes effect on the next login. Log out and back in to apply it.
The panel writes ~/.config/hypr/gpu.lua and offers three host graphics modes: From a terminal, ryoku-gpu prints what it detected and what it chose:
To force the discrete GPU on a laptop against the battery-first default, run RYOKU_GPU_FORCE=1 ryoku-gpu persist. For a GPU that will not drive the desktop, see Troubleshoot > The wrong GPU is being used.

​
Input

Ryoku Settings > Input covers keyboards and pointing devices:
  • Keyboard layout (and variant)
  • Key repeat rate and delay
  • Pointer and touchpad behaviour (speed, natural scroll, tap-to-click)
The installer carries over the keyboard layout you chose, and the Input panel is where you change it later. Layout changes apply live.

​
Power & idle

Ryoku ships a sensible idle ladder via hypridle. Left untouched, an idle session steps down like this: The session also locks before sleep or suspend, and restores brightness and the displays on resume. The ladder is defined in ~/.config/hypr/hypridle.conf. Alongside it:
  • Battery is read through upower; the shell surfaces charge and status.
  • Brightness is controlled with brightnessctl. Most laptops handle the hardware brightness keys in firmware; if yours does not, bind brightnessctl set +10% / -10% in ~/.config/hypr/user.lua (see Customize).
  • Night light warms the screen through hyprsunset, toggleable on and off and remembered at your chosen colour temperature.

​
See also

Settings

Every Ryoku Settings panel, in full.

Customize

Hand-pin displays and add personal binds in the override files.

Troubleshoot

Wrong GPU, only one resolution, a display that will not apply.

Keybindings

Mod+P and the rest of the shipped binds.
Last modified on July 4, 2026