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. Add common issues as they get reported.

​
Where logs live

WhatWhere
Quickshell (the bar / sidebars / lock)journalctl --user -u quickshell
Niri (the compositor)journalctl --user -u niri
SDDM (the login screen)sudo journalctl -u sddm
Updater~/.local/state/quickshell/user/update.log
OpenVPN connectionsjournalctl --user -u openvpn@<profile>
Kernel / hardwaredmesg, journalctl -k

​
The bar / sidebar isn’t drawing

If Mod+Slash doesn’t open the cheatsheet, Quickshell isn’t running. 
journalctl --user -u quickshell -n 50
The most common causes:
  • Recent ryoku-update broke the shell: snapshot rollback restores the last working state. ryoku-update --list-snapshots then ryoku-update --restore <id>.
  • Custom config error: ~/.config/illogical-impulse/config.json got malformed (often after hand-editing). The shell will fall back to defaults if you mv it aside.
  • Quickshell binary mismatch: a system update bumped Qt/Quickshell out of sync with the shell sources. Re-running ryoku-update usually fixes it.

​
Login screen is broken / can’t log in

Drop to a TTY (Ctrl+Alt+F2), log in, and start a Niri session manually: 
niri-session
If Niri starts fine from the TTY, SDDM is the problem. Check sudo journalctl -u sddm and consider switching SDDM theme (Settings → Login screen if you can reach a desktop; otherwise edit /etc/sddm.conf.d/).

​
Network is offline

  • The right sidebar’s wifi toggle takes effect immediately. If it didn’t, check nmcli device status.
  • If you’re tunneled through OpenVPN and the SecPulse pill says connected but you can’t reach anything, nmcli connection show and look for a leak or split-routing issue.
  • The right sidebar’s Network monitor tab shows listening sockets, active connections, and ping latency in real time.

​
Performance feels off

  • Animations: Settings → Appearance → Animations toggle.
  • Wallpaper video / GIF: turning off animated wallpaper is the single biggest GPU win.
  • Niri’s overview: Mod+Tab is GPU-heavy on integrated graphics; disable per-monitor preview in ~/.config/niri/config.kdl if it’s choppy.

​
Filing a useful bug

Open an issue at neur0map/ryoku-arch with:
  1. What you did — keystrokes, clicks, or commands.
  2. What happened — what you saw, including screenshots when relevant.
  3. What you expected.
  4. Output of ryoku-update --check — pinpoints which commit you’re on.
  5. Relevant log slice — last 50 lines of journalctl --user -u quickshell is usually enough.
Security-sensitive issues go through SECURITY.md, not the public tracker.