eden-emu/eden
24
3
Fork 18
Code Issues 90 Pull requests 79 Projects 1 Releases 7 Wiki Activity Actions
7 releases 18 tags
  • v0.0.4-rc3 fe13539d72

    Eden v0.0.4-rc3
    All checks were successful
    tx-src / sources (push) Successful in 48s
    Details
    Check Strings / check-strings (push) Successful in 54s
    Details
    GitHub Actions [CI] Build succeeded
    Details
    GitHub Releases [CD] Build succeeded – Release published
    Details
    Stable

    ci released this 2025-11-22 22:52:08 +01:00 | 45 commits to master since this release

    Changelog

    This release has been focused on fixing overall regressions found since 0.0.3, in tandem to prepare for a full 0.0.4. We hope to offer users a more stable experience with this new release candidate.

    As always, clear your shader caches as the vulkan pipeline parameters continues to change.

    Critical

    • Experimental support for firmware versions 21.x is now available.
      • Most software applets work as expected, but like 20.x, the home menu is currently missing game icons.

    Universal

    • Reduce SPSC/MPSC queue contention, increases performance for various games
      • Mileage may vary, on tested hardware games could get up to 10 FPS extra
    • Translations have been updated
    • Fixed performance regressions (stuttering) found in Tears of the Kingdom

    Renderer

    • Fix SURED() having inappropriate behaviour for certain decoding fields
    • Fixed Ninja Gaiden: Ragebound black screen during the 4-1 boss fight.
    • Improved Pokemon: Legends Z-A graphical bugs
      • Enabling Extended Dynamic State and disabling Vertex Input Dynamic State is recommended to avoid vertex explosions.
      • Flickering and invisible objects may still be present.
    • Fixed flipped screen in 20xx

    Desktop

    • Working MinGW (Windows) builds for arm64 are now available.
      • This primarily targets Snapdragon X laptops.
    • Fixed several issues with Ryujinx save data linking.
      • Attempting a "From Eden" link and saving on Ryujinx would destroy the link.
      • Windows would often fail to create a link at all, especially if the path contained spaces.
      • Prior link detection was unreliable.
    • Fixed several issues with the orphaned profile detector.
      • A bunch of extra zeroes would appear in the "good" profiles list
      • Automatically-created profiles for games like Smash Ultimate and Factorio were included in the "bad" profile list.
    • Fixed a bug on POSIX where the app would immediately crash in scenarios where USER was unset.

    Android

    • Fixes crashes on Ender Magnolia and UE4 games introduced by defered allocations
      • UE4 games should be more stable
    • Remove ScopedJitExecutor; fixes crashes in Assasins Creed 3
      • Scoped JIT sucks and will hopefully never be brought up ever again
    • Custom CPU Ticks can now have its value typed in manually.
    • Setting to manually set app language
    • Fixed carousel view occasionally clipping out of the bottom of the screen.
    • Added a system information dialog
      • Contains CPU, GPU, system, etc. info
    • Shader cache is now wiped whenever the GPU driver is changed.

    Internal

    • MinGW and macOS builds are now fully static.
      • macOS now only contains its MoltenVK dependency, whereas MinGW builds are self-contained executables.
    • Fix FFmpeg annoyances for Solaris and BSD
    • Reduce code duplication on shader_recompiler
    • Provide fallbacks for platforms without atomic 128 bit swaps
    • Fix formatting for big endian targets

    Builds

    MSVC/arm64 builds have been retired, and replaced with MinGW/arm64 builds. Additionally, all MSVC PGO builds have been removed due to a lack of performance gain, and are replaced by MinGW PGO builds.

    TL;DR

    Again these changelogs aren't that long, but for the sake of briefness:

    • Fixes for Pokemon ZA on AMD
    • Fixes for Ender Magnolia on Android and other UE4 games
    • Fixes for regressions from 0.0.4-rc1 and 0.0.4-rc2
    • Initial Firmware 21 support
    • Windows on ARM support

    Packages

    Linux

    Linux packages are distributed via AppImage.
    zsync files are provided for easier updating, such as via
    AM.

    Build Type GCC PGO Notes
    amd64 GCC (zsync) PGO (zsync)
    Legacy amd64 GCC (zsync) PGO (zsync) Pre-Ryzen or Haswell CPUs (expect sadness)
    Steam Deck GCC (zsync) PGO (zsync) Zen 2, with additional patches for SteamOS
    ROG Ally X GCC (zsync) PGO (zsync) Zen 4
    aarch64 GCC (zsync) PGO (zsync)

    Debian/Ubuntu

    Debian/Ubuntu targets are .deb files, which can be installed via sudo dpkg -i <package>.deb.

    Target amd64 aarch64 Notes
    Ubuntu 24.04 amd64 aarch64 Not compatible with Ubuntu 25.04 or later
    Debian 12 amd64 aarch64 Drivers may be old
    Debian 13 amd64 aarch64

    Windows

    Windows packages are in-place zip files. Setup files are soon to come.
    Note that arm64 builds are experimental.

    Compiler amd64 arm64 Notes
    MSVC amd64
    MinGW amd64 arm64 May have additional bugs/glitches
    MinGW PGO amd64 arm64

    Android

    For more spoofed package name builds, see here

    Build Description
    Android Standard Single APK for all supported Android devices (most users should use this)
    Android Optimized For any Android device that has Frame Generation or any other per-device feature
    Android Legacy For Adreno A6xx and other older GPUs

    macOS

    macOS comes in a tarballed app. These builds are currently experimental, and you should expect major graphical glitches and crashes.
    In order to run the app, you may need to go to System Settings -> Privacy & Security -> Security -> Allow untrusted app.

    File Description
    macOS For Apple Silicon (M1, M2, etc)
    Downloads
  • v0.0.4-rc2 08f3639c80

    Eden v0.0.4-rc2
    All checks were successful
    GitHub Actions [CI] Build succeeded
    Details
    GitHub Releases [CD] Build succeeded – Release published
    Details
    Stable

    ci released this 2025-11-12 03:13:36 +01:00 | 100 commits to master since this release

    Changelog

    Critical

    A bug fix in v0.0.4-rc2 for Linux users that prevented any game from launching has been fixed. The issue was related to vtable handling being improperly typecasted from a pointer-to-pointer to a pointer.

    Also you can now play CTGPDX and stuff since ASLR is also now implemented properly, should fix a bunch of skyline mods as well.

    The NVIDIA vertex explosions and AMD fixes for Pokemon ZA are not in this release, please be patient <3

    This release also fixes a lot of bugs related to Ryujinx save linking, as always back up your saves!

    Universal

    • Skyline compatibility, minimal ASLR implementation.
    • Support for VTable bouncing.
    • Should fix crashes in Pokemon ZA.
    • Dynarmic internal refactorings to reduce code latency.
    • This should decrease loading times and stutters by a tiny margin.
    • Do not immediately error out if OpenGL is missing some extensions (meant for older cards).
    • There may be visual glitches.
    • Fix a regression found on image_view and image_view_info.
    • Windows 8.1 support (command line only).
    • More verbose backtraces.

    Renderer

    • Maxwell translator loop now uses a tighter logic without dynamic dispatchers.
    • Just let the compiler do it's thing.
    • Add IAbs64 support to prevent IR errors.
    • It fixes an obscure behaviour very few programs rely on.
    • Add back VIDS but disable on EDS0
    • Increase MAX_MIP_LEVELS to 16 to match spec.

    Desktop

    • Audio fixes for steamdeck.
    • Clean up orphaned profiles bugs.
    • Added an option to force X11 backend for Linux users.
    • Discord RPC no longer uses named variant logo.
    • Moved links to the "About" section.
    • Add vpushfb usage in Dynarmic for VREV32/64.
    • Move save option location in the data manager tool.
    • Fixes for NixOS and DragonFlyBSD.
    • Removed QDockWidget Wait Tree.

    Android

    • Various UX fixups and improvments.
    • Fix rotate and unpause bug.
    • Fixes for QLaunch.

    Internal

    • Removed software prefetching instances.
    • Fix audio reverb according to spec.
    • Stub ReleaseSleepLock and ReleaseSleepLockTransiently.
    • Some general code cleanups.
    • Removed Zydis/Zycore.
    • This should reduce executable size by a bit.
    • More things translated from Common:: into std::.
    • Fixes for Intel Atom N455.

    TLDR

    You didn't read the changelog in full? Unfortunate - because it was a bit shorter this time :)

    • Fixed a critical bug for all x86_64 Linux users (didn't affect FreeBSD or Solaris)
    • Slight performance increases for shader compilation
    • DragonFlyBSD support ruh rah!
    • Fixes for audio cutoffs on steamdeck.

    Targets

    For more specialized Android builds, Antutu and stuff

    Each build is optimized for a specific architecture and uses a specific compiler.

    • aarch64/arm64: For devices that use the armv8-a instruction set; e.g. Snapdragon X, all Android devices, and Apple Silicon Macs.
    • amd64: For devices that use the amd64 (aka x86_64) instruction set; this is exclusively used by Intel and AMD CPUs and is only found on desktops.

    Compilers

    • MSVC: The default compiler for Windows. This is the most stable experience, but may lack in performance compared to any of the following alternatives.
    • Clang: An alternative compiler that provides theoretically higher performance, but may have additional graphical glitches.
    • GCC: The standard GNU compiler; this is the default for Linux and will provide the most stable experience.
    • PGO: These are built with Clang, and use PGO:

    PGO (profile-guided optimization) uses data from prior compilations to determine the "hotspots" found within the codebase. Using these hotspots,
    it can allocate more resources towards these heavily-used areas, and thus generally see improved performance to the tune of ~10-50%,
    depending on the specific game, hardware, and platform. Do note that additional instabilities may occur.

    Linux

    Linux packages are distributed via AppImage.
    zsync files are provided for easier updating.

    Build Type GCC PGO Notes
    amd64 GCC (zsync) PGO (zsync)
    Legacy amd64 GCC (zsync) PGO (zsync) Pre-Ryzen or Haswell CPUs (expect sadness)
    Steam Deck GCC (zsync) PGO (zsync) Zen 2, with additional patches for SteamOS
    ROG Ally X GCC (zsync) PGO (zsync) Zen 4
    aarch64 GCC (zsync) PGO (zsync)

    Debian/Ubuntu

    Debian/Ubuntu targets are .deb files, which can be installed via sudo dpkg -i <package>.deb.

    Target amd64 aarch64 Notes
    Ubuntu 24.04 amd64 aarch64 Not compatible with Ubuntu 25.04 or later
    Debian 12 amd64 aarch64 Drivers may be old
    Debian 13 amd64 aarch64

    Windows

    Windows packages are in-place zip files. Setup files are soon to come.
    Note that arm64 builds are extremely experimental and are unlikely to work at all.

    Compiler amd64 arm64 Notes
    MSVC amd64 arm64
    PGO amd64 arm64
    MinGW amd64 May have additional bugs/glitches
    MinGW PGO amd64

    Android

    Build Description
    Android Standard Single APK for all supported Android devices (most users should use this)
    Android Optimized For any Android device that has Frame Generation or any other per-device feature
    Android Legacy For Adreno A6xx and other older GPUs

    macOS

    macOS comes in a tarballed app. These builds are currently experimental, and you should expect major graphical glitches and crashes.
    In order to run the app, you may need to go to System Settings -> Privacy & Security -> Security -> Allow untrusted app.

    File Description
    macOS For Apple Silicon (M1, M2, etc)

    Source

    Contains all source code, submodules, and CPM cache at the time of release.
    This can be extracted with tar xf Eden-Source-v0.0.4-rc2.tar.zst.

    File Description
    tar.zst Source as a zstd-compressed tarball (Windows: use Git Bash or MSYS2)
    Downloads
  • v0.0.4-rc1 15becaa5a3

    Eden v0.0.4-rc1
    All checks were successful
    GitHub Actions [CI] Build succeeded
    Details
    GitHub Releases [CD] Build succeeded – Release published
    Details
    Stable

    ci released this 2025-11-12 03:07:32 +01:00 | 181 commits to master since this release

    Changelog

    Critical

    A bug fix in v0.0.4-rc1 related to improper handling of profiles may result in you losing save data if you're not careful. Read the following very carefully:

    If your NAND directory is configured to be anywhere other than the default, there is a good chance you will receive a dialog about orphaned profiles. To solve this:

    • Take note of what profiles are orphaned
    • Backup ALL your save data
    • Find the largest and most recently-updated profile folder
    • Delete all profiles, but leave any that the dialog told you were VALID
    • Copy your "good" saves to the good profile (it should NOT be all zeroes)
    • If some of your saves are missing, try other old profile folders.

    Universal

    • Full REV12/REV15 support, and HID support for new games and updates
      • Notably, this allows for many new updates like TotK 1.4.2, BotW 1.8.2, and others to run.
      • This also fixes controller-related bugs in some newer games.
    • Initial support for firmware 20.x
      • Some minor issues may still occur, especially in the Home Menu applet. Always keep a backup of a firmware dump from 19.0.1 or earlier just in case.
      • Notably, game icons may not show up in the home menu.
    • Fixed save/mod data loading from the Home Menu applet
    • Removed the NCA verification bypass
      • Games/updates that previously required NCA verification disabled will now work out of the box.
    • Reduced memory mapping latency on Linux and Android
    • Optimized texture pass during shader recompilation
    • Fixed FIFA FC26 launch
    • New window adaptation filters are available: Lanczos, Spline-1, Zero-Tangent, B-Spline, Mitchell, and MMPX
    • Merged Dynarmic optimization passes into a single TU
    • Improved async shader building
      • Graphical glitches caused by this option, notably in Tears of the Kingdom, should be reduced.
    • Unstubbed process winding services
      • This fixes applets on firmware 20.x, alongside Bioshock Infinite.
    • Many settings have had their verbiage updated and clarity improved
    • Fixed audio glitches in Echoes of Wisdom
    • Improved CPU/GPU video decoding detection, and better error handling thereof
    • Fixed stutters/freezes during certain FMV scenes
      • Notably, this improves Super Mario Galaxy 1/2
    • 1.25x resolution option
    • Fixed crashes caused by improper controller detection
    • Improved game decryption performance
      • This has been shown to significantly reduce startup times, especially with lots of mods installed.
      • On Android, some games now launch ~2x faster.
    • Translations for many languages have been dramatically improved and updated.
    • Cheats can now be done without build IDs, like Ryujinx
      • Keep in mind that this will not allow for build ID matching, which may cause issues with game updates.
    • Reduced Dynarmic code bloat
    • Fixed BotW missing audio

    Renderer

    • Improved Vulkan memory allocation
      • This should moderately increase R/W speed of Vulkan-allocated memory
    • VRAM usage now works properly on integrated graphics
    • Fixed crashes in Fire Emblem: Engage and others caused by MSAA handling
    • Improved the fast buffer binding path
      • This fixes some flickering in games such as Kirby Star Allies
    • Fixed some memory leaks present in the shader compiler
    • Present buffers are now properly flushed after CPU work is done on them
    • Improved Vulkan spec compliance
      • These may improve some graphical bugs on stock Android drivers, but are moreso done for code correctness
      • Shader read barriers
    • Ring Buffers
      • This primarily avoids conflicts between the CPU and GPU, and may improve performance
    • Fixed RAII, and removed the option for such
    • Faster uniform buffers
      • This mitigates some memory errors in TotK and other games
    • Improved renderer error messages
    • Improved some edge cases where games like Echoes of Wisdom would have undefined rendering behavior

    Desktop

    • Data Manager
      • Shows how much space is taken up by several commonly-used directories
      • These directories can be cleared, imported, or exported, and are theoretically compatible with Android's import/export system.
    • Fixed "Open Save Data Location" putting you in the completely wrong folder
      • Due to the nature of this fix, profiles may now be mangled and incorrect. See the note at the top of the changelog for what to do.
    • Orphaned profiles finder
      • Save data that is not associated with a specific profile is considered "orphaned" as it is effectively inaccessible.
    • Ryujinx save data linking
      • This allows users to share save data for specific titles between Eden and Ryujinx.
      • This feature is still in testing, especially on Windows.
    • FFmpeg was updated to version 8.0
    • Fixed some weirdness with the web applet setting
    • Play Time editing
    • Fixed misalignments on certain combo boxes (e.g. audio device) on the default theme
    • The compatibility list is back (though shortened)
    • Fixed the "Link" option during migration on Windows

    Android

    • Improved stock Qualcomm driver compatibility
      • This initial support also improves overall game support on 8 Elite devices.
      • Future releases will expand upon this.
    • Compact grid view option
    • Fixed some occasional crashes/bugs related to the EmuReady intent and overlay
    • The APK is now 16kb-aligned
    • Foreground notification service
      • This helps keep the app alive when switching to other activities
    • Individual buttons can now be scaled on the overlay
    • The overlay can now auto-hide when it hasn't been used for some time
    • Android versions as low as Android 7 are now supported
      • Note that your device still MUST support Vulkan 1.1, and should meet the minimum requirements for processing power.
    • Mouse/keyboard support
    • Per-game configuration import, export, and sharing
    • Added play time features from the Desktop frontend
    • Certain unneeded popups and warnings have been removed
    • Added the update checker from the Desktop frontend
    • (experimental) Amiibo support
    • Ability to filter logs to only include useful errors and warnings, rather than useless information

    Internal

    • Compatibility improvements for *BSD, Solaris, macOS, HaikuOS, and many more
      • NetBSD and DragonFlyBSD are now partially supported
    • LTO has been improved to utilize IPO (interprocedural optimization), aka "whole-program" optimization rather than individual library optimization
    • Windows can now be built with clang-cl and MSYS2/MinGW64
      • MinGW is not on CI yet, but early testing has shown it performs much better than MSVC
    • On UNIX-like systems, you can now build without any bundled dependencies at all
    • Our docs have been completely refactored, including a new User handbook
    • MbedTLS 3 is now supported
    • Debian 12, 13, and Ubuntu 24.04 are now fully supported
    • Even saner build identification
    • All assets have been optimized to take up less space
    • Many old, subpar reimplementations of Boost/stdlib functionalities were removed
      • As a consequence, *BSD support has been improved, and many deadlocks/weird bugs have been fixed on other platforms.
    • aarch64 is now fully supported for Linux, macOS, and Windows, though all three are experimental
    • Qt versions from 6.4.2 to 6.10 are now fully supported
      • Earlier versions are entirely untested, and Qt 5 is fully out-of-support.
    • Support for building with CCache has been improved
    • Windows 8.1 is now supported
      • Note that your device still MUST support Vulkan 1.1 or OpenGL 4.6

    Builds

    Several new builds are available. Builds marked as "standard" are the normal builds without PGO or similar.

    • Linux/clang
      • Clang theoretically provides better optimizations than GCC at the cost of potential instability. Thus, these builds should perform better but may have an additional glitch or two.
    • Windows/clang
      • Same deal as Linux, though it's still unfortunately limited by the MSVC backend's horrific optimization.
    • Linux/PGO
      • PGO (profile-guided optimization) uses data from prior compilations to determine the "hotspots" found within the codebase. Using these hotspots, it can allocate more resources towards these heavily-used areas, and thus generally see improved performance to the tune of ~10-50%, depending on the specific game, hardware, and platform.
    • Windows/PGO
      • Same deal as Linux, though it may be more unstable as PGO is tested much more frequently on Linux.
    • macOS
      • macOS still has significant graphical/performance issues and will likely crash A LOT.
    • Debian 12/13/Ubuntu 24.04
      • These are prebuilt .deb files for Ubuntu 24.04 and Debian 12/13 (Bookworm/Trixie), for both amd64 and aarch64. While experimental, they should provide better system integration than the AppImage, at the cost of not bundling the latest MESA drivers.

    TLDR

    So... you scrolled down here and ignored us telling you multiple times to thoroughly read the changelog. What do you need to know?

    • New updates for games, including TotK 1.4.2 and BotW 1.8.2, now work, alongside UltraCam and other mods for these updates
    • Firmware 20.x is now supported, though some features of the home menu may not work as expected.
    • If you get a scary popup saying orphaned profiles were found, backup ALL your save data, then delete all but the most recently updated/most populated profile folders.
      • Read the top of the changelog for more info.
    • As per usual, graphical bugs and glitches have been reduced, performance was increased, etc.
    • Some improvements to Legends: Z-A are present, but expect flickering and vertex explosions.
    • There are lots of new features, which you'll know about if you read the changelog ;)

    Packages

    Desktop builds will automatically put data in ~/.local/share/eden on Linux, or
    %APPDATA%/eden on Windows. You may optionally create a user directory in the
    same directory as the executable/AppImage to store data there instead.

    Linux

    Linux packages are distributed via AppImage. Each build is optimized for a specific architecture.
    See the Description column for more info. Note that legacy builds will always work on newer systems.

    Build Description
    amd64 (GCC) (zsync)
    Steam Deck (GCC) (zsync)
    armv8-a (GCC) (zsync)
    amd64 (legacy) (GCC) (zsync)
    ROG Ally X (GCC) (zsync)

    We are additionally providing experimental packages built with Clang, rather than GCC. These builds should be identical, if not faster,
    but how it affects the overall experience is currently unknown. In the future, these builds will be made with PGO to increase speed.

    Build Description
    amd64 (Clang) (zsync)
    Steam Deck (Clang) (zsync)
    armv8-a (Clang) (zsync)
    amd64 (legacy) (Clang) (zsync)
    ROG Ally X (Clang) (zsync)

    We are additionally providing experimental PGO packages. These should have improved performance, but may be unstable or have bugs.

    Build Description
    amd64 (PGO) (zsync)
    Steam Deck (PGO) (zsync)
    armv8-a (PGO) (zsync)
    amd64 (legacy) (PGO) (zsync)
    ROG Ally X (PGO) (zsync)

    Debian/Ubuntu

    These are prebuilt .deb packages for Ubuntu and Debian. To install them, run sudo dpkg -i Eden-<platform>-<version>.deb.
    Note that these use system drivers, and so you may have some graphical bugs with these builds as opposed to the appimage.

    Build Description
    Ubuntu 24.04 (amd64) Pre-packaged .deb file for Ubuntu 24.04 on amd64
    Ubuntu 24.04 (aarch64) Pre-packaged .deb file for Ubuntu 24.04 on aarch64
    Debian 12 (amd64) Pre-packaged .deb file for Debian 12 on amd64
    Debian 12 (aarch64) Pre-packaged .deb file for Debian 12 on aarch64
    Debian 13 (amd64) Pre-packaged .deb file for Debian 13 on amd64
    Debian 13 (aarch64) Pre-packaged .deb file for Debian 13 on aarch64

    Windows

    Windows packages are in-place zip files.

    Build Description
    amd64 For any Windows machine running an AMD or Intel CPU
    aarch64 For any Windows machine running a Qualcomm or other ARM-based SoC

    We are additionally providing experimental packages built with Clang, rather than MSVC. These builds should be identical, if not faster,
    but how it affects the overall experience is currently unknown.

    Build Description
    amd64 (clang) For any Windows machine running an AMD or Intel CPU (clang-cl build)
    aarch64 (clang) For any Windows machine running a Qualcomm or other ARM-based SoC (clang-cl build)

    We are additionally providing experimental PGO packages. These should have improved performance, but may be unstable or have bugs.

    Build Description
    amd64 (PGO) For any Windows machine running an AMD or Intel CPU (PGO build)
    aarch64 (PGO) For any Windows machine running a Qualcomm or other ARM-based SoC (PGO build)

    Android

    Build Description
    Android Standard Single APK for all supported Android devices (most users should use this)
    Android Optimized For any Android device that has Frame Generation or any other per-device feature
    Android Legacy For Adreno A6xx and other older GPUs

    macOS

    macOS comes in a tarballed app. These builds are currently experimental, and you should expect major graphical glitches and crashes.
    In order to run the app, you may need to go to System Settings -> Privacy & Security -> Security -> Allow untrusted app.

    File Description
    macOS For Apple Silicon (M1, M2, etc) computers running macOS

    Source

    Contains all source code, submodules, and CPM cache at the time of release.

    File Description
    tar.zst Source as a zstd-compressed tarball (Windows requires 7zip)
    Downloads
  • v0.0.3 6045627462

    Eden v0.0.3
    Some checks failed
    build.yml / [fs] temporarely disable nca verification (#298) (release) Failing after 0s
    Details
    trigger_release.yml / [fs] temporarely disable nca verification (#298) (release) Failing after 0s
    Details
    Stable

    ci released this 2025-11-12 02:59:30 +01:00 | 408 commits to master since this release

    This is the official stable release for 0.0.3. No new features will be added to the 0.0.3 branch, and updates will only occur if critical regressions or bugs are found, in which case we will release it as 0.0.3.x. Or, perhaps, some better support for macOS...?

    This release contains:

    • platform parity improvements, especially for Solaris and *BSD,
    • several incremental bug fixes to Vulkan, JIT, and CMake
    • minor UI fixes
    • improvements upon changes introduced in prior RCs
    • and support for some new games and updates

    Updating is recommended for all users.

    The following changelog is for changes from RC3 only. For the full 0.0.3 changelog, scroll further.

    Changelog

    • GPU driver download from EmuReady (Producdevity)
    • Updated defaults and clarified description for Extended Dynamic State (Pavel, MaranBr)
    • Added separate DMA precision level option (MaranBr, crueter)
      • Notably, higher precision levels can enable games like Ender Magnolia to run on Normal GPU accuracy.
    • Incremental Vulkan improvements (Wildcard, JPikachu, MaranBr)
      • Improved stencil handling
      • Improved master semaphore submits
      • Fix VertexInput handling
      • Improved memory allocations
        • Notably, this fixes slowdowns on Super Mario Odyssey on weaker hardware (incl. Steam Deck)
    • JIT improvements (lizzie)
    • Fix remaining MK8DX controller applet freezes (MaranBr)
    • Fixed controls dialog text clipping (crueter)
      • On Linux, the Dark theme may still clip if the controls window is forced to its minimum size.
      • We are still investigating this, however, deleting ~/.config/qt6ct may fix it.
    • Host MMU Emulation/Fastmem configuration outside of Debug (MaranBr)
      • Generally, this isn't needed to be changed except on some BSDs
    • Option to disable NCA verification (Maufeat, crueter)
      • This enables many new updates--including SMO 1.4.x and Pokemon S/V 4.0.0--to install and run, when they previously couldn't.
      • Note that many updates such as those for BotW and TotK may still not work at this time.
    • Removed Firmware 20+ warning on the game list (crueter)
      • Firmware 20+ is NOT supported at this time.
      • Although games may run fine with it, Eden will warn you if you attempt to run the home menu with new firmware installed.
      • If Eden warns you despite running earlier firmware, your firmware or keys are corrupt or pirated, and thus can't be read properly.
    • Initial stubs for new firmware functions (Maufeat, Pavel)
      • This enables some games such as Hollow Knight: Silksong to run.

    Internal

    • Improved Solaris, OpenBSD, and FreeBSD support (Lizzie, SDK-Chan, crueter)
    • Improved OpenSSL/SDL2 bundled package fetching (crueter)
    • CMake dependency prefetching (crueter)
      • The dependency resolution system was rewritten to take in JSON files (cpmfile.json), where a script can be run to fetch dependencies before configure time.
      • Notably, this re-enables NixOS builds, and some other distributions with network sandboxes may see benefits from this.
    • Fix compilation on clang (Lizzie)
    • Small compliance/performance improvements with fmt, ankerl, libstdc++, and more (Lizzie)
    • Finalized AllocObjSetCtx (SDK-Chan)

    Changes since 0.0.2

    Click to open

    Platforms

    Please note that platforms outside of Windows, Linux, and Android are still in an experimental state. You are unlikely to receive support unless you can provide useful debugging info.

    • Solaris/OpenIndiana support (Lizzie841)
    • Improved macOS support (crueter, Lizzie841, Maufeat)
    • FreeBSD/OpenBSD Support (Lizzie841, SDK-Chan)
    • Improvements for dependencies on Solaris and FreeBSD (crueter)

    Universal

    • JIT backend improvements (Lizzie841)
    • Improved Fast GPU time (crueter, Camille LaVey)
      • Higher overclock values increase resolution at the cost of performance
    • Fast CPU time option (crueter, Camille LaVey)
      • Overclocks the emulated CPU. May improve FPS caps in some games, but may also cause unwanted speedups or performance drops.
    • Fixed FMV greenscreens on all platforms (MaranBr, Maufeat, Shinmegumi)
    • Hardware-accelerated video decoding for h264, VP8, and VP9 on all supported GPUs and platforms (MaranBr)
    • Fixed Mario Kart 8 Deluxe controller applet freeze (MaranBr, Pavel)
    • Fixed crashes when attempting to read or apply new Switch 2 compatibility updates (crueter, Pavel)
    • Battery status in the Switch Home Menu (Maufeat)
    • Area Sampling filter (JPikachu, Torzu, crueter)
      • This option is best served when using a resolution higher than your display's resolution.
    • Stubbed ActivateDebugMouse for Gex Trilogy (Pavel)
    • Improved avatar selection and editing within firmware (Maufeat, Torzu)
    • Airplane Mode implementation (Maufeat, crueter)
      • Certain games "phone home" by default, and require airplane mode to be enabled to play.
    • Custom CPU Tick option (Gamer64, crueter)
      • Changes emulated CPU's ticks, can improve performance at the cost of stability.
    • Toggle for Vulkan RAII (Pavel)
      • Disabling this option may increase memory and CPU utilization, but may also fix issues with bundled games or on exit/activity switching.
    • More descriptive error messages for many actions (crueter)
    • Firmware version/validity checks (crueter)
      • If you install supported firmware, e.g. 19.0.1, and the app tells you your firmware is too new upon launching the home menu, then your firmware is likely corrupted, or your keys are invalid.
      • Ensure your firmware and keys were properly dumped.
    • Sane(r) default configuration (crueter)
    • Fixed Player 2 controller disconnect in DKC Tropical Freeze (MaranBr)
    • Implemented firmware profile editor (Maufeat, Torzu)
      • Added support for creating and deleting users via the HOME menu
      • Enabled reordering user positions in the HOME menu
      • Fixed profile picture editor in the HOME menu
      • Added support for various profile picture formats (PNG, JPEG, BMP)
    • Sync Memory Operations option (Higgs, MaranBr)
      • Notably, this fixes certain collection games, Abathor, Clock Tower Rewind, Guns of Fury, Ninja Five-O, and more
      • This option can decrease performance, though it's only believed to affect Unreal Engine 4 & 5 games.
    • Full ISBERD Unstub (SDK-Chan, Camille LaVey)
      • Notably, this fixes some minor graphical issues in M&L:Brothership and other titles
    • Add Revolt links alongside Discord (crueter)
    • Add X links alongside Discord and Revolt (Bix)
    • Avoid infinite kernel object loops (MaranBr)
      • Notably, this fixes certain sequences of actions in BotW, especially w.r.t shrines
    • Properly ignore comments in cheats (notenergydrinks)
    • Updated defaults and clarified description for Extended Dynamic State (Pavel, MaranBr)
    • Fix unsafe/safe memory processing logic (Torzu, Higgs, MaranBr)
      • Notably, this fixes Princess Peach, Ender Magnolia, M&L Brothership, Sonic X Shadow Generations, Borderlands 2, and more
    • Added separate DMA precision level option (MaranBr, crueter)
      • Notably, higher precision levels can enable games like Ender Magnolia to run on Normal GPU accuracy.
    • Host MMU Emulation/Fastmem configuration outside of Debug (MaranBr)
      • Generally, this isn't needed to be changed except on some BSDs
    • Option to disable NCA verification (Maufeat, crueter)
      • This enables many new updates--including SMO 1.4.x and Pokemon S/V 4.0.0--to install and run, when they previously couldn't.
      • Note that many updates such as those for BotW and TotK may still not work at this time.
    • Initial stubs for new firmware functions (Maufeat, Pavel)
      • This enables some games such as Hollow Knight: Silksong to run.
    • Properly ignore comments in cheats (notenergydrinks)
    • Add Revolt links alongside Discord (crueter)
    • Add X links alongside Discord and Revolt (Bix)
    • Avoid infinite kernel object loops (MaranBr)
      • Notably, this fixes certain sequences of actions in BotW, especially w.r.t shrines

    Renderer

    • Sample Shading (Gamer64)
      • Improves shader and image quality, but may affect performance.
      • Some setups have reported increased performance with higher values. Experiment and find what works for you.
    • MSAA Improvements (Mr. Purple)
      • Notably, this improves Civilization VII, as shown in the showcase channel
    • Various fixes to Vulkan and its extensions (crueter, Aleksandr, Camille LaVey)
      • ExtendedDynamicState and related extesnions were improperly applied (Aleksandr)
      • Vulkan pipeline didn't properly apply certain extensions and features (Aleksandr)
      • Many black screen issues have been fixed. If games didn't work in 0.0.1 or 0.0.2, please try again.
    • 0.25X resolution option (crueter)
    • Enabled trivial stencilling (Camille LaVey, Eden Contributors)
      • Notably fixes rift rendering in Echoes of Wisdom
    • Fixed NaN emissions in SPIR-V shader outputs (Camille LaVey, Eden Contributors)
      • Notable games fixed:
        • Black square issues in Fire Emblem: Three Houses and Tears of the Kingdom
        • Fire Emblem: Engage DLC maps
        • Shrines in Breath of the Wild
    • Mock return on bindless textures (xbzk)
      • Notably fixes Ender Magnolia's rendering on Android (high accuracy required)
    • Skip CPU Inner Validation (Gamer64)
      • This option increases performance, but may cause issues with stability.
    • Skip surface texture copy (Gamer64, Camille LaVey)
    • Improved Spir-V Output Optimization implementation (Gamer64, Camille LaVey, Torzu)
      • Most users will see the best results when setting this to "Never", however some users have noted improved performance after shaders build with it set to "On Load".
    • Native, hardware-accelerated cubic filtering (Lizzie)
    • Alpha Copy (Camille LaVey, Eden Contributors)
      • Notably fixes certain graphical glitches in Mario + Rabbids
    • Improved Spir-V casting for low-precision integers (Lizzie)
      • Notably improves flickering for certain unresolved texture conversions in Vulkan
    • Reduce Vulkan validation errors (wildcard)
    • Fixed critical Vulkan memory leaks (weakboson)
      • Notably, this fixes memory leaks and crashes in DB FighterZ, Dragon's Dogma, P5:Royal, Mario Strikers, Yoshi's Crafted World and others that previously required mods to avoid crashes
    • Disable unneeded debug options in Vulkan (crueter, wildcard)
      • Technically, this can improve performance, but the effect is marginal
    • Normalize single-layer TICs (Wildcard)
      • Notably, this fixes God Eater 3
    • Other incremental changes: (Wildcard, JPikachu, MaranBr)
      • Improved stencil handling
      • Improved master semaphore submits
      • Fix VertexInput handling
      • Improved memory allocations
        • Notably, this fixes slowdowns on Super Mario Odyssey on weaker hardware (incl. Steam Deck)

    Android

    • Support for various Game Hubs (fr this time) (Bix)
    • Improved Eden's Veil layout and language (Aleksandr)
    • Removed frameskip entirely while we work on it
    • Added option to utilize the native keyboard over the firmware keyboard (Aleksandr)
    • Added shader building to the performance overlay (Aleksandr)
    • Brought over several desktop settings (Aleksandr)
    • Public lobby viewer (Aleksandr)
    • Improved multiplayer support (crueter, Aleksandr)
    • Public lobby creation (Aleksandr)
    • Driver fetcher (Aleksandr, crueter)
      • Automatically recommends a driver depending on your device, and allows for instant download and install from various repositories.
    • Improve compatibility with older devices (crueter, Camille LaVey)
    • Improved translations (Pavel, Aleksandr, Rondo)
    • Device info overlay (crueter)
      • SoC, GPU, device models, firmware version
    • LRU cache improvements (Mr. Purple)
    • Firmware page in setup wizard (crueter)
    • Initial Serbian translation (Aleksandr)
    • Fixed off-by-one error with resolution values above 1x (Aleksandr)
    • Battery power draw and capacity overlay (Aleksandr, Pavel)
    • Warn on selection of resolutions higher than 1.5x (Aleksandr)
    • Landscape-only carousel view (xbzk)
    • Partial fix for bluetooth controller issues (Camille LaVey)
    • New app background (Anta)
    • Fix crash when launching a game referencing a now-deleted custom driver (Aleksandr)
    • Fix top bar clipping on certain devices (xbzk)
    • Add game search bar to landscape view (xbzk)
    • Release Fences Early option (crueter, Pavel)
      • This option fixes 0fps errors in certain titles, but may cause crashes and instability in others.
    • New app background (AntaBaka)
    • Optimized (Genshin Spoof) build (Bix)
    • EmuReady integration (Producdevity)
    • New UI Design (Producdevity)
      • The new default theme is the Eden theme, which uses Eden's official color palette alongside synthwave-style gradients.
    • GPU driver download from EmuReady (Producdevity)

    Desktop

    • Merged room functionality into the main executable/AppImage (Aleksandr)
    • Censor the username in debug logs (Aleksandr)
    • Added a Qlaunch command line option and the ability to create a shortcut (Aleksandr)
    • Minor UI improvements (crueter)
    • Add proper web token & web service support (Aleksandr, crueter)
      • You can now get real-time username and token verification, and no longer need to manually edit config files to play online.
    • Button to refresh the game list + add-ons (crueter)
    • AppImage now properly creates shortcuts (crueter)
    • Update Checker (crueter)
    • Improved migration frontend (crueter)
      • Internal NAND, mod, and SDMC folders now properly reference Eden after migration
      • Citron migration has been re-enabled
      • Increased performance and speed of large migrations
    • Firmware installation from zip (crueter)
    • Open specific folders (NAND, Mods, etc.) from the menu (crueter)
    • Links now point to existing webpages (crueter)
    • Fix app icon and AppImage metadata on Wayland (crueter)
    • Fix CUDA on Linux (MaranBr)
    • Fixed Windows icon aliasing and size (Lizzie)
    • Fix Windows styling (MaranBr, Maufeat, crueter)
    • Fixed controls dialog text clipping (crueter)
      • On Linux, the Dark theme may still clip if the controls window is forced to its minimum size.
      • We are still investigating this, however, deleting ~/.config/qt6ct may fix it.

    Known Issues

    • The latest updates to many games work intermittently, if at all.
      • In general, we recommend using the pre-Switch 2 versions. Most of the new updates cause black screens, ARM panics, or crashes.
      • Including these in your game directory shouldn't cause crashes, but we recommend avoiding them entirely for the time being.
    • Using firmware above 19.0.1 causes crashes in the Home Menu.
    • Decryption keys from 20.0.0 or newer cause some games to not be properly read or recognized.
    • EmuDeck messes with Eden's internal file structure.
      • Symlinking ~/.local/share/eden to EmuDeck's data directory is believed to fix this.
    • During migration on Windows, linking often hangs or fails.
      • This either requires the SeCreateSymbolicLink privilege, or to avoid it entirely.
      • We recommend move or copy for now.
    • Certain games crash upon opening the software keyboard applet on Android.
      • This can generally be fixed by changing it to use the custom frontend, via Advanced Settings -> Applets -> Software Keyboard.

    Internal

    • Several submodules were moved in-tree to reduce network load
      • During bisects, run git submodule deinit -f --all and git submodule update --init --recursive to update submodules properly.
    • Updated bundled dependencies and Qt (MaranBr)
    • FFmpeg 7.1.1 implementation (MaranBr, Maufeat, Jarrod Norwell)
    • FFmpeg code cleanup & proper configuration (MaranBr)
    • Improved parity between platforms (crueter, MaranBr, Shinmegumi)
    • Reduced duplicate code between Android and Desktop (crueter)
    • Sane build identification (crueter)
    • Improved GetBufferHistory (Maufeat, Jarrod Norwell)
    • Massively reduced fetch time for submodules
      • Nearly all submodules and externals, sans libusb, dynarmic, and very small in-tree libraries, have been moved to source archive downloads.
      • These are grabbed on-demand, as opposed to every single submodule being required by default.
      • Source archives are dramatically smaller in size than full Git clones; thus, overall clone/fetch time has decreased by a factor of ~10 on Windows and Linux (amd64) with 100Mbps download speed.
    • Source packs now include CPM cache and can be built fully offline.
      • Android cannot be built fully offline regardless due to gradlew, so source archives do not currently contain bundled Android dependencies.
    • vcpkg has been completely replaced by CPM (CMake Package Manager)
      • CPM is significantly faster, more consistent, and easier to use than vcpkg. This can help reduce headaches and configure/fetch time on Windows and Android.
      • CPM additionally allows for static builds of certain externals that were not previously possible; e.g. Boost, OpenSSL, and other libraries are now available statically, which marginally reduces Android APK, Windows zip, and Linux AppImage package sizes.
      • All system dependencies can additionally be managed by CPM as well; to enforce this, set YUZU_USE_CPM=ON (note that this will enforce bundled OpenSSL for the time being)
    • CMake dependency prefetching (crueter)
      • The dependency resolution system was rewritten to take in JSON files (cpmfile.json), where a script can be run to fetch dependencies before configure time.
      • Notably, this re-enables NixOS builds, and some other distributions with network sandboxes may see benefits from this.
    • Build & development documentation has been updated to match all of our new changes, and has generally been improved all-around
    • MicroProfile was removed (use samply/vtune instead)
    • Small compliance/performance improvements with fmt, ankerl, libstdc++, and more (Lizzie)
    • Unstubbed services and functions:
      • ZBCSetTable (Lizzie)
      • AllocObjCtx (SDK-Chan)
      • ISBERD (Internal Stage Buffer Entry ReaD) (SDK-Chan, Lizzie)
      • GPFIFOEX1 (SDK-Chan)
      • AdjustRefCount (Maufeat)

    Packages

    Desktop builds will automatically put data in ~/.local/share/eden on Linux, or
    %APPDATA%/eden on Windows. You may optionally create a user directory in the
    same directory as the executable/AppImage to store data there instead.

    Linux

    Linux packages are distributed via AppImage. Each build is optimized for a specific architecture.
    See the Description column for more info. Note that legacy builds will always work on newer systems.
    zsync files are provided for use with certain AppImage updaters.

    NOTE: Due to ongoing build/CI issues and lack of available hardware for testing, ARM builds of Linux will not be distributed for the time being. If you want to help our developers acquire ARM hardware, please donate!

    Warning

    By default, the AppImages enforce the xcb platform for Qt. Wayland causes a significant
    amount of issues that simply can't be solved on our end. You may change it to Wayland if you
    wish, but expect things to break. You will only receive limited support if using Wayland.

    Build Description
    amd64 (legacy) (zsync) For CPUs older than 2013 or so
    amd64 (zsync) For any modern AMD or Intel CPU
    Steam Deck (zsync) For Steam Deck and other >= Zen 2 AMD CPUs
    ROG Ally X (zsync) For ROG Ally X and other >= Zen 4 AMD CPUs
    aarch64 (WIP) For any 64-bit ARM CPU. Currently a work-in-progress.
    armv9-a (WIP) For any 64-bit ARM CPU made after late 2021 or so. Currently a work-in-progress.

    Windows

    Windows packages are in-place zip files.

    Build Description
    amd64 For any Windows machine running an AMD or Intel CPU
    arm64 (WIP) For any Windows machine running a Qualcomm or other ARM-based SoC. Currently a work-in-progress.

    Android

    Build Description
    Android Standard Single APK for all supported Android devices (most users should use this)
    Android Optimized For any Android device that has Frame Generation or any other per-device feature
    Android Legacy For A6xx. Fixes any games that work on newer devices but don't on Adreno 6xx

    Source

    Contains all source code, submodules, and CPM cache at the time of release.

    File Description
    tar.zst Source as a zstd-compressed tarball (Windows requires 7zip-zstd or Winrar)

    Other Platforms

    Other platforms, including FreeBSD, OpenBSD, Solaris (OpenIndiana), and macOS are
    able to be built from source, but are not available for download at this time.
    Stay tuned!

    Downloads
  • v0.0.3-rc3 7bfa2404a6

    Eden v0.0.3-rc3
    Some checks failed
    build.yml / [video_core] Improve DMA logic and add an option to sync memory operations (#276) (release) Failing after 0s
    Details
    trigger_release.yml / [video_core] Improve DMA logic and add an option to sync memory operations (#276) (release) Failing after 0s
    Details
    Stable

    ci released this 2025-11-12 02:51:27 +01:00 | 472 commits to master since this release

    This is the third release candidate for version 0.0.3. This RC is in feature-freeze, and is intended to help test upcoming features and fix any pertinent issues and bugs. All users are encouraged to test out this release and provide feedback/issue reports when applicable. In the meantime, if you prefer to have the most stable experience possible, you are likely better off waiting for the stable release.

    If this RC is deemed safe to release after the initial 1-week testing phase, it will be promoted to stable and distributed as the final 0.0.3 release. Otherwise, more candidates will be published, and after final tests are concluded and the last RC is marked ready for release, it will be promoted to stable and released as 0.0.3.

    We apologize for the delay in this RC. During our tests, many critical regressions popped up, and some took a long time to track down and fix. Additionally, a large quantity of long-standing build issues continued to pop up, and necessitated major rewrites to our build system. We hope that this candidate is ultimately promoted to stable 0.0.3 and its many fixes can be enjoyed by all.

    This release contains:

    • a critical fix for LAN connection issues,
    • several regressions fixes from Yuzu, 0.0.2, and RC1,
    • major new Vulkan and memory fixes,
    • and large-scale improvements to the build system and CI

    Regressions

    • Fixed certain RDNA3/Android graphics bugs, notably in TotK and BotW (Maufeat, Testers)
      • Notably, this fixes BotW, TotK, Shadow Generations, and other titles
    • Fixed LAN connection issues (Maufeat, Testers)
      • Some users have reported that this fixes LAN on MK8DX 3.0.5, but results have been inconsistent. We still recommend 3.0.3 for LAN play for now.
    • Fixed Release Fences Early option (Pavel)
    • Fix MSAA-related crashes in FE:Engage and other games (Maufeat)
    • Fixed LRU Cache on TotK 1.2.1 and other updates (wildcard)
    • Fixed sample shading, and added a slider for the intensity thereof (crueter, Wildcard)
      • This option has been shown to improve performance in some setups, contrary to what the tooltip says. Further testing is required to determine all of its effects, but for the time being, use it if you want to enjoy better shader quality.

    New Changes

    • Improved Solaris/FreeBSD compatibility (Lizzie, SDK-Chan, crueter)
    • Sync Memory Operations option (Higgs, MaranBr)
      • Notably, this fixes certain collection games, Abathor, Clock Tower Rewind, Guns of Fury, Ninja Five-O, and more
      • This option can decrease performance, though it's only believed to affect Unreal Engine 4 & 5 games.
    • Full ISBERD Unstub (SDK-Chan, Camille LaVey)
      • Notably, this fixes some minor graphical issues in M&L:Brothership and other titles
    • Fix Windows styling (MaranBr, Maufeat, crueter)
    • Fix unsafe/safe memory processing logic (Torzu, Higgs, MaranBr)
      • Notably, this fixes Princess Peach, Ender Magnolia, M&L Brothership, Sonic X Shadow Generations, Borderlands 2, and more
    • Properly ignore comments in cheats (notenergydrinks)
    • Updated Ukrainian translation (Rondo)
    • Android EmuReady integration (Producdevity)
      • This feature is in beta! We are adding it to this release candidate to get additional testing before its final form in 0.0.3
    • Android Redesign (Producdevity)
      • The new default theme is the Eden theme, which uses Eden's official color palette alongside synthwave-style gradients.
    • Reduce Vulkan validation errors (wildcard)
    • Fixed critical Vulkan memory leaks (weakboson)
      • Notably, this fixes memory leaks and crashes in DB FighterZ, Dragon's Dogma, P5:Royal, Mario Strikers, Yoshi's Crafted World and others that previously required mods to avoid crashes
    • Disable unneeded debug options in Vulkan (crueter, wildcard)
      • Technically, this can improve performance, but the effect is marginal
    • Add Revolt links alongside Discord (crueter)
    • Add X links alongside Discord and Revolt (Bix)
    • Avoid infinite kernel object loops (MaranBr)
      • Notably, this fixes certain sequences of actions in BotW, especially w.r.t shrines
    • FFmpeg updated to 7.1.1 on Linux (MaranBr)
    • Fix CUDA on Linux for NVidia (MaranBr)
    • Fixed Windows icon aliasing and size (Lizzie)
    • Normalize single-layer TICs (Wildcard)
      • Notably, this fixes God Eater 3

    Known Issues

    • Font scaling on the Linux AppImage is off on certain setups

    Known Games Fixed

    Click to open This is a partial list of games that are noted to be fixed or improved since v0.0.3-rc2. Special thanks to our tester, PistolaoBR, for compiling this list, and all of our other testers for their additional work in identifying critical bugs and testing large amounts of bugfixes. Most of these were tested on Nvidia, but had additional testing on Adreno and AMD.

    Force Closes

    These games previously force closed randomly, but are fixed by the Sync Memory Operations option regardless of accuracy:

    • Princess Peach
    • Ender Magnolia
    • Mario & Luigi Brothership
    • SONIC X SHADOW GENERATIONS
    • EA SPORTS FC25

    Booting

    These games previously did not boot or crashed early:

    • Collection games (neogeo, lunar, Gex, Hotline Miami, etc)
    • Abathor
    • Clock Tower Rewind
    • Guns of Fury
    • Ninja Five-O
    • The Walking Dead A New Frontier
    • Dead of Darkness
    • Ghost Trick Phantom Detective
    • S.T.A.L.K.E.R.
    • God Eater 3
    • Borderlands 2
      • This game only works with Sync Memory Operations on.
    • Cocoon

    Updates

    These games previously would not work with some of their updates applied:

    • Snufkin Melody of Moominvalley
    • Azure Striker Gunvolt Trilogy Enhanced
    • Witchroid Vania: A Magical Girl’s Fantastical Adventures
    • Sword of the Guardian
    • Crashlands
    • Cassette Beasts
    • Haven
    • BrokenSword Templars
    • Blazing Beaks
    • Mighty Goose
    • Potionomics: Masterwork Edition
    • Thronefall
    • Miraculous: Paris Under Siege
    • Storm Edge
    • While We Wait Here
    • Remnants of Naezith
    • Grapple Dogs Cosmic Canines
    • Across The Obelisk
    • Cult of the Lamb
    • Severed Steel
    • Noob - The Factionless
    • Romancing Saga 2
      • This game still has major lighting issues, however

    Internal

    The build system has been almost entirely overhauled:

    • Submodules and externals are now handled by CPM (CMake Package Manager) (crueter)
      • These are downloaded as source archives, not full git clones
      • These are grabbed on-demand, as opposed to every single submodule being required by default.
      • Source archives are dramatically smaller in size than full Git clones; thus, overall clone/fetch time has decreased by a factor of ~10 on Windows and Linux (amd64) with 100Mbps download speed.
      • Source packs include CPM cache and can be built fully offline.
        • Android cannot be built fully offline regardless due to gradlew, so source archives do not currently contain bundled Android dependencies.
    • vcpkg has also been replaced by CPM (crueter)
      • CPM is significantly faster, more consistent, and easier to use than vcpkg. This can help reduce headaches and configure/fetch time on Windows and Android.
      • CPM additionally allows for static builds of certain externals that were not previously possible; e.g. Boost, OpenSSL, and other libraries are now available statically, which marginally reduces Android APK, Windows zip, and Linux AppImage package sizes.
      • All system dependencies can additionally be managed by CPM as well; to enforce this, set YUZU_USE_CPM=ON (note that this will enforce bundled OpenSSL for the time being)

    Other changes:

    • Build & development documentation has been updated to match all of our new changes, and has generally been improved all-around
    • MicroProfile was removed (use samply/vtune instead)

    New Contributors

    • @elementary-particle
    • @NotAnEnergyDrinkAddict
    • Wildcard

    Packages

    Desktop builds will automatically put data in ~/.local/share/eden on Linux, or
    %APPDATA%/eden on Windows. You may optionally create a user directory in the
    same directory as the executable/AppImage to store data there instead.

    Linux

    Linux packages are distributed via AppImage. Each build is optimized for a specific architecture.
    See the Description column for more info. Note that legacy builds will always work on newer systems.
    zsync files are provided for use with certain AppImage updaters.

    NOTE: Due to ongoing build issues and lack of available hardware for testing, ARM builds of Linux will not be distributed for the time being. If you want to help our developers acquire ARM hardware, please donate!

    Warning

    By default, the AppImages enforce the xcb platform for Qt. Wayland causes a significant
    amount of issues that simply can't be solved on our end. You may change it to Wayland if you
    wish, but expect things to break. You will only receive limited support if using Wayland.

    Build Description
    amd64 (legacy) (zsync) For CPUs older than 2013 or so
    amd64 (zsync) For any modern AMD or Intel CPU
    Steam Deck (zsync) For Steam Deck and other >= Zen 2 AMD CPUs
    ROG Ally X (zsync) For ROG Ally X and other >= Zen 4 AMD CPUs
    aarch64 (WIP) For any 64-bit ARM CPU. Currently a work-in-progress.
    armv9-a (WIP) For any 64-bit ARM CPU made after late 2021 or so. Currently a work-in-progress.

    Windows

    Windows packages are in-place zip files.

    Build Description
    amd64 For any Windows machine running an AMD or Intel CPU
    arm64 (WIP) For any Windows machine running a Qualcomm or other ARM-based SoC. Currently a work-in-progress.

    Android

    Build Description
    Android Standard Single APK for all supported Android devices (most users should use this)
    Android Optimised For any Android device that has Frame Generation or any other per-device feature
    Android Legacy For A6xx. Fixes any games that work on newer devices but don't on Adreno 6xx

    Source

    Contains all source code, submodules, and CPM cache at the time of release.

    File Description
    tar.zst Source as a zstd-compressed tarball (Windows requires 7zip-zstd or Winrar)

    Other Platforms

    Other platforms, including FreeBSD, Solaris (OpenIndiana), and macOS are
    able to be built from source, but are not available for download at this time.
    Stay tuned!

    Downloads
  • v0.0.3-rc2 6c5adddac2

    Eden v0.0.3-rc2
    Some checks failed
    build.yml / Update src/video_core/vulkan_common/vulkan_wrapper.cpp (push) Failing after 0s
    Details
    trigger_release.yml / Update src/video_core/vulkan_common/vulkan_wrapper.cpp (push) Failing after 0s
    Details
    build.yml / Update src/video_core/vulkan_common/vulkan_wrapper.cpp (release) Failing after 0s
    Details
    trigger_release.yml / Update src/video_core/vulkan_common/vulkan_wrapper.cpp (release) Failing after 0s
    Details
    Stable

    ci released this 2025-11-12 02:40:40 +01:00 | 556 commits to master since this release

    This is the second release candidate for version 0.0.3. This RC is in feature-freeze, and is intended to help test upcoming features and fix any pertinent issues and bugs. All users are encouraged to test out this release and provide feedback/issue reports when applicable. In the meantime, if you prefer to have the most stable experience possible, you are likely better off waiting for the stable release.

    If this RC is deemed safe to release after the initial 1-week testing phase, it will be promoted to stable and distributed as the final 0.0.3 release. Otherwise, more candidates will be published, and after final tests are concluded and the last RC is marked ready for release, it will be promoted to stable and released as 0.0.3.

    Changelog

    This release fixes several major regressions regarding the JIT backend and Vulkan. Users that had issues with rc1 are highly encouraged to update.

    • Fixed games crashing on launch or failing to boot (crueter, Lizzie, MaranBr, Eden Testers)
    • Fixed SteamOS controllers not properly enumerating (crueter, Eden Testers)
    • Fixed gloom rendering issues in TotK (Camille LaVey, Maufeat)
    • Fixed RDNA3 rendering issues in various games (Maufeat, Eden Testers)
    • Enforce xcb platform on Qt frontend (crueter, Samueru, Eden Community)
    • Fixed Qt theming on Linux (Samueru)
    • Fixed SSL alpn implementation (Maufeat)
      • Notably, this fixes certain Jackbox games

    Packages

    Desktop builds will automatically put data in ~/.local/share/eden on Linux, or
    %APPDATA%/eden on Windows. You may optionally create a user directory in the
    same directory as the executable/AppImage to store data there instead.

    Linux

    Linux packages are distributed via AppImage. Each build is optimized for a specific architecture.
    See the Description column for more info. Note that legacy builds will always work on newer systems.
    zsync files are provided for use with certain AppImage updaters.

    Warning

    By default, the AppImages enforce the xcb platform for Qt. Wayland causes a significant
    amount of issues that simply can't be solved on our end. You may change it to Wayland if you
    wish, but expect things to break. You will only receive limited support if using Wayland.

    Build Description
    amd64 (legacy) (zsync) For CPUs older than 2013 or so
    amd64 (zsync) For any modern AMD or Intel CPU
    Steam Deck (zsync) For Steam Deck and other >= Zen 2 AMD CPUs
    ROG Ally X (zsync) For ROG Ally X and other >= Zen 4 AMD CPUs
    armv8-a (WIP) (zsync) For ARM CPUs made in mid-2021 or earlier
    armv9-a (WIP) (zsync) For ARM CPUs made in late 2021 or later

    Windows

    Windows packages are in-place zip files.

    Build Description
    amd64 For any Windows machine running an AMD or Intel CPU
    arm64 (WIP) For any Windows machine running a Qualcomm or other ARM-based SoC. Currently a work-in-progress.

    Android

    Build Description
    Android Standard Single APK for all supported Android devices (most users should use this)
    Android Optimized For any Android device that has Frame Generation or any other per-device feature
    Android Legacy For A6xx. Fixes any games that work on newer devices but don't on Adreno 6xx

    Source

    Contains all source code, git history, and branches at the time of release.

    File Description
    zip Source as a zip archive (all platforms)
    tar.zst Source as a zstd-compressed tarball (Windows requires 7zip)

    Other Platforms

    Other platforms, including FreeBSD, Solaris (OpenIndiana), and macOS are
    able to be built from source, but are not available for download at this time.
    Stay tuned!

    Downloads
  • v0.0.3-rc1 f33c1ca7c1

    Eden v0.0.3-rc1
    Some checks failed
    build.yml / [vk] Fix query cache leak on missed sync (#131) (push) Failing after 0s
    Details
    trigger_release.yml / [vk] Fix query cache leak on missed sync (#131) (push) Failing after 0s
    Details
    build.yml / [vk] Fix query cache leak on missed sync (#131) (release) Failing after 0s
    Details
    trigger_release.yml / [vk] Fix query cache leak on missed sync (#131) (release) Failing after 0s
    Details
    Stable

    ci released this 2025-11-12 02:37:32 +01:00 | 569 commits to master since this release

    Changelog

    This is the first release candidate for version 0.0.3. This RC is in feature-freeze, and is intended to help test upcoming features and fix any pertinent issues and bugs. All users are encouraged to test out this release and provide feedback/issue reports when applicable. In the meantime, if you prefer to have the most stable experience possible, you are likely better off waiting for the stable release.

    If this RC is deemed safe to release after the initial 1-week testing phase, it will be promoted to stable and distributed as the final 0.0.3 release. Otherwise, more candidates will be published, and after final tests are concluded and the last RC is marked ready for release, it will be promoted to stable and released as 0.0.3.

    Platforms

    Please note that platforms outside of Windows, Linux, and Android are still in an experimental state. You are unlikely to receive support unless you can provide useful debugging info.

    • Solaris/OpenIndiana support (Lizzie841)
    • Improved macOS support (crueter, Lizzie841, Maufeat)
    • FreeBSD Support (Lizzie841, SDK-Chan)

    Universal

    • JIT backend improvements (Lizzie841)
    • Improved Fast GPU time (crueter, Camille LaVey)
      • Higher overclock values increase resolution at the cost of performance
    • Fast CPU time option (crueter, Camille LaVey)
      • Overclocks the emulated CPU. May improve FPS caps in some games, but may also cause unwanted speedups or performance drops.
    • Fixed FMV greenscreens on all platforms (MaranBr, Maufeat, Shinmegumi)
    • Hardware-accelerated video decoding for h264, VP8, and VP9 on all supported GPUs and platforms (MaranBr)
    • Fixed Mario Kart 8 Deluxe controller applet freeze (MaranBr, Pavel)
    • Fixed crashes when attempting to read or apply new Switch 2 compatibility updates (crueter, Pavel)
    • Battery status in the Switch Home Menu (Maufeat)
    • Area Sampling filter (JPikachu, Torzu, crueter)
      • This option is best served when using a resolution higher than your display's resolution.
    • Stubbed ActivateDebugMouse for Gex Trilogy (Pavel)
    • Improved avatar selection and editing within firmware (Maufeat, Torzu)
    • Airplane Mode implementation (Maufeat, crueter)
      • Certain games "phone home" by default, and require airplane mode to be enabled to play.
    • Custom CPU Tick option (Gamer64, crueter)
      • Changes emulated CPU's ticks, can improve performance at the cost of stability.
    • Toggle for Vulkan RAII (Pavel)
      • Disabling this option may increase memory and CPU utilization, but may also fix issues with bundled games or on exit/activity switching.
    • More descriptive error messages for many actions (crueter)
    • Firmware version/validity checks (crueter)
      • If you install supported firmware, e.g. 19.0.1, and the app tells you your firmware is too new, then your firmware is likely corrupted or missing important files. Redump and try again.
    • Sane(r) default configuration (crueter)
    • Fixed Player 2 controller disconnect in DKC Tropical Freeze (MaranBr)
    • Implemented firmware profile editor (Maufeat, Torzu)
      • Added support for creating and deleting users via the HOME menu
      • Enabled reordering user positions in the HOME menu
      • Fixed profile picture editor in the HOME menu
      • Added support for various profile picture formats (PNG, JPEG, BMP)

    Renderer

    • Sample Shading (Gamer64)
      • Improves shader and image quality, but may slightly reduce performance.
    • MSAA Improvements (Mr. Purple)
      • Notably, this improves Civilization VII, as shown in the showcase channel
    • Various fixes to Vulkan and its extensions (crueter, Aleksandr, Camille LaVey)
      • ExtendedDynamicState and related extesnions were improperly applied (Aleksandr)
      • Vulkan pipeline didn't properly apply certain extensions and features (Aleksandr)
      • Many black screen issues have been fixed. If games didn't work in 0.0.1 or 0.0.2, please try again.
    • 0.25X resolution option (crueter)
    • Enabled trivial stencilling (Camille LaVey, Eden Contributors)
      • Notably fixes rift rendering in Echoes of Wisdom
    • Fixed NaN emissions in SPIR-V shader outputs (Camille LaVey, Eden Contributors)
      • Notable games fixed:
        • Black square issues in Fire Emblem: Three Houses and Tears of the Kingdom
        • Fire Emblem: Engage DLC maps
        • Shrines in Breath of the Wild
    • Mock return on bindless textures (xbzk)
      • Notably fixes Ender Magnolia's rendering on Android (high accuracy required)
    • Skip CPU Inner Validation (Gamer64)
      • This option increases performance, but may cause issues with stability.
    • Skip surface texture copy (Gamer64, Camille LaVey)
    • Improved Spir-V Output Optimization implementation (Gamer64, Camille LaVey, Torzu)
      • Most users will see the best results when setting this to "Never", however some users have noted improved performance after shaders build with it set to "On Load".
    • Native, hardware-accelerated cubic filtering (Lizzie)
    • Alpha Copy (Camille LaVey, Eden Contributors)
      • Notably fixes certain graphical glitches in Mario + Rabbids
    • Improved Spir-V casting for low-precision integers (Lizzie)
      • Notably improves flickering for certain unresolved texture conversions in Vulkan

    Android

    • Support for various Game Hubs (fr this time) (Bix)
    • Improved Eden's Veil layout and language (Aleksandr)
    • Removed frameskip entirely while we work on it
    • Added option to utilize the native keyboard over the firmware keyboard (Aleksandr)
    • Added shader building to the performance overlay (Aleksandr)
    • Brought over several desktop settings (Aleksandr)
    • Improved multiplayer frontend (crueter, Aleksandr)
      • Public lobby creation
      • Public lobby viewer
      • Real-time verification of room metadata
      • Automatic IP setter
    • Driver fetcher (Aleksandr, crueter)
      • Automatically recommends a driver depending on your device, and allows for instant download and install from various repositories.
    • Improve compatibility with older devices (crueter, Camille LaVey)
    • Improved translations (Pavel, Aleksandr, Rondo)
    • Device info overlay (crueter)
      • SoC, GPU, device models, firmware version
    • LRU cache improvements (Mr. Purple)
    • Firmware page in setup wizard (crueter)
    • Initial Serbian translation (Aleksandr)
    • Fixed off-by-one error with resolution values above 1x (Aleksandr)
    • Battery power draw and capacity overlay (Aleksandr, Pavel)
    • Warn on selection of resolutions higher than 1.5x (Aleksandr)
    • Landscape-only carousel view (xbzk)
    • Partial fix for bluetooth controller issues (Camille LaVey)
    • New app background (Anta)
    • Fix crash when launching a game referencing a now-deleted custom driver (Aleksandr)
    • Fix top bar clipping on certain devices (xbzk)
    • Add game search bar to landscape view (xbzk)
    • Release Fences Early option (crueter, Pavel)
      • This option fixes 0fps errors in certain titles, but may cause crashes and instability in others.
    • New app background (AntaBaka)
    • Optimized (Genshin Spoof) build (Bix)

    Desktop

    • Merged room functionality into the main executable/AppImage (Aleksandr)
    • Censor the username in debug logs (Aleksandr)
    • Added a Qlaunch command line option and the ability to create a shortcut (Aleksandr)
    • Minor UI improvements (crueter)
    • Add proper web token & web service support (Aleksandr, crueter)
      • You can now get real-time username and token verification, and no longer need to manually edit config files to play online.
    • Button to refresh the game list + add-ons (crueter)
    • AppImage now properly creates shortcuts (crueter)
    • Update Checker (crueter)
    • Improved migration frontend (crueter)
      • Internal NAND, mod, and SDMC folders now properly reference Eden after migration
      • Citron migration has been re-enabled
      • Increased performance and speed of large migrations
    • Firmware installation from zip (crueter)
    • Open specific folders (NAND, Mods, etc.) from the menu (crueter)
    • Links now point to existing webpages (crueter)
    • Fix app icon and AppImage metadata on Wayland (crueter)

    Known Issues

    • The latest updates to many games work intermittently, if at all.
      • In general, we recommend using the pre-Switch 2 versions. Most of the new updates cause black screens, ARM panics, or crashes.
      • Including these in your game directory shouldn't cause crashes, but we recommend avoiding them entirely for the time being.
    • Using firmware above 19.0.1 causes crashes in the Home Menu.
    • Decryption keys from 20.0.0 or newer cause some games to not be properly read or recognized.
    • EmuDeck messes with Eden's internal file structure.
      • Symlinking ~/.local/share/eden to EmuDeck's data directory is believed to fix this.
    • During migration on Windows, linking often hangs or fails.
      • This either requires the SeCreateSymbolicLink privilege, or to avoid it entirely.
      • We recommend move or copy for now.
    • Certain games crash upon opening the software keyboard applet on Android.
      • This can generally be fixed by changing it to use the custom frontend, via Advanced Settings -> Applets -> Software Keyboard.

    Internal

    • Several submodules were moved in-tree to reduce network load
      • During bisects, run git submodule deinit -f --all and git submodule update --init --recursive to update submodules properly.
    • Updated bundled dependencies and Qt (MaranBr)
    • FFmpeg 7.1.1 implementation (MaranBr, Maufeat, Jarrod Norwell)
    • FFmpeg code cleanup & proper configuration (MaranBr)
    • Improved parity between platforms (crueter, MaranBr, Shinmegumi)
    • Reduced duplicate code between Android and Desktop (crueter)
    • Improved build documentation & scripting (crueter, Lizzie)
    • Sane build identification (crueter)
    • Improved GetBufferHistory (Maufeat, Jarrod Norwell)
    • Improved build documentation and scripting (Lizzie, crueter)
    • Unstubbed services and functions:
      • ZBCSetTable (Lizzie)
      • AllocObjCtx (SDK-Chan)
      • ISBERD (Internal Stage Buffer Entry ReaD) (Lizzie)
      • GPFIFOEX1 (SDK-Chan)
      • AdjustRefCount (Maufeat)

    New Contributors

    Returning Contributors

    Special Thanks

    • Bix for providing Git hosting in the absence of a VPS
    • samueru & pflyly for CI assistance
    • (Not) crueter's ISP for bandwidth limiting him 🥀
    • Everyone who has donated to us
    • Our wonderful testers!
    • AYANEO for providing Camille, Mr. Purple, and crueter devices to test & provide support for

    Packages

    Desktop builds will automatically put data in ~/.local/share/eden on Linux, or
    %APPDATA%\eden on Windows. You may optionally create a user directory in the
    same directory as the executable/AppImage to store data there instead.

    Linux

    Linux packages are distributed via AppImage. Each build is optimized for a specific architecture.
    See the Description column for more info. Note that legacy builds will always work on newer systems.
    zsync files are provided for use with certain AppImage updaters.

    Build Description
    amd64 (legacy) (zsync) For CPUs older than 2013 or so
    amd64 (zsync) For any modern AMD or Intel CPU
    Steam Deck (zsync) For Steam Deck and other >= Zen 2 AMD CPUs
    ROG Ally X (zsync) For ROG Ally X and other >= Zen 4 AMD CPUs
    armv8-a (WIP) (zsync) For ARM CPUs made in mid-2021 or earlier
    armv9-a (WIP) (zsync) For ARM CPUs made in late 2021 or later

    Windows

    Windows packages are in-place zip files.

    Build Description
    amd64 For any Windows machine running an AMD or Intel CPU
    arm64 (WIP) For any Windows machine running a Qualcomm or other ARM-based SoC. Currently a work-in-progress.

    Android

    Build Description
    Android Standard Single APK for all supported Android devices
    Android Optimized For any Android device that has Frame gen or any other per-device feature
    Android Legacy For A6xx. Fixes any games that work on newer device but don't on Adreno 6xx

    Source

    Contains all source code, git history, and branches at the time of release.

    File Description
    zip Source as a zip archive (all platforms)
    tar.zst Source as a zstd-compressed tarball (Windows requires 7zip)

    Other Platforms

    Other platforms, including FreeBSD, Solaris (OpenIndiana), and macOS are
    able to be built from source, but are not available for download at this time.
    Stay tuned!

    Downloads