eden-miror/docs/user/CommandLine.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

1.6 KiB

User Handbook - Command Line

There are two main applications, an SDL-based app (eden-cli) and a Qt based app (eden); both accept command line arguments.

eden

  • ./eden <path>: Running with a single argument and nothing else, will make the emulator look for the given file and load it, this behaviour is similar to eden-cli; allows dragging and dropping games into the application.
  • -g <path>: Alternate way to specify what to load, overrides. However let it be noted that arguments that use - will be treated as options/ignored, if your game, for some reason, starts with -, in order to safely handle it you may need to specify it as an argument.
  • -f: Use fullscreen.
  • -u <number>: Select the index of the user to load as.
  • -input-profile <name>: Specifies input profile name to use (for player #0 only).
  • -qlaunch: Launch QLaunch.
  • -hlaunch: Launch homebrew launcher nx-hbloader.
    • Requires a copy of Atmosphere to be extracted onto sdmc.
    • This is a shorthand for <eden folder>/sdmc/atmosphere/hbl.nsp.
  • -setup: Launch setup applet.

eden-cli

  • --debug/-d: Enter debug mode, allow gdb stub at port 1234
  • --config/-c: Specify alternate configuration file.
  • --fullscreen/-f: Set fullscreen.
  • --help/-h: Display help.
  • --game/-g: Specify the game to run.
  • --multiplayer/-m: Specify multiplayer options.
  • --program/-p: Specify the program arguments to pass (optional).
  • --user/-u: Specify the user index.
  • --version/-v: Display version and quit.
  • --input-profile/-i: Specifies input profile name to use (for player #0 only).