Skip to main content
After install, the machine reboots into SDDM. Pick the Ryoku (Hyprland) session and log in.

​
What you see

  • The frame. A rounded screen border, the desktop’s signature chrome. Popouts melt into it instead of floating on top.
  • The pill. A morphing bar at the top of the screen, and its popouts. It is the centerpiece of the desktop; everything you summon (notifications, the GNOME keyring prompt, the update island) grows from it.
  • The wallpaper, with the clock and weather desktop widgets painted on it.
  • No windows yet. Hyprland is a tiling compositor, so nothing is open until you open it.
Mod is Super (the Windows or Cmd key on most keyboards).

​
Four keys worth pressing first

Open a terminal

Mod + Return launches kitty, the shipped terminal.

Open the launcher

Mod + Space opens the app launcher. Type to filter, Enter to launch.

Open Ryoku Settings

Mod + , opens the Hub, the live control center for the whole desktop. See Settings.

See the keybind legend

Mod + K opens the Hub on its live shortcut legend. It is the same data as the Keybindings page, read from the running Hyprland config.

​
Next steps

  • Navigation: the keyboard workflow — open, focus, move, and tile windows across workspaces.
  • Desktop tour: the shell surfaces and where things live.
  • Keybindings: the full shipped reference, grouped by purpose.
  • Customize: wallpapers, themes, and your own ~/.config/hypr/user.lua.

​
If nothing draws

If the pill, the launcher, or Ryoku Settings fail to appear, switch to a TTY (Ctrl + Alt + F2), log in, then restart the shell and read its log:
Troubleshoot covers the common boot and login issues.
Last modified on July 4, 2026