THE APP
The app
One binary, chaos. It renders the dimension and has a panel on the right. It talks to the registry over HTTPS and writes your files to a folder you pick. The registry's public key is baked in, so if some registry signs with a different key the app just refuses it. Nobody can feed it fake certs.
Install
| Arch | pacman -S glfw glm libsodium openssl curl libx11 libxext wayland libglvnd cmake ninja, then cmake -S client -B client/build -DCMAKE_INSTALL_PREFIX=/usr -DCHAOS_PLASMA=ON if you're on KDE, cmake --build client/build, sudo cmake --install client/build. |
| KDE | Same build gives you the wallpaper plugin. systemctl --user restart plasma-plasmashell.service after install, then pick wallpaper type CHAOS. |
| Not KDE | chaos --wallpaper is the window-less wallpaper (Wayland layer shell or X11). |
The 4 steps
| 01 sign in | Nothing gets generated without an account, previews included. Go to /login?app=1, sign in with Google, it shows a token, paste it on the app's account tab, connect. That's it. |
| 02 roll | One key. The app commits to a random number, the registry adds its own and signs a ticket, the seed is the hash of both. Nobody picks the outcome. Details on the roll. |
| 03 keep, then claim | Keep writes the .chaos and a PNG to your folder. Claim sends the file up, the registry checks everything, figures out the tier itself, signs it and gives it back. |
| 04 put it on the desktop | KDE: "set as desktop wallpaper" on the view tab or the setup tab. It tells plasmashell to use the chaos wallpaper with that seed on every desktop. Elsewhere pick the wallpaper in your desktop settings and paste the seed. |
The tabs
| Setup | The 4 steps, one key each, marked done when done. |
| Vault | Every file in your folder with its PNG, state, tier, family, mode, valid or not. Load any of them, claim a rolled one. |
| Roll | Preview (R), claimable, keep and claim, the by-hand ticket route, load a seed by hex, base58 or the 24 words. |
| View | The seed in its 3 spellings with copy keys, tier, family, shape, lineage, counts. Mood and mode. Set as desktop wallpaper. |
| Model | Your own 3D model on the stage. See .cheng. |
| Prefs | Pause, vsync, fps cap, battery cap, theme, draw, render size, anti-aliasing, detail, the low-end and full presets, the registry URL. |
| Account | Sign in / out, sync, your files folder, live online check, this install's id. |
Keys
| Esc | Panel on / off |
| R | Preview roll |
| K | Keep |
| M | Next mood |
| N | Next mode |
| 1 2 3 4 | Zen, calm, chaos, bleed |
| Space | Pause |
| F | Fullscreen |
Offline
Nothing gets generated offline. No previews, no rolls, no replaying random seeds. Anything you kept in your folder plays, anything you loaded online once plays. The model tab works offline cuz that's your own thing. The status line at the bottom always tells you what's up.