extras
Install apps, drivers, compatibility layers, and workflow tooling. Gaming, audio, office, creator, developer, SecPulse — full setups that stay outside the base image until the user asks.
[ 00 / SYSTEM ]nixos, with a point of view0.1.0-alpha
RyokuPower& beauty.On NixOS.
Descends from Omarchy, rebuilt on NixOS as a single flake, then shaped into Ryoku: Hyprland underneath, a Ryoku-owned Quickshell shell on top, plus Waffle and Windows app support so the move feels less foreign. The ISO stays lean; extras and shell plugins come when you actually want them.
[ 05 / RELEASE TRAIL ]
From alpha to beta to stable.
Ryoku moves through three release trains — alpha (shipping now), beta (in flight), stable (when the workstation path is clean enough to stand behind). No firm date for stable: it earns the name.
01Alpha
What shipped in the alpha — Hyprland session, Quickshell surfaces, branding, private hardware proof.
- 01Hyprland session on NixOS landeddone
- 02Quickshell shell integrateddone
- 03Ryoku commands, branding, and shell defaults aligneddone
- 04Private ISO testing on real hardwaredone
02Beta
The path to beta — desktop polish, cleaner shell ownership, Waffle and Windows app support, signed build verification on mixed hardware.
- 05Desktop polish across Hyprland, lock, login, and boot surfacesin flight · 75%
- 06Extras library split from shell pluginsin flight · 45%
- 07Ryoku-owned Quickshell surfaces replace the last borrowed piecesin flight · 35%
- 08Core settings stay about desktop, compatibility, updates, extras, and recoveryin flight · 55%
- 09SecPulse basic and advanced extras definedqueued
- 10Signed ISO verified on mixed NVIDIA and AMD graphics hardwaredone
03Stable
What stable demands — public docs, community testing, broad hardware coverage, rollback story.
- 11Public site and documentation refreshin flight · 80%
- 12Signed ISO release for community testingqueued
- 13Triage & fix issues from community testingqueued
- 14Stable update channel and rollback storyqueued
- 15Flake input tracking and nixpkgs pin updatesin flight · 45%
[ release status ]
Alpha now. Beta soon. Stable when it earns it.
Alpha is a signed but rough image — daily-driver ready for people comfortable filing bugs. Beta tightens the shell story, plugin boundaries, and the hardware matrix. Stable means the install is boring enough to recommend without a warning speech.
availableSigned alpha ISO, public docs, release pipeline, and first mixed-hardware validation pass.
in flightPolish across desktop surfaces, custom Quickshell work, plugin boundaries, broader hardware coverage, and keyring package.
pendingBeta cut, stable update channel, and rollback story.
[ 06 / DOWNLOAD · ALPHA ]
Download the alpha.
Ryoku is in alpha. Signed builds are published as they're cut; always verify the signature against the fingerprint below before trusting an image.
Download latest signed alpha ISO
ryoku-2026.05.11-x86_64-main.iso · stable · legacy-2026.05.11alpha Expect rough edges. Test in a VM or a non-critical machine first.
[ artifacts ]
- ISO
ryoku-2026.05.11-x86_64-main.iso - Signature
ryoku-2026.05.11-x86_64-main.iso.sig - SHA256
ryoku-2026.05.11-x86_64-main.iso.sha256 - Manifest
latest.json - Public key
ryoku-release-key.pub.asc
[ signing key ]
Always check that the imported key's fingerprint matches the value above before trusting it; if it does not, do not import. Full verification commands live at docs.ryoku.dev.
[ 01 / SPECIFICATIONS ]
- base
- NixOS
- compositor
- Hyprland
- shell
- Quickshell
- extras
- one-click kits
- plugins
- shell add-ons
- iso
- lean install
[ 03 / EXTRAS ]
Lean ISO.
Install the job after.
Ryoku ships extremely minimal: low-maintenance rice, few apps, less junk to break. Waffle and Windows app support are there to make the move feel more at home. Extras are one-click workflow kits pulled from trusted sources like nixpkgs, flakes, home-manager, Go, npm, and vendor CLIs. They keep the ISO small, current, and usable on more hardware.
plugins
Attach to the shell. Sidebars, toolbar actions, topbar modules, settings panes, and desktop surfaces. Plugins change Ryoku’s shell; extras change what the machine is ready to do.
01nixpkgs / flake / vendor
Gaming
drivers · launchers · chat
Auto-detects the user hardware, pulls the right graphics stack, and sets up the machine for games with Discord, compatibility support, and the expected gaming basics.
02nixpkgs / flake
Audiophile
pipewire · tools · control
Audio tools and sane defaults for people who care how the machine sounds, without turning the base install into a studio image.
03nixpkgs / flake / npm
The Influencer
stream · record · edit
OBS, screen recording, hardware compatibility, video editing, image editing, thumbnails, and the apps needed to publish without hunting packages.
04nixpkgs / flake
Office Worker
docs · mail · meetings
Free and open source office apps selected for the best daily-work experience: documents, spreadsheets, PDFs, mail, calendar, meetings, and Windows app fallback when work still depends on it.
05nixpkgs / flake / Go
SecPulse Basic
starter cyber lab
Nmap, Gobuster, OpenVPN, wordlists, and the basics for Hack The Box / TryHackMe study without making Ryoku pretend to be Kali.
06nixpkgs / flake / Go / npm
SecPulse Advanced
recon · firewall · ops
Nikto, Shodan tooling, deeper recon utilities, firewall editing helpers, and the heavier security workflow for users who actually need it.
07nixpkgs / flake
The Ricer
customize · inspect · tweak
Aether and the must-have apps for shaping the desktop, inspecting colors, editing visuals, and making the machine yours.
08nixpkgs / npm / vendor CLIs
The Vibecoder
agents · terminals · flow
Claude Code, Codex, OpenCode, terminal helpers, and the agent-first tools for building with AI instead of pretending you do not.
09nixpkgs / flake / Go / npm
The Developer
real dev workflows
Neovim, Zed, language tooling, containers, git helpers, and a workstation setup meant for actual development, not just screenshots.
10nixpkgs / flake / Go
The Hacker
reversing · forensics
Reverse engineering, digital forensics, binary inspection, packet work, and the heavier tools that should stay out of the default ISO.
[ 03 / PHILOSOPHY ]
onwhat ryoku is
NixOS with taste,not a pile of dots.
Ryoku descends from Omarchy, rebuilt on NixOS, then adds the pieces needed to feel like its own system: Hyprland, a Ryoku-owned Quickshell shell, Waffle, Windows app support, and a cleaner path for installing only the extras you want.
most nixos setups
- A pile of dotfiles glued to a wiki article.
- Rice that looks good on a screenshot and turns into maintenance debt two updates later.
- A different command for every tool: nix, nixpkgs, home-manager, nmcli, hyprctl, systemctl…
- Hardware quirks rediscovered in forum threads at 2am.
ryoku
- NixOS base, installer, updates, and recovery path treated as the product, not chores left to the user.
- Hyprland is the compositor. A Ryoku-owned Quickshell shell drives the surfaces, and grows as new ones earn their place.
- Lock, panels, launcher, docs, updates, recovery, and release signing move together.
- Extras install full workflows on demand. Plugins stay separate: shell add-ons for sidebars, toolbars, topbar modules, and desktop surfaces.
- 01Descends from Omarchy, rebuilt on NixOS: one flake, upstream ideas kept close, Ryoku pieces layered where they make the system better.
- 02Hyprland dynamic tiling with proper animations, because the desktop should feel deliberate.
- 03Ryoku's own Quickshell shell: keep what works from upstream, replace what needs to be ours.
- 04Lean ISO first: low-maintenance rice, minimal apps, Waffle, Windows app support, and one-click extras when the machine has a job to do.
- 05Ryoku builds a library of extras and shell plugins. Extras install workflows; plugins modify the shell.
[ 04 / DOCUMENTATION ]
→ docs.ryoku.dev
Read the system, end to end.
Install path. Hyprland keybinds. Quickshell shell surfaces. Waffle. Windows app support. Hardware notes. Release signing. Extras library. Plugin boundaries. The docs should explain the system plainly, not bury it in rice screenshots and mystery scripts.