01 // POWER
Power.
Control you can reach. Runs on day one, reproducible from one repo.
力 · SYSTEM DOSSIER
Ryoku
@ ryoku.dev · public beta
LOCAL --:--:--
- Compositor
- Hyprland
- Shell
- Quickshell
- Base
- Arch Linux
- Theming
- wallust · matugen
- Delivery
- signed packages
30Hub pages
479Settings
10Bar skins
1Source
INK RAMP · 4.6:1 → 12:1
A hand-built Arch Linux desktop, its installer, and the system that rebuilds it exactly. One repository. The live machine is only a target.
The bar, launcher, lock screen, and capture tool are one shell, not a pile of widgets. You edit the repo and redeploy.
ARCH LINUX基盤00 // RYOKU-BASE
one source of truth. the repo is the machine; a live box is only a target.
力POWERBEAUTY美
02 // BEAUTY
Beauty.
Coherent on purpose. One look, one motion, theming that follows the wallpaper.
See it running.
No mockups. Ten captures from a live Ryoku desktop. Every plate is dimmed at rest and blooms to full colour when you point at it. Click for full size.
Extras and plugins
Ryoku ships opinionated, then stays out of the way. Add capability from the Hub, or drop in a widget you wrote. Both stay native to the desktop.
Extras
One-click bundles from the ryoku-extras catalogue. The Hub installs and removes them.
- 01Curated bundles from the ryoku-extras catalogue. Install or remove in one click.
- 02Swap the CachyOS kernel, add repos and workflows. Routed through pacman and AUR.
- 03Every action runs in a floating terminal and reports back. Nothing happens unseen.
Plugins
You write the logic and one view. The shell owns look, motion, sizing, and placement, so it stays native.
~/.local/share/ryoku/plugins/<id>/
- manifest.jsonwhat it is + defaults
- service/Main.qmllogic and state
- content/Widget.qmlone view
- bin/scripts it runs
力 · Install
Three ways in.
01 // ISO
Fresh disk
Download the Ryoku ISO, boot it, and the guided TUI installer partitions, installs, and wires the whole desktop for you. The way in for a fresh disk.
02 // SHELL
Convert in place
One command turns an existing Arch machine into a Ryoku one: config backup, repo trust, desktop set. Reversible with a generated restore script.
03 // KERNEL
Tune the core
After install, the Hub's Extras swaps in the CachyOS kernel as an opt-in: LTO, x86-64-v3, sched-ext. Your stock Arch kernel stays as the fallback.
力 · Tested on
Arch at the core. Run and verified against the shells and spins people already use.
Arch Linuxthe base
CachyOSkernel + repo
Omarchytested
iniRtested
Caelestiatested
Noctaliatested
This is a public beta. It shows its cracks.
Unfinished on purpose, in the open. You are seeing Ryoku while it is still being built, not a frozen release.
BETA · v0.1.0-beta.13tracked live from GitHub
Common questions.
What is Ryoku?
Ryoku is a hand-built Arch Linux distribution with a complete, pre-configured Hyprland (Wayland) desktop. It ships the desktop, a guided installer, and the system definition that reproduces it from a single source of truth, so a fresh machine boots straight into a polished, ready-to-use desktop.
Read the manual →Is Ryoku free and open source?
Yes. Ryoku is free and open source, built on Arch Linux and developed in the open on GitHub. There is no paid tier: you install it, update it, and roll it back with the built-in ryoku command, and the desktop ships as signed packages.
Source on GitHub →Is Ryoku an Omarchy alternative?
Yes. Ryoku shares Omarchy’s philosophy — an opinionated, keyboard-driven, pre-riced Arch and Hyprland desktop that works on day one — and grew from that lineage, but it ships its own Quickshell UI, the Ryoku Settings control center, a plugin and Extras catalogue, and a reproducible single-source system driven by the ryoku CLI. If you like the Omarchy idea, Ryoku is a close, actively developed alternative.
Omarchy heritage →How do I install Ryoku?
Download and boot the signed Ryoku ISO, and the guided TUI installer partitions the disk, installs the base system and desktop, and reboots you into Hyprland. Already running Arch? One reversible command converts an existing machine in place.
Install guide →What hardware does Ryoku need?
Ryoku targets modern 64-bit (x86-64) desktops and laptops with AMD, Intel, or NVIDIA graphics, and the installer detects your GPU and displays automatically. 16 GB of RAM is comfortable, and you can try the whole thing in a virtual machine first.
Hardware notes →How do I update or roll back Ryoku?
Run ryoku update: it snapshots the system, updates from the signed package repository, re-lays the config, and reloads the desktop. If an update ever misbehaves, ryoku rollback (or a snapshot from the Limine boot menu) restores the previous state.
Updates & rollback →Know when it's stable.
No newsletter, no drip. Two mails, then your address is gone.
- 1× Confirmation the moment you sign up.
- 1× One mail when the stable build ships.
- 0× Everything after. Your address is erased.