v0.57.7-beta.19 195Docs

· SYSTEM DOSSIER

Ryoku

@ ryoku.dev · public beta

LOCAL --:--:--

Compositor
Hyprland
Shell
Quickshell
Base
Arch Linux
Theming
matugen
Delivery
signed packages
30Hub pages
479Settings
10Bar skins
1Source
INK RAMP · 4.6:1 → 12:1
Install RyokuSource

195 stars 9 forks GPL-3.0 open source

RYOKU-ONOGORO
EditionOnogorov0.57.7-beta.19
SCROLL

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
A marble fist gripping a katana, engraved irezumi across the stone, dithered to bone
01 // POWER

Power.

Control you can reach: change your desktop by using it, not by editing files. Ready on day one, reproducible from one repo.

A blindfolded marble Lady Justice with scales and sword, engraved irezumi, dithered to bone
02 // BEAUTY

Beauty.

Coherent on purpose. One look, one motion, theming that follows the wallpaper.

· Preinstalled

Everything, already installed.

A fresh box boots into a finished desktop: apps, tools, and toolchains already in place.

90packages, grouped
13built by Ryoku
13–15 GiBon disk, fresh

力 // PREINSTALLED

What ships out of the box

The Ryoku desktop

Ryoku’s own software, built from the monorepo and served from the signed [ryoku] repo.

  • ryoku-shellBar, pill, launcher, overview, capture, lock screen
  • ryoku-hubRyoku Settings, the control center
  • ryokuThe CLI: update, doctor, rollback, snapshots
  • ryoku-rashinThe local agent OS, daemon and dashboard
  • prowl-agentCode-intelligence indexer for the agent OS
  • ryostoreThe store: themes, rices, plugins, lockscreens
  • ryogamiThe wallpaper daemon: catalog, applies, depth
  • ryomotionScreen-demo recorder and editor
  • ryotunesThe music app, native playback (Tauri + libmpv)
  • ryoku-blobsThe shared Ryoku.Blobs QML plugin
  • gpkGlazePKG, the RyokuArch package manager
  • Hyprland pluginshyprglass, imgborders, dynamic cursors, toggled from the Hub
  • ryoku-cursorsThe default Bibata pointer set

Core system & boot

Kernel, the encrypted-Btrfs boot chain, and automatic snapshots.

  • base, base-develCore system and build tools
  • linux, linux-firmwareThe stock kernel and firmware
  • linux-headers, dkmsOut-of-tree module builds
  • rustSo every box can build its Rust dependencies
  • mkinitcpio, btrfs-progs, cryptsetupThe initramfs, Btrfs, LUKS encryption
  • limine, plymouthThe bootloader and the boot splash
  • snapper, snap-pacA snapshot around every pacman transaction

Networking, Bluetooth & audio

Connectivity and a full PipeWire stack with the Bluetooth codecs.

  • networkmanager, iwdNetworking and the default Wi-Fi backend
  • wpa_supplicant, iwThe WPA3 fallback and power-save control
  • bluez, bluez-utilsThe Bluetooth stack and bluetoothctl
  • pipewire (+ pulse, alsa, audio)The audio server and A2DP codecs
  • wireplumberThe PipeWire session manager
  • rtkit, alsa-utilsRealtime scheduling; the classic mixers

Graphics & the session

The Wayland compositor, the Qt6 runtime, portals, and the themes.

  • hyprland, xorg-xwaylandThe compositor and X11 app support
  • mesa, vulkan-icd-loaderThe GL and Vulkan base
  • qt6-*wayland, declarative, 5compat, svg, multimedia
  • xdg-desktop-portal-*Screen-share (Hyprland) and file chooser (GTK)
  • hyprpolkitagentThe polkit authentication agent
  • westonThe Wayland compositor that hosts the SDDM greeter
  • sddmThe login greeter
  • gst-plugins-*, gst-libavGStreamer media codecs
  • polkit, gnome-keyringAuthorization and the secrets store
  • papirus, adwaita, adw-gtk-themeThe icon and dark GTK themes
  • flatpakThe portable app channel

Wayland tools

The small daemons the desktop leans on every session.

  • matugenRecolors everything from the wallpaper
  • hypridle, hyprsunsetIdle/lock management and the night light
  • brightnessctl, ddcutilLaptop and external-monitor brightness
  • upower, power-profiles-daemonBattery status and power profiles
  • grim, slurp, hyprpickerScreenshot, region select, color picker
  • wl-clipboard, cliphistThe clipboard and its history
  • playerctlMedia control over MPRIS
  • fuzzelA fallback launcher

Everyday apps

The applications you actually open on day one.

  • chromium, firefoxTwo browsers, both engines on hand
  • kittyThe default terminal
  • mpv (+ mpris)The media player
  • nautilus (+ python)The file manager and its stash actions
  • spotify-launcherSpotify, wired to the Canvas widget

Terminal, CLI & TUI

A command line that is already comfortable.

  • fish, zsh, starshipThe shells and the prompt
  • bat, eza, fd, fzf, ripgrep, zoxideThe modern coreutils layer
  • fastfetch, jqSystem readout and JSON on the CLI
  • git, github-cli, lazygitVersion control and a git TUI
  • neovimThe editor
  • btopThe resource monitor
  • yaziA terminal file manager

Capture & shell helpers

