claude-memory/project_cyberpunk_wallpaper.md

92 lines
5.6 KiB
Markdown

---
name: project-cyberpunk-wallpaper
description: Cyberpunk Rainmeter/Wallpaper Engine desktop on samurai with homelab commands + live metrics
metadata:
node_type: memory
type: project
originSessionId: 3e5f5ed8-17c3-4f03-b761-a349552ec2a8
---
kenpat is building a cyberpunk-style live wallpaper on samurai (Windows desktop) using
Rainmeter + Steam Wallpaper Engine (already installed). It should display:
- Homelab Commands quick reference (from obsidian-vault `Homelab Commands/Quick Reference.md`)
- Live system metrics for samurai, T14s/monk, and kscloud1, running at all times
**Why:** Wants an always-on visual dashboard for the KiteStacks homelab while using
the desktop day-to-day.
**How to apply:** Metrics source is Prometheus running on monk (per device-setup
CLAUDE.md). Pull/expose metrics via Prometheus HTTP API (or a small bridge script)
for the Rainmeter skin to consume. See [[project-claude-memory-sync]] for the shared
memory setup that motivated adding this command to the homelab quick reference.
## Architecture findings (2026-06-12)
- Prometheus on monk (`100.85.209.116:9090`) is reachable directly from samurai over
Tailscale - confirmed via `curl http://100.85.209.116:9090/api/v1/targets`.
- Current scrape jobs: `t14-node` (monk's own node-exporter container) and
`kscloud1-node` (kscloud1 node-exporter, public IP - do not commit this IP anywhere).
Config lives at `~/kitestacks-live/docker/prometheus/prometheus.yml` on monk.
- Wallpaper Engine IS installed, but at a non-default Steam location:
`C:\Program Files (x86)\steam2\steamapps\common\wallpaper_engine` (note "steam2" dir name).
- monk also runs `kitestacks-metrics-api` (FastAPI/psutil, source at
`/home/kenpatmonk/kitestacks-live/docker/.../main.py` inside container `/app/main.py`)
exposing `/api/metrics`, `/api/weather`, `/api/activity` as JSON - a reference
pattern, but the wallpaper plan uses Prometheus directly as the unified data source
for all 3 hosts instead.
## SSH access notes
- `ssh monk` now works for general shell (port 22, user kenpatmonk, key id_devman) -
added as a Host alias in samurai's ~/.ssh/config. Separate from the
`100.85.209.116` config block used for Forgejo git (port 2222, user git,
id_ed25519_forgejo) - both entries must coexist, do not collapse them.
## STATUS: Built and working (2026-06-12)
Both Rainmeter skins are live, persisted in `Rainmeter.ini`, and Rainmeter is set
to launch at login (added to `HKCU\...\CurrentVersion\Run`). windows_exporter
service confirmed `Running`/`Automatic`, `samurai-node` Prometheus job confirmed up.
- Skins live under `Documents\Rainmeter\Skins\KiteStacks\`:
- `Metrics\Metrics.ini` - "KITESTACKS NODES" panel, 480x373, polls
`fetch-metrics.ps1` (RunCommand plugin, 60s) which queries Prometheus and
writes `metrics.json`; WebParser reads it. Shows CPU/RAM/Disk bars +
ONLINE/OFFLINE per host for samurai/monk/kscloud1.
- `Commands\Commands.ini` - renders `~/obsidian-vault/Homelab Commands/Quick
Reference.md` as a single-column cyberpunk text panel (484x557). Regenerate
after editing the source doc with `Commands\regen-commands.ps1`, then
`Rainmeter.exe "[!Refresh \"KiteStacks\Commands\"]"`.
- `Variables.inc` (shared colors/fonts) included via `..\Variables.inc`.
- Window positions: Commands at (0,20), Metrics at (500,20) on the PRIMARY
monitor, which is **1536x864** (DISPLAY14, at virtual-screen origin (0,0)),
NOT the 1920x1080 secondary monitor (DISPLAY13, at X=-1920..0). Always check
`[System.Windows.Forms.Screen]::AllScreens` before reasoning about coordinates
- GetWindowRect-based tools report positions in this virtual-screen space.
- **Critical Rainmeter gotcha**: a plain `Y=10` on a meter is NOT absolute - it's
relative to the previous meter in file order (previous.bottom + 10), even for
the very first content meter (previous = whatever IMAGE/background meter
precedes it). This caused the Commands panel to balloon to 1240x1356 over
many iterations. Fix: drop separate BorderFrame/Background IMAGE meters;
use `[Rainmeter] BackgroundMode=2` + `SolidColor=R,G,B,A` for the panel
background instead (auto-sized to content bounding box). Single-column layout
only - a 2-column layout re-triggers the same chaining bug because the second
column's first meter still chains off the first column's last meter.
- **Encoding gotcha**: Rainmeter reads `.inc` files as ANSI, so UTF-8 multi-byte
chars (em dash, box-drawing ├└─, arrows →, smart quotes) become mojibake.
`regen-commands.ps1` now replaces these with ASCII equivalents (`-`, `|`/`\`,
`->`, straight quotes) before writing the .inc.
## Lock screen (2026-06-12)
kenpat asked to also update the Windows lock screen to match. Used the
Wallpaper Engine background kenpat had just subscribed to (Workshop item
2323323193, "Cyberpunk City w/ System 24h Clock... | Skeor") - copied its
`preview.jpg` to `C:\Users\Kenny\Pictures\KiteStacks\lockscreen-cyberpunk.jpg`
and set it via `HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\PersonalizationCSP`
(`LockScreenImagePath`/`LockScreenImageUrl`/`LockScreenImageStatus=1`). Note:
this is the MDM/CSP-style override - it greys out the lock screen picture picker
in Settings > Personalization. To let kenpat pick a different lock screen image
via Settings later, these 3 registry values need to be deleted first.
## Remaining / not done
- Wallpaper Engine background itself: kenpat picks/applies it manually (Rainmeter
renders on top automatically via `WindowZPosition=-2`/OnDesktop).
- "keep track of token and token limit per session always" - kenpat asked for
this as a standing behavior but it hasn't been set up as anything concrete yet.