[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7EDPT1HD343ZBJZTPVXJ2YC":3,"skill-same:01M7EDPT1HD343ZBJZTPVXJ2YC":49},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":20,"frontMatter":21,"refName":22,"commitSha":23,"skillDirectory":24,"forksCount":13,"repositoryHtmlUrl":25,"repositoryHomepageUrl":6,"ownerHtmlUrl":26,"ownerBlogUrl":6,"ownerDescription":27,"updatedAt":28,"install":29,"resources":42},"01M7EDPT1HD343ZBJZTPVXJ2YC","omarchy-desktop-rendering",null,"jonahthan433\u002FCortexOS","jonahthan433","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F211465495?v=4","01M7ECH9HPHGA89DCXHHJBTS3C","jonah.ai","01M7ECH9JCEM45DZMWPT7148S1",0,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fimported\u002Fsystem-administration\u002Fomarchy-desktop-rendering\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"# omarchy-desktop-rendering\n\n# Omarchy Desktop Rendering Troubleshooting\n\nDiagnosing why an Omarchy (Hyprland\u002FWayland) desktop renders wrong: shrunk into\na small square, tiny floating windows, missing bar or background, Xwayland\nfallback, or incorrect scaling.\n\n**The `omarchy` skill covers config *authoring*.** This skill covers *why the\nresulting desktop looks broken* and how to close the loop on the symptom.\n\n## Core Principle: verify the symptom, not the config\n\nA display bug can persist while every config file looks correct. `monitors.lua`\ncan be right, `hyprctl configerrors` can be clean, and the desktop can still\nrender wrong. **Never report \"root cause fixed\" on config state alone.**\n\nWhen the user says a previous fix didn't work, treat the earlier diagnosis as\nsuspect and re-derive from the live symptom.\n\n## Diagnostic Order\n\nRun these in order — each rules out a layer before you touch config.\n\n### 1. Is the panel itself correct?\n```bash\nexport HYPRLAND_INSTANCE_SIGNATURE=\u003Csig>   # from ls \u002Frun\u002Fuser\u002F$(id -u)\u002Fhypr\u002F\nexport XDG_RUNTIME_DIR=\u002Frun\u002Fuser\u002F$(id -u)\nhyprctl monitors -j\n```\nNative resolution, expected `scale`, `transform: 0`. If this is wrong it IS a\nmonitor-config bug. If it is correct, keep going — the bug is elsewhere.\n\n### 2. Did the shell's layer surfaces attach?\n```bash\nhyprctl layers          # raw output, NOT -j\n```\nLook for `namespace: omarchy-bar` and `namespace: omarchy-background`.\nMissing = the Omarchy shell (quickshell) failed to attach as a layer client.\n\n### 3. Are there degenerate fallback windows?\n```bash\nhyprctl clients -j\n```\nTiny floating windows (e.g. 80x80, 1x24) with empty `class` and\n`title: \"quickshell\"` are shell surfaces that fell back to Xwayland.\n\n### 4. What does the shell's own log say?\n```bash\njournalctl --user --since today _PID=$(pgrep -f 'quickshell -n -p') \\\n  | grep -iE 'WlrLayershell|QT_QPA_PLATFORM|WAYLAND_DISPLAY'\n```\nAuthoritative error strings:\n- `Could not create attached properties object 'qs::wayland::layershell::WlrLayershell'`\n  → layer-shell attach failing; Qt is running on X11.\n- `WAYLAND_DISPLAY is present but QT_QPA_PLATFORM is \"xcb\"`\n  → same root cause, stated outright by quickshell.\n\n### 5. Is there stacked scaling?\n```bash\ngsettings get org.gnome.desktop.interface text-scaling-factor\n```\nMust be `1.0` when Hyprland uses a fractional output scale (e.g. 1.25).\nA value >1 multiplies on top of the compositor scale and shrinks Xwayland\nclients into a small central region.\n\n## Root Cause: forced X11 Qt platform\n\n**Never force `QT_QPA_PLATFORM=xcb` in `~\u002F.config\u002Fhypr\u002Fhyprland.lua`.**\n\nOmarchy's default is `wayland;xcb` (`$OMARCHY_PATH\u002Fdefault\u002Fhypr\u002Fenvs.lua`).\nForcing `xcb` makes quickshell an Xwayland client, so every layer surface —\nbar, background, notifications, OSD, menu, keyboard panel — fails to attach and\nfalls back to tiny floating X windows centered on screen. The user sees exactly\n\"the desktop shrunk into a small square.\"\n\nIf one Qt app genuinely needs xcb (SteamVR's bundled Qt5 only ships the xcb\nplugin), override it **per-app in `autostart.lua`**, never session-wide.\n\n## Full Fix Sequence\n\nAll steps are required; skipping the env step is the usual reason a \"fix\"\nappears not to take.\n\n1. Remove the `QT_QPA_PLATFORM` override from `~\u002F.config\u002Fhypr\u002Fhyprland.lua`.\n2. ```bash\n   hyprctl reload && hyprctl configerrors   # must be clean\n   gsettings set org.gnome.desktop.interface text-scaling-factor 1.0\n   ```\n3. **`hyprctl reload` does not update the systemd user session env.** The stale\n   value persists and every newly spawned shell inherits it:\n   ```bash\n   systemctl --user set-environment QT_QPA_PLATFORM=wayland\n   omarchy restart shell\n   ```\n4. Verify live, all three must pass:\n   - `hyprctl layers` shows `omarchy-bar` + `omarchy-background`\n   - `hyprctl clients -j` shows no tiny quickshell windows\n   - shell journal log has zero `WlrLayershell` errors\n\n## Pitfalls\n\n- **Parsing `hyprctl layers -j`**: the JSON nests surfaces under\n  `levels -> \u003Cn> -> [ ... ]`; naive parsers report \"no layers\" when the bar is\n  in fact attached. Read the raw `hyprctl layers` text output to be sure.\n- **Session env vs config env**: `hl.env()` only affects processes spawned\n  after it takes effect, and `hyprctl reload` does not refresh the systemd\n  user environment. Use `systemctl --user set-environment`.\n- **Backup files are evidence**: dated `monitors.lua.bak.*` files reveal what\n  the config looked like shortly before a broken login. Compare them before\n  assuming the current file is innocent.\n- **A stale external-monitor rule** (e.g. `HDMI-A-2` at `1366x0`) can survive\n  in a backup while the current file is clean — confirm which one is loaded.\n- **Post-login persistence**: removing the `hl.env` line stops Hyprland from\n  *setting* the variable, but if another source (uwsm, `environment.d`)\n  exports it, the symptom returns on a fresh login. Verify after a real logout.\n\n## Verification Discipline\n\nA display fix is complete only when the exact symptom the user reported is\nconfirmed gone in the live session. Config correctness is necessary but not\nsufficient. When a user reports \"still the same after you said it was fixed\",\nre-open the whole diagnosis rather than re-asserting the previous conclusion.\n\n## References\n\n- [`references\u002Frendering-case-log.md`](references\u002Frendering-case-log.md) - worked\n  case: shrunk-desktop root cause, exact commands, and verified output.\n",{},"main","38b32c99e7ed0b8e215d638e92cfa452c1ec3079","skills\u002Fimported\u002Fsystem-administration\u002Fomarchy-desktop-rendering","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS","https:\u002F\u002Fgithub.com\u002Fjonahthan433","AI Consultant","2026-10-24 05:13:39",{"source":7,"skillName":5,"commands":30,"prompt":40,"zipAvailable":41},[31,34,37],{"tool":32,"command":33},"npx","npx skills add jonahthan433\u002FCortexOS --skill omarchy-desktop-rendering",{"tool":35,"command":36},"bunx","bunx skills add jonahthan433\u002FCortexOS --skill omarchy-desktop-rendering",{"tool":38,"command":39},"pnpm","pnpm dlx skills add jonahthan433\u002FCortexOS --skill omarchy-desktop-rendering","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fimported\u002Fsystem-administration\u002Fomarchy-desktop-rendering\u002FSKILL.md",true,[43],{"path":44,"resourceType":45,"resourceTypeDesc":46,"sizeBytes":47,"sourceHtmlUrl":48},"skill.json","REFERENCE","参考文档",509,"https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fimported\u002Fsystem-administration\u002Fomarchy-desktop-rendering\u002Fskill.json",[50,56,62,68,74,80],{"skillNo":51,"name":52,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":53,"categories":54,"keywords":55,"publishedAt":18},"01M7EDQZDQX3Q8Y7GCQX6KN9V7","opportunity-brief","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fsales\u002Fopportunity-brief\u002FSKILL.md",[],[],{"skillNo":57,"name":58,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":59,"categories":60,"keywords":61,"publishedAt":18},"01M7EDQYA0V9Y99VKBREJJ3MRT","morning-intel","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fresearch\u002Fmorning-intel\u002FSKILL.md",[],[],{"skillNo":63,"name":64,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":18},"01M7EDQVX1JVY0B6PDHKKGM19G","decision-brief","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fresearch\u002Fdecision-brief\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":18},"01M7EDQV1GENZAC2SZSD8KZ3GM","weekly-review","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fweekly-review\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":18},"01M7EDQT2KETJ1Y3CGVN9EKW2J","system-health","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fops\u002Fsystem-health\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":18},"01M7EDQQN2JK3XPWMS1M4T0F3K","backup-restore","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fops\u002Fbackup-restore\u002FSKILL.md",[],[]]