Repository navigation
Kaichii b38 (0592b5d)
Changes since build 36
Built from nx2 at 0592b5db52. Build 36 was 2417332. That's 3 merged changes.
Big fixes
- Windows: games start again. On Windows, build 36 stopped every game about a second after it started: the loading screen stayed on "Iniciando..."/"Starting...", the log showed
Break 0xE401, and closing Kaichii hung on "Emulation thread failed to stop". Linux was not affected. The cause was in the emulated kernel: a game thread that waits inside a system call can wake up on another emulated core, and the Windows build (clang-cl with ThinLTO) kept using the core it had left, so the call's results went to another thread's registers. That thread then made calls the game never asked for and the game aborted. The kernel now reads which core and thread it runs on afresh each time, on every compiler. Played on Windows (i7-12700H, RTX 3050 Laptop) with Super Mario Bros. Wonder and Ocarina of Time, which both failed before; a build without the fix still failed on the same PC (#70).
Crashes and stability
- Tip if a game closes by itself on Windows: programs that draw overlays (FPS counters, recorders) install Vulkan layers that load into Kaichii too. While investigating the fix above, Ocarina of Time closed at its first movie because of FPS Monitor's layer (
fpsmonvk64.dll), which crashed inside its own code; uninstalling FPS Monitor fixed it. If a game closes without an error, try closing or uninstalling overlay programs first.
For developers
- The C++ tests run to the end on Windows. A page table test wrote to memory that Windows had only reserved, which crashed the tests binary there; CI runs the tests only on Linux, so it was never seen (#71).
- Release notes like these. Each release now starts with what changed since the previous one: these written notes when there are new ones, and always the full list of what was merged (#72).
Everything merged
- kernel: never inline the reads of the kernel's thread locals (Windows boot abort) (#70)
- tests: reserve the page table range before the move test writes to it (#71)
- ci: detailed release notes, with the changes since the previous build (#72)
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 |
macOS
| Build Type | Standard | PGO (Recommended) | Notes |
|---|---|---|---|
| arm64 (Apple Silicon) | zip | macOS 15 or newer. Not notarized: right-click and choose Open the first time, or run xattr -dr com.apple.quarantine kaichii.app. eden-cli is inside the app, in Contents/MacOS |
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.