ARCH // GLITCH CORE · 00
You are entering a living system manual.
The portfolio language settles here into verified paths, commands, and configuration sources.
PERSONAL SYSTEM MANUAL
MIXED SOURCES · 2026-08-24
01 — My system
The verified architecture of this Arch session
Last updated: 2026-08-24 · LIVE SYSTEM · captured during the latest audit
Architecture
Section titled “Architecture”Arch Linux → Wayland → Hyprland ├── Caelestia Shell / Quickshell │ └── bar · launcher · sidebar · notifications └── Kitty/Zsh · Thunar · LibreWolf · applicationsText alternative: Arch runs a Hyprland Wayland session. Caelestia provides the desktop shell while Hyprland manages applications and workspaces.
Hyprland with three displays
CONFIGDP-1 is configured as the central/main 144 Hz display, DVI-D-1 as the rotated left 144 Hz display, and HDMI-A-1 as the right 60 Hz display.Caelestia Shell
CONFIG Bar, dashboard, launcher, sidebar, and session menu are enabled.Kitty and Zsh
CONFIG$terminal = kitty; shell documentation never reads command history.Login sequence
Section titled “Login sequence”Hyprland → polkit/swww/tumbler/mako → systemd user environment → portals → monitor stabilisation → Caelestia/Quickshell → delayed Spotify and GoofCord startupThe active configuration also applies adw-gtk3-dark and Vivid-Glassy-Dark-Icons through gsettings at login.
Layer responsibilities
Section titled “Layer responsibilities”Arch supplies packages and the base user space. Wayland is the protocol boundary between applications, input/output devices, and the compositor. Hyprland composes surfaces, assigns workspaces, evaluates window rules, and dispatches bindings. Caelestia/Quickshell is the visible shell: it does not replace Hyprland’s window management. Kitty hosts Zsh; Thunar and LibreWolf remain separate applications.
| Layer | Confirmed source | What it controls |
|---|---|---|
| Hyprland | hyprland.conf, sourced bind file | monitors, input, windows, workspaces, startup |
| Caelestia | shell.json, per-monitor overrides, scheme state | bar, launcher, sidebar, dashboard, session UI |
| Toolkit theme | GTK 3/4 settings and CSS | GTK application appearance |
| Terminal | Kitty and permitted Zsh configuration | terminal presentation and shell behavior |
| Documentation | audit output and generated JSON | redacted reference, not system control |
The manual generator reads evidence and writes only project files. It is not part of login and cannot configure the desktop.
Evidence boundary
Section titled “Evidence boundary”The audit confirmed Arch through /etc/os-release and captured permitted configuration and package inventories. hyprctl runtime queries and systemctl --user failed in the isolated audit context. Monitor placement, startup sequence, bindings, and shell modules are therefore CONFIG facts unless a stored live result explicitly says otherwise.
Verify the layer you are debugging
Section titled “Verify the layer you are debugging”- A window-placement fault belongs first to Hyprland rules and runtime errors.
- A missing launcher/sidebar belongs first to Caelestia startup, JSON, and user logs.
- A GTK colour mismatch belongs to toolkit settings, not automatically the Caelestia scheme.
- A command-not-found error belongs to the executable/package layer.
- Stale documentation belongs to the update pipeline, not the live desktop.
Related: Desktop map, Configuration map, and Troubleshooting.