Repository navigation
0.9.5
Important
Report issues from inside Orchid
Use Help > Report an Issue on GitHub to open a report with your build, system, GPU, driver and recent game log. After a crash, restart Orchid first and attach the full game log from the folder it opens.
Hyrule Warriors: Age of Imprisonment combat crash fix
Highlights
- Fixed excessive GPU buffer readbacks during combat. A previously CPU-read page no longer causes an entire estimated 8 MiB compute write to be copied back at every fence.
- Completed readback buffers are recycled during long frames, and pending readbacks have a bounded producer queue with shutdown cancellation.
- Fixed stale thread-local memory translations when a new memory manager reuses an old manager's address.
Validation and limitations
- The maintainer tested actual Hyrule combat without the previous hit-triggered hang or crash. Observed dips into the 20 FPS range remain; this is not a measured performance benchmark.
- Local build, targeted regression tests (161 assertions in 8 cases), and scoped mutation checks passed.
- The remaining cross-game gameplay gate was explicitly waived by the maintainer for this release. Bananza reached gameplay, but its full comparison test was not completed.
- The separately reported Kirby allocation crash has not been confirmed fixed.
- Xenoblade Chronicles X: the intro video can freeze, and character creation can hang on a black screen.
Changes since v0.9.4
- Fix Hyrule combat hangs from excessive buffer readbacks (0783ecd)
- plans: mark 003 done (2ff0072)
- nup: extract multi-program archives into program/ (98436c1)
- tests: let MSVC build the NUP writer test; list every error in the tests workflow (a3cb487)
- plans: record final main SHAs of 001, 002, 005 (272f797)
- plans: add improve audit plans and index (5916659)
- frontend: skip symbolic links when unpacking zips (b709dff)
- ncz: fail a solid stream whose sections leave a gap (70f62fd)
- vfs: keep created and deleted children inside their real directory (6705eb8)
- tests: unsigned operands in the Wonder FPS interval check (8095724)
- HID: show the guessed Joy-Con 2 style bit only to games that support it (d66ed1a)
- Log host resources once a minute and when the process is about to end (issue 140) (ebebced)
- docs: drop the Mario Tennis gate from fork-scan and perf policy (269bee8)
- AGENTS.md: general gameplay gate for all README games, only before a release or PR (430db1a)
- AGENTS.md: C++ navigation (LSP, orchid-lsp-setup, ast-grep), disk limit 100 GB (30dcd8b)
- AGENTS.md: harness facts for test briefs (snapshot per route, log and screenshot paths) (a6597b1)
- ampere: end a native capture at the RET behind an unpredicated CALL.REL.NOINC (cf66896)
Install
Windows: extract the zip and run orchid.exe, or eden-cli.exe from a terminal.
Linux (AppImage): make it executable (chmod +x) and run it; it bundles its libraries and needs glibc 2.39 or newer (Ubuntu 24.04, Fedora 40, Debian 13, Arch).
Linux (tar.gz): extract it and run ./orchid or ./eden-cli; it uses your system libraries, so Qt 6 and the usual libraries must be installed.
macOS: Apple Silicon and macOS 15 or newer. Extract the zip and move orchid.app to Applications. The CLI is inside orchid.app/Contents/MacOS/eden-cli. The app bundles Qt and MoltenVK and is ad-hoc signed, not notarized; macOS may require approval in Privacy & Security. macOS support remains experimental and uses the JIT, not NCE.
The -pgo builds are the same programs compiled with profile-guided optimization (clang plus the repo's orchid.profdata) and run on the same CPUs; if one is slower than the normal build for you, please report it. The Windows PGO build is a MinGW build, so it carries its own DLLs and needs no Visual C++ redistributable.
Orchid looks for newer builds of its channel at startup and from Help > Check for Updates.