The screen tools, plus what the shell shells out to.

  • quickshellThe framework the shell UI runs on
  • cavaThe audio visualizer
  • waifu2x-ncnn-vulkanGPU upscaler for HD export and Enhance
  • imagemagick, ffmpeg, yt-dlpImage/media processing and download
  • tesseract, zbarOCR text grab and QR scanning
  • gpu-screen-recorder, wf-recorderScreen recording, with a fallback
  • wtype, libqalculate, songrecVoice typing, calculator, Recognize Music
  • openrgbKeyboard and LED accent sync

Developer toolchains

Every machine is dev-ready the moment it boots.

  • goThe Go toolchain
  • nodejs, npmNode and npm
  • python, python-pip, python-pipxPython with pip and pipx
  • miseA runtime version manager

Gaming & virtualization

A Bazzite-style gaming stack and the base VM tooling.

  • gamescopeA nested micro-compositor that isolates a game
  • gamemodeThe performance governor Steam invokes
  • mangohudThe FPS and frametime overlay
  • qemu-desktop, edk2-ovmf, virglrendererThe base VM stack

Fonts

UI text, Japanese labels, emoji, terminal glyphs, icon symbols.

  • inter-font, otf-space-groteskThe UI sans stack
  • noto-fonts (+ cjk, emoji)Latin, Japanese, and emoji coverage
  • ttf-*-nerd, ttf-maple-mono-nfTerminal and code fonts with glyphs
  • ttf-material-symbols-variableThe icons the bar and pill are drawn from

From the AUR (after install)

Built in the post-install step. Best-effort; the box comes up fine without them.

  • yay-binThe AUR helper, bootstrapped first
  • zen-browser-binZen, the default browser
  • voxtype-binThe offline Whisper voice-dictation daemon
  • localsend-binAirDrop-style LAN file sharing
  • nvibrant-binNVIDIA digital vibrance for the pill fader
  • phinger / catppuccin / apple cursorsExtra cursor themes for the Hub picker
  • ttf-fraunces-variableFraunces, the editorial brand serif

The CachyOS layer

On the CachyOS image only. Install from that ISO and a Ryoku box is a CachyOS box.

  • linux-cachyos (+ headers)The optimized kernel, booted by default
  • cachyos-settingsThe sysctl, udev, and systemd tuning
  • ananicy-cpp (+ rules)Auto-nice daemon for a responsive compositor
  • scx-schedsThe sched-ext userspace schedulers
  • proton-cachyos-slrThe CachyOS-tuned Proton for Steam and Lutris
  • cachyos keyring + mirrorlistsTrust and mirrors for ongoing updates

Storage footprint

Measured by the installer to size the root partition.

  • On disk, freshThe base + dev + desktop closure lands at ~13–15 GiB after Btrfs zstd:1 compression.
  • Root floorThe installer reserves 20 GiB for AUR builds, snapshots, and first-launch downloads.
  • Minimum disk32 GiB for a whole-disk install; 2 + 20 + swap GiB free to dual-boot.
system/packages/ · release/packages/ryoku-desktop
Marble columns and torii gates receding into the dark, dithered to bone

· Install

Two ways in.

01 // ISO

Fresh disk

Boot an ISO and the guided installer partitions, installs, and wires the desktop. Both install offline: plain Arch, or CachyOS with its kernel baked in.

Archreleases
CachyOSreleases
02 // SHELL

Convert in place

One command turns an existing Arch machine into Ryoku: config backup, repo trust, desktop set. Reversible with a generated restore script.

Want it on NixOS?An officially recognised community port.

· Verify

Check it before you boot it.

Every image is signed by Ryoku Releases <releases@ryoku.dev> and published with its signature and checksum. Three commands prove the file on your disk is the one we built. About a minute.

  1. 01Import the release key

    Pulls our release public key into your GPG keyring.

  2. 02Confirm the fingerprint

    A signature only counts once you know the key is ours.

    Must printgpg groups it in fours. Every character must match.

  3. 03Verify the image

    Run it where you saved the ISO, its .sig and its .sha256.

What good looks like

gpg: Good signature from "Ryoku Releases <releases@ryoku.dev>"
ryoku-<date>-x86_64.iso: OK

And what it doesn't

gpg also warns the key is not certified with a trusted signature. That is normal: it only means you never personally signed it. But without Good signature and OK, the file is not ours. Delete it, do not boot it.

· Tested on

Arch at the core. 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 it while it is still being built, not a frozen release.

BETA · v0.57.7-beta.19tracked live from GitHub
A fractured marble bust, its mend seams catching the light, dithered to bone

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 that reproduces it from one source of truth.

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, and the desktop ships as signed packages.

Source on GitHub →

Is Ryoku an Omarchy alternative?

Yes, and it is its own project, not a fork. You get the same opinionated, keyboard-driven, pre-riced Arch and Hyprland spirit, built from the ground up with its own Quickshell desktop, a control center, and a reproducible single-source system.

How they compare →

How do I install Ryoku?

Boot the signed Ryoku ISO and the guided installer partitions the disk, installs the desktop, and reboots you into Hyprland. Already on Arch? One reversible command converts a machine in place.

Install guide →

What hardware does Ryoku need?

Modern 64-bit (x86-64) AMD, Intel, or NVIDIA hardware; the installer detects your GPU and displays automatically. 16 GB of RAM is comfortable, and you can try it 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, and reloads the desktop. If an update ever misbehaves, ryoku rollback restores the previous state.

Updates & rollback →

Know when it's stable.

No newsletter, no drip. Two mails, then your address is gone.

  1. 1× Confirmation the moment you sign up.
  2. 1× One mail when the stable build ships.
  3. 0× Everything after. Your address is erased.

[ notify_once ]

Waitlist

no spam · no tracking · erased after stable