Skip to content

0.12.0

Latest

Choose a tag to compare

@github-actions github-actions released this 21 Nov 14:56

Important

Please read first

  • Kirby Air Riders: races can still hang the GPU. Please don't play it on Orchid yet.
  • New user folder: new installs keep their settings, saves and cache in orchid folders (~/.local/share/orchid, ~/.config/orchid, ~/.cache/orchid on Linux, %APPDATA%\orchid on Windows). If you already use Orchid, nothing changes: your existing eden folders stay in use and nothing is moved. To switch, rename them to orchid; the log says how (#154).
  • 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.12.0

HDR output, a 4K option for Yoshi, smoother Donkey Kong Bananza and Star Fox, and many fixes for crashes, controllers and game files.

New

  • HDR output: Switch 2 games with an HDR mode can now show it in HDR. Turn it on in Graphics > HDR output (Off, Auto, On; Off by default, Vulkan only). HDR10 and scRGB are supported. Auto works on Windows; on Linux use On and run Orchid as a Wayland client. While a frame is in HDR, anti-aliasing, post-processing, FSR upscaling and frame generation are paused (#178).
  • Yoshi and the Mysterious Book: a built-in 4K game patch makes the game sharp instead of blurry. Turn on Internal resolution 4K (game patch) in the game's properties. Off by default, for game version 1.0.2; an installed resolution mod takes precedence. Patch by Walnutoast830 (#144).
  • NXFormat game archives (.nx) can be opened and show up in the game list (#166).

What's better in your games

  • Donkey Kong Bananza: breaking terrain runs smoother (in our test scene about 50 → 56 FPS) (#182), and the game no longer drops to 30 FPS when the CPU clock is set to Boost (#180).
  • Star Fox: runs at about 58 FPS again instead of 39 when the CPU clock is set to Boost (#180).
  • Yoshi and the Mysterious Book: loading a save no longer ends the game with error 2162-0001 (#181).
  • Kirby and the Forgotten Land: the fog in the first Star-Crossed World stage is back on NVIDIA RTX 20 series and newer (#179).
  • Super Mario Bros. Wonder: no longer freezes the PC on 12 GB graphics cards when video memory runs out (#123).
  • Hyrule Warriors: Age of Imprisonment: no more tearing line near the top of the screen. Game presets no longer change your VSync mode (#167).
  • Hyrule Warriors: Age of Imprisonment: less GPU-thread work in fights when textures are uploaded (#143).
  • Game videos: when the GPU video decoder can't play a video, Orchid now plays it on the CPU instead of showing nothing.
  • Standalone updates (.nup) that carry the Switch 2 program start that program instead of the Switch 1 one (#153).

Controllers

  • A Pro Controller with vibration on no longer stops responding after a while (#55).
  • Vibration queries for a controller Orchid doesn't know no longer make a game abort (#111).
  • Linux: when a Bluetooth controller connects but sends no input because Orchid can't open its device, the input settings say so and show the udev rule that fixes it.
  • Tab can be bound to a button.

Orchid itself

  • Stopping a game gives its memory back (about 3 GB after Donkey Kong Bananza).
  • Windows: Orchid starts from a folder with accented or other non-English letters in its path (PGO build) (#116).
  • Windows: installed game files are no longer locked against a second read (#113), and the game log opens again on a second game start.
  • Settings and game properties scroll when they don't fit on the screen.
  • Missing keys are named clearly: the error points to Tools > Install Decryption Keys or says which title key is missing, instead of "bad NCA header, redump".
  • Loose dumps get the same name in the game list and the window title.
  • Dump RomFS works on a loose .nup game.
  • NVIDIA: a wrong driver-version check no longer turns off a Vulkan feature, so fewer shaders are compiled while playing.
  • Stopping and restarting a game quickly no longer acts on the wrong session.
  • The shader cache is saved safely, so an interrupted exit can't damage it.
  • Damaged keys files, cheats, NCZ files and game metadata are rejected instead of crashing Orchid.
  • The multiplayer ban lists are saved correctly.

Downloads

The release files are also on GitLab: https://gitlab.com/MythosOfs/Orchid/-/releases

Thanks

Many fixes in this release come from other Eglantine forks: zortos293/Eglantine, Lichii and its forks, astraea-emu/nx2 and Eglantine Community. Thanks to Zortos, Daniel Jesús Martín Flores, Matt Artist, 999sian, Carlos Lopez, 101Leafy, SmileyTatsu, Delio Azeredo, Luke Evanson, RomainROCH, Amix and everyone else whose work went in, to Walnutoast830 for the Yoshi patch, and to everyone who sent logs and tested builds.


Changes since v0.11.1

  • vfs_vector: undo the Windows file API macros like vfs.h does (dea2489)
  • nx2_video: rename packet parameters that shadow the Impl member (e552b0b)
  • Prepare 0.12 release: version 0.12 and user-facing release notes (226ced4)
  • Merge pull request #193 from MythosOfs/t3/audit-and-remove-comments (9c851de)
  • Merge origin/main into t3/audit-and-remove-comments (1a1292b)
  • Merge pull request #200 from MythosOfs/fix/149-fork-scan-ports (67882d2)
  • Merge remote-tracking branch 'origin/main' into fix/149-fork-scan-ports (0ea97d9)
  • Merge pull request #194 from MythosOfs/feat/hdr-output-178 (34f8fcd)
  • Merge pull request #184 from MythosOfs/fix/59-release-guest-ram-on-stop (31d291a)
  • Merge pull request #185 from MythosOfs/fix/170-fork-scan-ports (082e01e)
  • Merge pull request #186 from MythosOfs/fix/141-rename-missing-source (28a918d)
  • Merge pull request #199 from MythosOfs/fix/175-fork-scan-ports (de4c39c)
  • Merge pull request #195 from MythosOfs/t3/yoshi-reload-pr181 (88eed16)
  • time_zone: reject a rule whose default type or transition count is out of range (8e185a7)
  • time_zone: check abbreviations once and probe second times without revalidating (7660cac)
  • time_zone: take a second POSIX time only if it maps back to the local time (833f4cf)
  • tests: check the scaled extent guard against a taller-than-wide limit too (d6036ab)
  • frontend: keep installed DLC selectable when dumping a loose NUP's RomFS (cf24528)
  • time_zone: pair no time before the first transition with transition 0 (7fb9965)
  • texture_cache: compare the scaled width and height with their own framebuffer limits (6d54985)
  • tests: a static pipeline cache of another version reads as no cache (4fa607b)
  • vk_texture_cache: keep an initialised scale destination in GENERAL (b648147)
  • texture_cache: keep aliases native when one of them passes the device limits (fb149cb)
  • vk_texture_cache: start the scale helper's destination from an undefined layout (a18b1d6)
  • texture_cache: keep MSAA images native when downscaling leaves no texel (9b66dc9)
  • vk_texture_cache: blit from the other image when the scale helper rescales (5919a2d)
  • texture_cache: keep images native when the scaled size passes the device limits (aee1727)
  • tests: drop the Windows sweep of other auto stub test log directories (8365ef1)
  • tests: remove the auto stub test's log directory at process exit (480396a)
  • tests: give each auto stub test run its own log directory and prune old ones (83cedb2)
  • vulkan: keep a failed static pipeline cache save inside the device teardown (0b0dc94)
  • tests: reuse one log directory under the build tree for the auto stub test (948ad59)
  • vulkan: fail the static pipeline cache save when naming its file throws (739ec86)
  • key_manager: log the keyblob index, not the line, for a keyblob past the table (db5682b)
  • tests: keys file values two digits short for named and key area keys (30bf633)
  • key_manager: name only the file when skipping a short keys file value (6771c9f)
  • tests: give each key manager test a fresh KeyManager in its own process (d807a4c)
  • crypto: reject a personalized ticket whose OAEP label hash is wrong (81f67f2)
  • input_common/sdl: warn when a controller sends no input and its hidraw node can't be opened (93e7d93)
  • tests: run the keyblob CMAC test after another test loaded a header key (730db66)
  • vulkan: write the static pipeline cache atomically (169b9d8)
  • sockets: translate protocol 0 (IP) on Windows and other hosts (393e3be)
  • service: log an auto-stubbed unknown command instead of asserting (6b72dab)
  • ssl: make Peek return the bytes waiting instead of peeking zero (4ea7213)
  • qt_config: read the multiplayer ban lists back from their saved keys (de02608)
  • common: keep a sparse vector page writable when the fault handler commits it again (cf5b8e1)
  • file_sys: give each NAX0 HMAC its own OpenSSL context (3b475d0)
  • crypto: compute the keyblob CMAC with the cipher named and the key length in bytes (53047a5)
  • crypto: decrypt personalized ticket title keys with a BN_CTX and padded output (b26a61c)
  • nx2_video: keep the host GPU when the CPU fails to receive the switching packet (53626df)
  • tests: check that a decoded frame does not count as a failed receive (bd43e5b)
  • nx2_video: keep the host GPU when the CPU fails to decode a replayed packet (8f7844f)
  • nx2_video: let the next video fall back to the CPU again after a flush (10eb1b1)
  • nx2_video: replay the packets the host GPU took when the CPU takes over (4fa83ef)
  • qt: judge the Switch 2 Edition name only for exefs layouts (f48f23c)
  • qt: name a loose dump with main directly in its game folder after that folder (bb5283c)
  • tests: pin that a session ends into the next session number (b98d8df)
  • qt: restart only when exactly its own session ended (55492a2)
  • qt: stop and restart act only on the session they were asked for (04631db)
  • qt: let ShutdownGame stop only the session it started with (48a6b86)
  • qt: finalize each emulation session once, even at the shutdown deadline (66ca33e)
  • qt: use installed control names only for loose dumps (bf6a761)
  • qt: keep container titles first and name list entries after all folders (9a51439)
  • qt: one name precedence for the game list and the window title (1e33d2a)
  • loader: log which NCA misses its title key or titlekek (4ada632)
  • loader: name the file a missing title key, titlekek or key area key belongs in (eee1c6a)
  • tests: expect the GPU in the nx2 probe when the CPU also rejects a packet (4806629)
  • nx2_video: keep the first-frame latch across flushes, drop stale timestamps on the switch (ebbb5f8)
  • tests: keep a host GPU in the nx2 probe that rejects only a later packet (5558223)
  • nx2_video: fall back to the CPU until the first frame, keep the GPU when the CPU fails (001b4a8)
  • main_window: point to Install Decryption Keys when a key is missing (06f2f07)
  • configuration: leave a dialog that fits the screen alone (e7a8e3f)
  • configuration: fit to the frame after both mapping and activation (51f147d)
  • configuration: leave the first placement to Qt and re-fit once the dialog is framed (238bcbd)
  • configuration: use the dialog's frame only once the window manager has framed it (73fd96d)
  • configuration: fit the settings dialog to its own screen and frame after showing (d7bd61b)
  • configuration: re-check the screen fit when the settings category changes (b98f378)
  • loader: require the whole NCA header area to be readable before asking for header_key (9d3f86f)
  • tests: put the title ID 0 program behind update metadata (db0c4f0)
  • tests: cover the NSP title ID 0 check after the reordered status checks (c6eec27)
  • loader: report a metadata NCA's missing header key and require full NCA headers (11083d8)
  • tests: include windows.h after the project headers in the GPU split ring test (a271cd3)
  • tests: fail at once when the GPU front sleeps for the wrong position (facb0f1)
  • tests: check that the waiting GPU front sleeps, not only its CPU time (a5d893b)
  • tests: run the GPU split ring test alone and measure at the full ring (d3901b1)
  • tests: keep std::min usable next to the Windows min macro (7ed9171)
  • nx2_video: apply the Open fault only when opening, judge success first (deed5d4)
  • nx2_video: inject GPU decode faults as FFmpeg send status (51bca04)
  • tests: treat a rejected packet as no host GPU decode in the nx2 probe (7617a37)
  • tests: drain and close the host GPU decoder probe before the nx2 test (be8d437)
  • nx2_video: count only a real accept before keeping the host GPU decoder (23a41a2)
  • nx2_video: keep the GPU decode fault seam per decoder (0a0f038)
  • nx2_video: decode on the CPU when the host GPU decoder fails to start (fe1dcc3)
  • gc_adapter: call libusb_exit only after a successful libusb_init (64c90e9)
  • configuration: scroll settings pages when the dialog does not fit the screen (9339137)
  • loader: report a missing header key instead of a bad NCA header (61682af)
  • vulkan: count physical devices again when enumeration is incomplete (b624202)
  • video_core: sleep while the GPU front waits for ring space (08a2041)
  • configure_input_player: bind Tab while a mapping runs (2ddd2b4)
  • qt: name loose dumps in the window title like the game list does (1776c1a)
  • qt: drop the queued finished() before terminating the emulation thread (c2ee509)
  • ncz_decompressor: check the NCZBLOCK header and section table while parsing (dde7acc)
  • ips_layer: use '\x1b' for the IPSwitch \e escape (45fdbae)
  • program_metadata: check NPDM magics and section extents before reading them (c32a69f)
  • Merge remote-tracking branch 'origin/main' into t3/merge-141 (a66ba6d)
  • tz: report the transition index so the repeated fall-back hour returns both times (c735181)
  • key_manager: skip keys file lines whose value is too short or out of range (b0cf715)
  • cheat_engine: stop reading past the text for an unterminated cheat name (7268097)
  • Merge remote-tracking branch 'origin/main' into t3/merge-170 (e8b5192)
  • Reconcile the Yoshi fix branch with its GitLab mirror (7f72781)
  • main_window: reapply title defaults when the game properties dialog is cancelled (#181) (bffea15)
  • game_settings: keep Yoshi's reactive flushing on without a preset too (#181) (bb86144)
  • game_presets: keep reactive flushing on for Yoshi and the Mysterious Book (#181) (ff24569)
  • Reconcile the HDR branch with its pre-rebase GitLab mirror (3d34cdf)
  • video_core: HDR port: lock the device wait, no upscaler images for HDR (cb71f6b)
  • video_core: HDR port: free the old staging buffer before a larger one (fa3e1f0)
  • video_core: HDR port: a larger stride replaces only the staging buffer (73295b9)
  • video_core: HDR port: grow-only Vulkan staging with fixed slots (e87684b)
  • video_core: HDR port: wait before releasing layer resources, unmapped FP16 (e07a256)
  • video_core: HDR port follow-ups from the final review (b611c9f)
  • video_core: SDR swapchain when HDR runs out of memory, stride-keyed staging (ab5b088)
  • video_core: fix padded FP16 detile, present retry and fallback race (eb86781)
  • video_core: HDR review fixes for the FP16 detile check and SDR fallback (f8cdef2)
  • video_core, nx2: native HDR output (HDR10/scRGB, Off/Auto/On) (1f994fb)
  • video_core: HDR port: lock the device wait, no upscaler images for HDR (7f1616f)
  • Merge origin/main into fix/59-release-guest-ram-on-stop (07c6d8e)
  • kernel: keep ForEachFreeBlock out of the widely included page heap header (b8a49ac)
  • video_core: HDR port: free the old staging buffer before a larger one (a796f04)
  • video_core: HDR port: a larger stride replaces only the staging buffer (0b189e5)
  • video_core: HDR port: grow-only Vulkan staging with fixed slots (28aaeb4)
  • kernel: also release pages already free at shutdown and pages freed after it (585bc60)
  • video_core: HDR port: wait before releasing layer resources, unmapped FP16 (44d8f20)
  • host_memory: test Discard on the plain fallback buffer, drop a redundant length guard (ca3548e)
  • video_core: HDR port follow-ups from the final review (2c6eba3)
  • video_core: SDR swapchain when HDR runs out of memory, stride-keyed staging (0583712)
  • AGENTS.md: rendering references against Switch 2 footage, orchid-bottlenecks report (2cb7f18)
  • video_core: fix padded FP16 detile, present retry and fallback race (2c39840)
  • core: give a stopped game's freed pages back to the host instead of destroying guest RAM (60e08c6)
  • video_core: HDR review fixes for the FP16 detile check and SDR fallback (57fae84)
  • Keep the GitLab mirror fast-forward after the rebase (tree unchanged) (e34884a)
  • video_core, nx2: native HDR output (HDR10/scRGB, Off/Auto/On) (d2d941c)
  • core: close shutdown races before releasing guest RAM (72ebab4)
  • Ban code comments in src/ with a ratchet; strip nx2 comments into ADRs (425aa94)
  • frontend: dump the RomFS of a loose NUP from its loader (a2b3765)
  • filesystem: reject a missing rename source before the cross-directory move (1c5334e)
  • path_util: ignore empty and relative XDG base directories (14afef8)
  • game_presets: keep reactive flushing on for Yoshi and the Mysterious Book (#181) (8da31ed)
  • core: release guest RAM after stopping a Switch 2 game (f8c40bc)
  • core: release guest RAM after stopping a Switch 2 game (d32626c)
  • logging: close active log file before switching game logs (81710b0)
  • vulkan_device: decode NVIDIA driver version for vertex_input_dynamic_state check (834e714)
  • buffer_cache: reuse storage bindings while GPU mappings are stable (#182) (0d7fbb7)
  • game_settings, game_presets: keep Normal CPU clock for Donkey Kong Bananza and Star Fox (#180) (36290dd)
  • texture_cache: read a pitch-linear image once per upload (386582a)
  • Keep automated emulator tests on the private harness display (e700b22)
  • patch_manager: built-in 4K patch for Yoshi and the Mysterious Book (66702f5)
  • kirby: keep fog on NVIDIA Turing and newer (#179) (29e2ca5)
  • game_presets: keep the user's VSync mode instead of forcing FIFO Relaxed (f03e8bb)
  • loader: open NXFormat game archives (6b1bf78)
  • nup: boot embedded program1 from standalone updates (43d1c73)
  • video_core: stop the tensor-core stand-in and the VRAM line reading like a crash (e34f8bb)
  • input_common: limit the direct Joy-Con driver's rumble reports to one per 15 ms (8bb9735)
  • hid: never fail vibration queries for a handle we consider invalid (e8d3034)
  • texture_cache: leave budget-driven titles more room and collect at once when memory runs out (c8713d7)
  • vfs_real: open host files with write access only when written (5cb52c1)
  • yuzu: start from a folder with non-ASCII characters on Windows (MinGW build) (7f06327)
  • common/fs: use "orchid" user directories, keep existing "eden" ones (dd7def1)

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.