Start here
Install Ryoku
Boot the signed ISO, verify it, and install onto your hardware.
Convert existing Arch
Already on Arch? Turn it into a Ryoku machine with one reversible command.
First boot
What you see after login, and where to click first.
Desktop tour
Workspaces, the bar, launcher, feature sidebar, and Ryoku Settings.
What ships
- Desktop: a Hyprland session with a Quickshell top bar, launcher, feature sidebar, lock screen, and the Ryoku Settings control center.
- The
ryokucommand: one tool for updates, rollback, status, and self-healing, backed by signed packages and, on a btrfs root, snapper snapshots wrapped around every update. - Theming: wallpaper-driven colors via matugen, plus switchable full-system themes (Ryoku Default, Catppuccin, Tokyo Night, Gruvbox, Nord, Rosé Pine, and more).
- Daily-driver fit: development, content work, media, notes, terminals, and container workflows on strong hardware.
Go deeper
Navigation & windows
Move between workspaces, tile and float windows, and drive the layout.
Ryoku Settings
The Hub: panels that edit your desktop live, with undoable preview.
Themes & wallpapers
The matugen palette, the shipped themes, and the wallpaper pickers.
The ryoku command
Update, roll back, snapshot, and heal your system from one CLI.

