Repository navigation
0.10.0
Important
Please read first
- Hyrule Warriors: Age of Calamity and Xenoblade Chronicles 3 are no longer supported. Neither has a Switch 2 improvement, so Orchid now shows the unsupported-game notice when you start them.
- Kirby and the Forgotten Land, Star-Crossed World: the slow memory growth some of you reported (freeze or crash after a while, mostly on 8 GB graphics cards) is not fixed yet. A fix is being tested in #146.
- Kirby Air Riders: races can still hang the GPU. Please don't play it on Orchid yet.
- Found a problem? Use Help > Report an Issue on GitHub inside Orchid. It fills in your build, system, GPU, driver and recent game log for you.
Orchid 0.10
This is a big one: more than 100 changes since 0.9.5. Most of them are many small fixes for crashes, freezes and rendering errors, collected from other emulator projects and tested in Orchid. Here are the parts you'll notice.
What's better in your games
- Super Mario Bros. Wonder: no more drops to 20-30 fps after playing a while. Graphics memory used to fill up whenever the game changed its resolution.
- Kirby and the Forgotten Land (Switch 2 Edition): holds 60 fps in Waddle Dee Town instead of about 52, thanks to better default GPU settings. If you changed those settings yourself, your choice is kept.
- Yoshi and the Mysterious Book: the video player no longer aborts the game after a few minutes. Hyrule Warriors: Age of Imprisonment had the same rare problem, and that's fixed too.
- Mario Tennis Fever: button icons show up in text instead of question marks.
- Pokémon Legends: Z-A: the cutscene after the train station is no longer one flat colour.
- Sound: fixed loud clicks at the start of some sound effects, plus audio that could stop in some games.
- Fewer short freezes on Linux: Orchid no longer forces unused game memory into swap, which could pause the whole game (and its sound) for several seconds.
- Fewer crashes, hangs and broken graphics overall. Lots of fixes to shaders, textures and GPU syncing, especially for Switch 2 games.
New features
- New modern interface (experimental, off by default). Turn it on under Configure > General > UI > Modern interface. You get a sidebar, a big picture for the selected game, a game details page and settings right in the main window. You can add your own hero art per game, or pick it from SteamGridDB with your own API key.
- Better "Standard" graphics preset. It now uses SMAA and 16x texture filtering, which looks clearly sharper and costs almost nothing. "Low" and "High" haven't changed.
- More control over NUP game files. In a game's Add-Ons tab you can now see every update, DLC and Switch 2 Edition inside a NUP and switch each one off. For example, you can boot the Switch 1 version instead of the Switch 2 Edition.
- More dump layouts are recognised. Switch 2 Edition dumps that keep the program in a
program1folder (for example Kirby) boot and show up in the game list.
For bug reports
Orchid now writes graphics and system memory use to the log once a minute. If a game slows down or crashes after a while, that line helps a lot, so please attach the full log.
Thanks
Many fixes in this release come from other Eglantine-based projects and their authors. They're credited in each change below and in the README.
Changes since v0.9.5
- core: don't shadow Impl::service_manager in RefreshTime (936d536)
- Prepare 0.10 release: version 0.10 and user-facing release notes (b717ebb)
- shader: track the LDG load predicate in geometry exit liveness (3d3aa76)
- shader: model immediate SHF in geometry exit liveness (28e69dd)
- shader: lower IMAD with a negated constant buffer addend (1493aea)
- shader: lower HSETP2 with a constant buffer (3e07267)
- shader: lower FSEL with a uniform second source (2df69e9)
- shader: shadow the packed operands of TEX with a uniform handle (9bf1c6d)
- shader: shadow all three coordinates of a 3D SURED (34fad49)
- shader: shadow SHFL, surface and gather registers over the uniform bank (bb63145)
- shader: shadow the gradient and global atomic registers of TXD and ATOMG (2a886a4)
- shader: shadow high registers of LOP3 with a cbuf or uniform B (3b2f227)
- shader: shadow high registers of SHF with a register, cbuf or uniform amount (6453d85)
- shader: shadow high registers of P2R, uniform I2FP and indexed LDC (da256c3)
- shader: shadow high registers of FMNMX/FADD without register B, F2F and IDP (78eeb40)
- shader: shadow high registers of R2UR, uniform FMUL/FFMA, IMNMX and LEA immediate (af21113)
- shader: shadow high registers of IMAD with a uniform B or C (beadb49)
- README: credit the forks of the 2026-11-11 fork scan (ca8b7cf)
- fork-scan: skip list for the full scan of 2026-11-11 (1d757c6)
- font: face-button glyphs in the synthesized standard font (d28ea76)
- video_core: flush adjacent device pages of a GPU range in one FlushRegion (1876a7d)
- shader: link IR instructions with normal intrusive hooks (963a9e3)
- dynarmic x64: compile blocks under the host MXCSR, not the guest's (165dc39)
- dynarmic: no perf map lock or name per compiled block without PERF_BUILDID_DIR (f24093c)
- texture_cache: view a 10-bit presented image as A2B10G10R10 (c72f197)
- host_shaders: bounds-check every ASTC decode and unswizzle image store (05ca337)
- shader: don't take rect or buffer texture types from a per-draw handle's fallback (789ef42)
- shader: zero the mesh workgroup count at the task prologue (5d5ff7c)
- shader: give a transform feedback varying that starts inside a vector its own byte offset (e95d04d)
- shader: split misaligned 64 and 128-bit storage buffer access (71538e9)
- shader: use NaN-defined min, max and clamp (76dabc0)
- shader: reuse the returned value on compare-exchange retry (9732e10)
- vulkan: fit a dual vertex program's texture arrays to the stage limits (cc7cc29)
- vulkan: don't wait for the GPU to grow the quad index buffer (b17f110)
- texture_cache, buffer_cache: don't hint memory cold that is uploaded again (0bb20c9)
- draw_manager: skip draws with no vertices or no instances (ba82bdc)
- buffer_cache: skip the multi-range lookup for a storage buffer inside one page (beedd22)
- buffer_cache: raise the virtual range cache to 65536 entries (c03f5a1)
- nx2:gsv: mirror guest syncpoint increments before answering waits (ed368ec)
- texture_cache: count a depth buffer as modified only when the draw can write it (0f4719d)
- vk_scheduler: pause, don't reset, the occlusion counter at each submission (327d5bf)
- audio: return the registered managers from nx2:aud:u, add IAudioRenderer cmd 14 (4b44ef9)
- texture_cache: land deferred clears before non-pass image writes (54569d0)
- vulkan: drop draws recorded after a graphics pipeline that failed to build (a156fbf)
- shader: collect denormal controls from FP32 min and max (dbecda6)
- core: do not wait for the time services when applying settings during loading (275b83a)
- fiber: don't hold a weak reference across a fiber switch (99af9a1)
- vulkan: give the screenshot frame its size (acd8218)
- vulkan_wrapper: retry swapchain and surface enumerations on VK_INCOMPLETE (5bd435d)
- vulkan: keep the static pipeline cache path through device teardown (d28f63e)
- texture_cache: don't prepare the null image for views of empty descriptors (039d802)
- video_core: treat texture headers with format 0 as no texture (38358a9)
- vulkan: drop the sampler comparison for non-depth samples (2902b5f)
- vulkan: refuse to rescale images past 16384 px or 2^28 texels (eb0ab84)
- vulkan: invalidate blend equations at iterated-blend writes (f7e6ddf)
- fixed_pipeline_state: refresh a never-initialized blending state before it is baked (83490a5)
- buffer_cache: DMAClear checks the byte range, DMA writes mark command list pages (4dff8c2)
- video_core: release threads waiting for sync operations once the GPU threads stop (9437dbd)
- loader/nsp: refuse reads when the package has no program loader (09c378b)
- filesystem: bound file and storage I/O by the IPC buffer sizes (625a757)
- common: fix two lifetime bugs in MultiLevelPageTable moves (5c1b407)
- vulkan: order the null buffer's zero fill before every read of it (e5e7742)
- vulkan: order later transfers after a buffer copy that asked for barriers (b989a2c)
- dma: repeat CONST_A components for 8- and 16-bit fills (50b8b78)
- fence_manager: request the fence thread's stop under its mutex (f2c178d)
- common: release a worker task's captures before counting it done (edc31ec)
- host_memory: refuse backing clears that run past the end of the backing (70090ac)
- common: FlatAddressSpace frees a range between a free and a mapped neighbour (c713cf3)
- shader: keep the sign bit of an IADD3 immediate out of the negate flag (bd65649)
- nx2:gsv: wake armed syncpoint waits when their value moves (7f848ae)
- dynarmic: fix the argument decoding of the scalar FPRoundInt thunk (677fa4e)
- shader: drop the clip distance bitset shared through a header (a720c88)
- shader: apply FMZ before SAT in FFMA and HFMA2, and translate half FMZ (9ee986d)
- blit_image: sample blit sources clamped to their edges (85d1c8b)
- shader: read per-pixel gather offsets as 8-bit components in native programs (f8c227a)
- kernel: terminate processes outside the process list lock (31cc798)
- nvhost_gpu: do not submit to a channel whose engines were never initialised (3e3e03c)
- core: serialize GPU dirty memory gathers (cf38342)
- device_memory: ignore cold hints outside the device address space (1b9f243)
- video_core: invalidate every block a cached GPU write touches (31f1c0e)
- bcat: check a delivery cache file name as a file name (ff93b3a)
- macro: enlarge the Turing macro RAM so entries past 0x1000 execute (7bbfc19)
- common: prevent a lost wake when a worker thread stops (0594a07)
- common: Log2Ceil(0) is 0 instead of wrapping (71fa041)
- common: reserve the last page table level from the range's last byte (c770581)
- common: mark cold guest memory with MADV_COLD instead of MADV_PAGEOUT (3d951e3)
- audio_core: fix the sign of the ADPCM nibble steps (21d0d6d)
- docs: gate routes for all twelve scope games, how to record one (2fe222f)
- docs: AGENTS.md describes the reworked test harness (877d676)
- texture_cache: free old feedback-loop shadow copies (Wonder fps drops) (87250ae)
- shader: take a size query's texture type from a sample on the same handle (53017e2)
- hid: EDEN_AUTO_BUTTONS can hold stick directions (6923def)
- kepler_compute: the upscale stand-in skips images it cannot copy (b34e670)
- video_core: diagnostics for the Kirby and the Forgotten Land freeze reports (45f773e)
- ci: fix the Windows MSVC build of hero_art.cpp and the apt retry on Linux (0f5ab3b)
- frontend: mark the modern interface switch as experimental (5efe031)
- Merge remote-tracking branch 'origin/experimental-ui' into t3/experimental-ui-toggle (e192ade)
- scope: drop Age of Calamity and Xenoblade Chronicles 3 (06c632d)
- nup: keep a base package's version when repacking, show stored metadata when probing (94987dc)
- game_presets: Standard tier with SMAA and 16x anisotropic filtering (a9268ab)
- nup: show and switch off embedded updates, DLC and Switch 2 Editions (c06df80)
- loader: keep the update RomFS tier for wrapped program1 packages (583f602)
- game list: discover consolidated program1 editions (b38d352)
- loader: resolve consolidated program1 loose dumps (1ece930)
- nup: keep metadata and an empty RomFS when repacking an extracted archive (0e7f373)
- AGENTS.md: tighten wording, same rules (2453508)
- game_settings: split-friendly GPU defaults for Kirby and the Forgotten Land (Switch 2 Edition) (10a4fd2)
- nup: pack add-ons from nested dump layouts (a8734dc)
- frontend: import an image file as hero art (edac2c6)
- plans: mark 004 done (a93e098)
- tests: pin the write mask of the two-read 64-bit constant load (88fdb54)
- ampere: load 64-bit constants past 0x7fff as two 32-bit reads (8837379)
- frontend: hero art from SteamGridDB for the modern interface (68a9dc0)
- frontend: finish the modern interface after driving it (3c6418d)
- frontend: add the opt-in modern interface (2a083bc)
- Update README.md (3213494)
- Update README.md (e6cf0e8)
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.