Repository navigation
Kaichii b45 (1a8f45d)
Changes since build 42
Performance
- Frame pacing targets game frames when frame generation is on. Target 30/60/90/120 now count each game's frame once and space its generated presents within that interval. Generation also leaves a free presentation frame for the next game frame, avoiding a wait when the queue fills. Unit tests cover target rates and queue capacity. Donkey Kong Bananza ran with FSR3 2x and Target 60 and produced generated frames (#83).
Crashes and stability
- Texture cleanup uses the image's own GPU address space. Unregistering an image after a channel switch no longer looks in the newly bound channel's page table. A synthetic two-address-space test passes; the reported multi-channel game case has not been replayed (#83).
- VP9 header encoding no longer reads past its stream while propagating a carry. The regression test reproduced the old stream exception and passes with the fix. (#83).
- Windows sparse-vector pages stay writable after another thread commits them. This avoids a protection change that could race with a GPU cache update. Both Windows binary variants compile (#83).
Linux
Linux packages come as an AppImage (self-contained, needs glibc 2.39 or newer: Ubuntu 24.04, Fedora 40, Debian 13, Arch) and a tar.gz (uses your system libraries, so Qt 6 and the usual libraries must be installed).
| Build Type | Standard | PGO (Recommended) | Notes |
|---|---|---|---|
| amd64 | AppImage · tar.gz | AppImage · tar.gz | Make the AppImage executable (chmod +x) and run it |
| ARM (aarch64) | AppImage · tar.gz | AppImage · tar.gz |
Windows
Windows packages are in-place zip files: extract and run kaichii.exe, or eden-cli.exe from a terminal.
| Build Type | Standard | PGO (Recommended) | Notes |
|---|---|---|---|
| amd64 / x86_64 | zip | PGO zip | Both built with clang-cl and ThinLTO; the PGO zip adds a profile trained on Ocarina of Time |
Not in this build: macos-arm64. Their builds failed or GitHub couldn't run them; the next build tries again.
The PGO builds are the same programs compiled with profile-guided optimization. Linux uses clang with Eglantine's profile; Windows uses clang-cl and ThinLTO with a profile trained in Lichii on Ocarina of Time, so other games gain less. Prefer them when your CPU supports it.
Coming from a build named Lichii? It won't update itself to Kaichii: download Kaichii once by hand. Saves, settings and shader caches stay where they are and carry over.