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 pill, launcher, control deck, and Ryoku Settings.
What ships
- Desktop: a Hyprland session with a Quickshell pill, launcher, control deck, 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 wallust, 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
Wallust palettes, the shipped themes, and the wallpaper pickers.
The ryoku command
Update, roll back, snapshot, and heal your system from one CLI.

