eden-miror/docs/user/CFW.md
lizzie 300a646a34
Some checks are pending
tx-src / sources (push) Waiting to run
Check Strings / check-strings (push) Waiting to run
[hle] make HBLoader work, add -hlaunch option (#3981)
hbloader is required to launch a bunch of shit (particularly hbmenu)

however due to some restrictive metadata validation, it doesn't get recognized as an NSP file

programs like hbmenu require hbloader (since it feeds them data like ConfigEntries and whatnot), launching hbmenu as-is standalone will result in a launchInit() error

adds an option to launch hbmenu via command line

Signed-off-by: lizzie <lizzie@eden-emu.dev>
Reviewed-on: https://git.eden-emu.dev/eden-emu/eden/pulls/3981
Reviewed-by: Maufeat <sahyno1996@gmail.com>
Reviewed-by: crueter <crueter@eden-emu.dev>
2026-05-19 23:35:53 +02:00

821 B

User Handbook - Custom Firmware (CFW)

At the moment of writing, we do not support CFW such as Atmosphere, due to:

  • Lacking the required LLE emulation capabilities to properly emulate the full firmware.
  • Lack of implementation on some of the key internals.
  • Nobody has bothered to do it (PRs always welcome!)

We do however, maintain HLE compatibility with the former mentioned CFW, applications that require Atmosphere to run will run fine in the emulator without any adjustments.

If they don't run - then that's a bug!

Atmosphere

Fusee Galee, the bootloader and other low-level mechanisms are not emulated at the moment.

Having OFW is recommended, but may not be required (untested).

Extract the contents of Atmosphere into sdmc. Then to launch simply use -hlaunch instead (orthogonal to -qlaunch).