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

• Aleksandr Popovich (Lime3DS)
• @Lizzie841
• @MaranBr
• @Shinmegumi
• @allisonbzk
• Rondo (translating)
• @Maufeat
• @Gamer64ytb (Mandarine3DS)
• SDK-Chan
• @jarrodnorwell (Sudachi)

Returning Contributors

• @CamilleLaVey
• @crueter
• @Bixbr
• @MrPurple666
• @pavelbarabanov
• @JPikachu
• @AntaBaka02

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.

Windows

Windows packages are in-place zip files.

Android

Source

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

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!