Skip to main content
Ryoku has one coherent look, and it takes its color from your wallpaper. Set a wallpaper and the terminal, the compositor, and the shell all recolor to match, with no per-app theming and no mismatched palettes. Prefer a fixed palette? Pick one of the shipped themes and lock to it.

​
How colors work

Ryoku uses wallust to read your current wallpaper, extract a 16-color palette from it, and write that palette into every surface at once. That palette is either followed or locked, controlled by the Match wallpaper toggle:
  • Follow (default) — colors regenerate from each new wallpaper. Change the wallpaper, change the whole system’s colors.
  • Lock — colors come from the selected theme’s fixed palette and stay put no matter which wallpaper you set.
The toggle lives in Ryoku Settings → Shell → Match wallpaper (open Settings with Mod + ,). Theme selection itself is in the Appearance panel.
Only the accent follows the wallpaper. The brand vermillion, the red-sun motif, and the 力 mark stay fixed on every wallpaper, so a sun is always a sun.

​
Full-system themes

A theme is more than colors: each one tunes rounding, blur, gaps, shadows, opacity, and motion into a complete look. Some carry a fixed palette; others stay wallpaper-driven and only reshape the motion and decoration. default is Ryoku Default, the warm, wallpaper-driven look you get out of the box.

​
Switching a theme

1

Open Ryoku Settings

Press Mod + , to open the Hub.
2

Go to Appearance

Select the Appearance panel and pick a theme. Changes preview live.
3

Decide on colors

A fixed-palette theme locks its own colors. To keep colors following your wallpaper instead, leave Match wallpaper on in the Shell panel.

​
Wallpapers

Wallpapers live in ~/Pictures/Wallpapers, and a shipped set is installed for you. With Match wallpaper on, every wallpaper change recolors the whole desktop.

​
Ryowalls

Press Mod + Shift + W for Ryowalls, an in-desktop browser for wallhaven.cc.
1

Browse

Search wallhaven from inside Ryoku.
2

Preview live

Highlight a wallpaper and the whole rice previews live, colors and all.
3

Apply

Apply it, and Ryoku saves a per-image color tune so it looks right every time you return to it.

​
The fixed brand

Wallust moves the accent, but a few things never move. These are the brand constants, independent of any wallpaper or theme. Fonts are fixed too: Fraunces for display headlines, Space Grotesk for UI, JetBrains Mono Nerd Font for code and labels, and Noto as the fallback (including CJK). The cursor is Bibata.

Ryoku Settings

The Hub: Appearance, Shell, and every other panel.

Customize

Go deeper: user overrides, config files, and dotfiles.
Last modified on July 4, 2026