eden-emulator/Releases v0.0.4-rc1

Eden v0.0.4-rc1

on GitHub

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
  • For more information, see the User handbook
• 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.
  • If you wish to translate, go to our Transifex page
• 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.

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.

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

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.

Windows

Windows packages are in-place zip files.

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.

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

Android

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.

Source

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