Skip to content

Command Line Flags

You can launch pcsx-redux with the following command line parameters:

The parsing code doesn't care about the number of dashes in the parameter's flag, so '-' can be used as well as '--', or any number of dashes.

Flag Meaning
-dumpproto Dump the protobuf schemas for PCSX-Redux on stdout and exit immediately.
-run Begin execution immediately on startup.
-stdout Redirect log output to stdout.
-lua_stdout Redirect Lua's console output to stdout.
-logfile Specify a file to log output to.
-bios Specify a BIOS file.
-testmode Interpret internal API's pcsx_exit() command as a request to exit the emulator instead of pausing, and close the emulator. Implies -safe, -no-gui-log, and will also disable first chance exceptions. Use only when doing unit testing.
-exe Load a PSX exe.
-loadexe Load a PSX exe.
-iso Load a PSX disk image (iso, bin/cue).
-loadiso Load a PSX disk image (iso, bin/cue).
-memcard1 Specify a memory card file to use as memory card slot 1.
-memcard2 Specify a memory card file to use as memory card slot 2.
-pcdrv Enable the pcdrv device interface. (Access PC filesystem through SIO).
-pcdrvbase Specify base directory for pcdrv.
-safe Resets configuration to defaults.
-resetui Resets the UI to its defaults.
-kiosk Enables kiosk mode, disabling UI interaction. Will change the saved setting.
-no-kiosk Disables kiosk mode, allowing the user to interact with the UI. Will change the saved setting.
-interpreter Use the interpreter CPU core.
-dynarec Use the dynamic recompiler CPU core.
-debugger Activates the debugger. Will change the saved setting.
-no-debugger Deactivates the debugger. Will change the saved setting.
-fastboot Skips the BIOS logo and boot animation. Will change the saved setting.
-no-fastboot Shows the BIOS logo and boot animation. Will change the saved setting.
-gdb Activates the gdb server. Will change the saved setting.
-no-gdb Deactivates the gdb server. Will change the saved setting.
-gdb-port Sets the TCP port the gdb server is listening on. Will change the saved setting.
-trace Activates the CPU trace logging. Will change the saved setting.
-no-trace Deactivates the CPU trace logging. Will change the saved setting.
-no-gui-log Fully disables logs to be sent to the GUI.
-archive Specifies a .zip file to load for the Support.extra.dofile function.
-dofile Specifies a Lua file to load through the Support.extra.dofile function.
-exec Specifies a Lua string to execute.
-luacov Enables Lua code coverage report. Requires the luacov Lua module to be installed.
-portable Enables portable mode. Settings and saves will be stored in the same directory as the executable, or in the directory specified by the optional argument to this flag.