Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/eden-emulator/mirror/llms.txt

Use this file to discover all available pages before exploring further.

Eden is a free and open-source Nintendo Switch (Switch 1) emulator derived from Yuzu and Sudachi, started by developer Camille LaVey. Written in C++ with portability in mind, Eden runs on Windows, Linux, macOS, Android, FreeBSD, and more — bringing Switch games to the platform of your choice.
Eden requires firmware and decryption keys obtained from your own Nintendo Switch console. These files cannot be provided by the project. See Quick Start for instructions on installing them.

Key features

  • Runs most commercial Switch games at full speed on supported hardware
  • Supports Vulkan and OpenGL rendering backends
  • Native Code Execution (NCE) on Android and Linux for ARM64 devices
  • Multiplayer via LDN-based local wireless tunneling over the internet
  • Mod, cheat code, and save management
  • Portable mode: store all data in a local user folder alongside the executable
  • Builds available for Windows, Linux, macOS, Android, FreeBSD, HaikuOS, and more

Hardware requirements

Eden is demanding on hardware and requires a mid-range system or better. Linux with AMD (RADV) drivers consistently provides the best desktop performance. On AMD64 systems, the CPU is often the bottleneck rather than the GPU. For Android, Qualcomm Snapdragon SoCs with Adreno 6xx or 7xx GPUs are the most well supported.

Release types

Eden publishes four types of builds:
ReleaseStabilityWho it’s for
StableHighestAverage users. Low regressions, focused on reliability.
NightlyModerateUsers who want daily updates and critical game fixes. Built ~2 PM UTC when changes are present.
MasterLowContributors and testers. Straight-from-development builds, may be unstable.
PR buildsExperimentalTesters evaluating specific pull requests. May not build or run at all.
For most users, Stable is recommended. If a game doesn’t work on Stable, try Nightly for the latest fixes.

Configuration directories

Eden stores its configuration files in platform-specific locations:
PlatformDirectory
Windows%AppData%\Roaming
Linux, macOS, FreeBSD, Solaris, OpenBSD$XDG_DATA_HOME, $XDG_CACHE_HOME, $XDG_CONFIG_HOME
AndroidStored internally
HaikuOS/boot/home/config/settings/eden
If a user directory exists in the same folder as the Eden executable, it overrides all global configuration paths — enabling fully portable mode.

Explore the documentation

Quick Start

Install Eden and play your first game on Windows or Steam Deck.

Download and install

Get the right build for your platform and learn how to install it.

Configuration

Configure graphics, audio, controllers, and advanced settings.

Multiplayer

Play online with friends using LDN-based wireless tunneling.

Platforms and architectures

Platform-specific notes for Windows, Linux, Android, macOS, and BSD.

Troubleshooting

Fix launch failures, graphics issues, and other common problems.

Build docs developers (and LLMs) love