Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.ryoku.dev/llms.txt

Use this file to discover all available pages before exploring further.

This page is being expanded. The skeleton is here; per-surface deep dives land next.

​
Settings (Mod+Comma)

Most knobs are here:
  • Appearance — theme family (Material, Aurora, Angel, Ryoku-Shell, Cards), accent color, panel family (ii ↔ waffle), font scale, animations on/off.
  • Background — wallpaper picker, color generation source, video / GIF wallpapers, dynamic parallax, vignette.
  • Bar — toggle every widget, rearrange order, pick which monitor each instance lives on.
  • Sidebar — which tabs show up, default tab, gestures.
  • Lock / Login — SDDM theme, lock screen layout.
  • Updates — auto-check interval, terminal-on-update.
  • Interactions — scroll speed, dead-pixel workaround, hover thresholds.
Every bar widget is meant to be toggleable, removable, and rearrangeable from Settings → Bar. If something can’t be turned off there, that’s a bug — file it.

​
Wallpapers

  • Ctrl+Alt+T opens the wallpaper picker.
  • Drop files into ~/Pictures/Wallpapers. The picker auto-discovers new ones.
  • The left sidebar’s Wallhaven tab searches and applies wallpapers from wallhaven.cc directly.
  • Theme colors regenerate from the selected wallpaper unless you’ve set a static accent in Settings → Appearance.
Per-monitor wallpapers are configurable in Settings → Background → Multi-monitor.

​
Themes

Ryoku ships five panel skins:
  • Material — Material 3 default.
  • Aurora — translucent, blurred, dim.
  • Angel — bright, glass-card, high-contrast.
  • Ryoku-Shell — Greek Noir, brand-aligned.
  • Cards — flat surfaces, minimal chrome.
Switch in Settings → Appearance. Each skin reads the same color tokens, so changing wallpaper changes them all at once.

​
Keybinds

The shipped binds live in ~/.config/niri/config.d/70-binds.kdl. To override:
  • Drop a new file under ~/.config/niri/config.d/ named higher than 70- (e.g., 90-my-binds.kdl).
  • Niri reads config.d/ files in lexical order; later files win.
  • See the keybindings reference for what’s bound today.

​
Advanced

For anything that doesn’t have a Settings switch:
  • Niri layout — ~/.config/niri/config.kdl. Niri docs: https://github.com/YaLTeR/niri/wiki
  • Shell config (raw JSON) — ~/.config/illogical-impulse/config.json. Settings writes here; you can hand-edit when you know what you want.
  • Theme palette overrides — ~/.config/matugen/templates/ and ~/.local/state/quickshell/user/generated/. See docs/branding.md for the brand-color anchors.
The customization inventory is the authoritative list of every text-based surface you can safely touch.