History / Window Effects

Document the installer rebuild, synguard enforcement, and kitty The wiki stopped at 2026-07-28 and the whole synguard-to-now range was undocumented. Installation.md still described a single ext4-and-GRUB installer that no longer exists. Installation — install modes now include ADVANCED (partition it yourself, then name the partitions), plus the filesystem table, the bootloader table and what each implies for the ESP, snapshots, swap and zram. Marked with what is actually published: 0.2.4 has ERASE/ALONGSIDE only, everything else is on main and needs a self-built ISO. synguard — the enforcement model had no page anywhere. Adds the two paths (post-hoc SIGKILL vs the in-kernel BPF-LSM gate) and why they are not equivalent, the mode/flag split, the four things the gate cannot do, the two cases where a DENY stands down, how to read the stats line, and how to test a deny rule without killing your own session. synsh — kitty is the default terminal; foot is kept as the CPU-rendered rescue. Includes the dynamic_background_opacity trap, which cannot be fixed after the fact. Terminal references updated across Commands, synui, Window-Effects and Gaming. Development Notes — five new entries, all from silent failures: systemd dependency lists are additive-only so a drop-in cannot remove one; socket-activated services resurrect a daemon you stopped, over the network; an indented heredoc terminator swallows code while bash -n passes; a prompt after a long step answers itself from typeahead; grep -q in a pipeline under pipefail makes "must be absent" checks pass vacuously.

velle999 committed Jul 30, 2026

wiki: wpengine is on the ISO, Super+E controls, TEPRIS + Nexus P2P pages linux-wallpaperengine ships on the ISO as of 0.2.1, so three pages saying otherwise are now actively wrong — Wallpapers told people to build a package they already have. Commands and the Wallpapers intro said "optional / not on the ISO". Window-Effects documented the config keys and gave the Super+E panel one sentence, even though the panel is how most people will actually touch any of this. Adds the two pages, the shared keys, and the part that is genuinely surprising: Space means different things per page — master on/off on the CRT page, but "toggle the switch governing this row" on the window page, so it lights the shadow from a greyed-out Shadow size row. Also that `s` saves only the page you are on, into separate files. New Apps pages for TEPRIS and Nexus P2P, both previously undocumented. Nexus P2P's leads with the thing a user must know before sharing a code — the code IS the password — and records why the code is not the MQTT topic: encrypting the payload is not enough if the envelope carries the secret. Written against the current launchers, not from notes: tepris deliberately does NOT use --kiosk any more (kiosk had no way out of fullscreen and no way to quit), which older notes still claimed.

velle999 committed Jul 27, 2026

Make Troubleshooting a user's page; move the engineering history out Troubleshooting had become a development changelog — bugs *we* hit, told as history, with commit hashes and the internal test rigs used to find them. That is not what someone reaches for when their machine is misbehaving, and a lot of it described one particular machine rather than the system. Troubleshooting is now symptom-first and about the reader's computer: no sound from event sounds, an installed cursor theme that won't appear, a giant pointer in one app, the bar gone, a widget eating clicks, games on the wrong monitor, black screen after suspend, being locked out with no VT, pacman 404s, a module that won't load after a kernel upgrade, the AI not answering, Secure Boot enrollment, a LUKS header you didn't back up. Each entry says what to run. The engineering material moves to a new Development-Notes page, which keeps the generalisable rules — a commit is not an install, dkms status is not a health check, /etc units shadow /usr/lib ones, signal dispositions survive exec, tightening a check must handle the values already sitting on the wrong side — without the narrative or the machine it happened on. Also removed personal and machine-specific detail from the pages added in ae733c0: a named USB volume knob, downloaded archive names, which apps had which shadow, screen widths, monitor names, and the private-desktop state that prompted the sound-theme fix. The rules they illustrate all still stand on their own, stated generally. The one home path in Building-and-Packaging is now $HOME. Fixed two dead anchors that predate this batch (synui#game-mode and synui#task-manager pointed at bold text, not headings) and verified every internal link and cross-page anchor resolves.

velle999 committed Jul 26, 2026

Document the desktop: sounds, cursors, widgets, the bar and window effects The wiki was last touched at 0.1.8; everything since — the quickshell bar replacing waybar, the cursor and sound managers, desktop widgets and icons, the wlroots 0.20 / scenefx 0.5 port and the glass work — was undocumented. Four new pages: Sound-Themes synui-sound end to end: the ten events and where each is hooked, installing themes from an archive or a plain folder of .oga files, per-event sample picking, and why several spec names resolve to something else. Carries the ghost theme (/usr/share/sounds/alsa silenced a desktop whose switches all said "on") and the `volume` key collision. Cursor-Themes synui-cursor end to end, built around the thing that actually costs people time: opendesktop ships ready-to-use themes and source trees that look identical from outside. Plus the untrusted-archive handling, and the five places a cursor theme has to be written or the desktop disagrees. The-Desktop the bar (and why waybar went), widgets, desktop icons, themes, per-app geometry. Window-Effects the full synuirc knob reference with defaults and ranges, how to tell whose shadow you are looking at, the 50% shadow ceiling shadow_spread lifts, and the seam rule that made the glass halo square on top. Both installers are documented as installers of untrusted archives, because that is what they are: paths re-resolved against the extraction root, and `build` kept CLI-only since it runs the archive's own makefile as you. Keybindings was materially wrong — Super+T has been the theme manager since the task manager lost its second bind, and Alt+Tab, Super+S, Super+Shift+A, Super+Shift+P, Super+V, Super+R, Super+I and the bare media keys were all missing. Regenerated against the bind table in config.c, with the note that a duplicate combo is not a conflict anyone sees, it is the older feature silently going dead. Troubleshooting gains eight entries, all the same shape as the rest of that page: a commit and a pkgrel bump that ship nothing, the ghost sound theme, a nested synui that re-themes the live desktop, quickshell's missing UseQApplication (whose error goes to tty1, not the journal), Nerd Font glyphs silently becoming the empty string, systemd's non-existent inline comments, and `pkill -f` killing the shell that ran it. Also corrected: wlroots 0.19 -> 0.20 and the scenefx fork in Architecture and Building; the collector drift that went four-for-four and is now deduped via <pkg>/mktarball.sh; LUKS2 and dual-boot in Installation, including why /boot stays outside the encrypted root; and the 0.1.5-0.1.9 release history, with the post-0.1.9 work marked unreleased.

velle999 committed Jul 26, 2026