Command Line arguments
PPSSPP has a bunch of command line arguments, that are not documented very well elsewhere, so let's do it here.
Some arguments, like the window management ones, have no effect on mobile or other non-desktop devices, of course.
How to run PPSSPP with command line arguments on Android
This can be useful from launchers and similar. Arguments go in the string extra org.ppsspp.ppsspp.Args. Here's an example ADB command line that boots a game and exits PPSSPP when the game ends. The URI is one copied with Copy deep link in the game's ... menu:
adb shell 'am start -S -n org.ppsspp.ppsspp/org.ppsspp.ppsspp.PpssppActivity -a android.intent.action.VIEW -d "content://com.android.externalstorage.documents/tree/primary%3APSP/document/primary%3APSP%2FRidge%20Racer.iso" --es org.ppsspp.ppsspp.Args --pause-menu-exit'
See Front end integration on Android for launcher configuration, and which URIs work.
Generally supported command line arguments
-d
Sets the log level to debug
-v
Sets the log level to verbose
-j, -i, -r, -J
Sets the CPU backend to JIT, Interpreter, IR Interpreter or JIT IR, respectively.
From PPSSPP 1.21 (and current development builds), these are replaced by --cpu=jit, --cpu=interpreter, --cpu=ir and --cpu=jit-ir. The old forms give an error, and -r now means --root.
--pause-menu-exit
PPSSPP exits when the game ends, instead of going to its menu. The "Exit to menu" choice on the pause menu becomes "Exit", and quitting the game from inside it, or dismissing a load error, also exits. This is most useful for frontends that also pass a file to launch. Before PPSSPP 1.21, only the pause menu choice exited.
--escape-exit
The escape key (or whatever key you have mapped to pause) will exit the emulator immediately.
--fullscreen
Forces full screen mode, ignoring saved configuration.
--windowed
Forces windowed mode, ignoring saved configuration.
--log=FILE, --loglevel=N, --state=FILE, --root=DIR
Write the log to FILE, set the log level, load a savestate from FILE on boot, and mount a directory as the root of host0:/.
More options in PPSSPP 1.21
From PPSSPP 1.21 (and current development builds), all platforms share one command line parser, and --help lists every option (except on Windows, where PPSSPP has no console to print to). Some new ones that can be handy:
--memstick=DIR- use DIR as the memory stick.--resolution-scale=N,--msaa=N- override the rendering resolution and MSAA level (0 = off, 1 = 2x, 2 = 4x, 3 = 8x) for this run.--cpu-mhz=N- lock the emulated CPU clock (0 = let the game set it).--vsh- boot the XMB.--debugger=PORT- enable the WebSocket debugger on this port.
Development arguments
These are a bit esoteric and not that useful for end users.
--gamesettings
Go directly to settings.
--touchscreentest
Go directly to the touchscreentest screen
From PPSSPP 1.21 (and current development builds), these two are replaced by --start-screen=gamesettings and --start-screen=touchscreentest (--start-screen=developertools also works).
--appendconfig
Merge a different config file into the current configuration, as in --appendconfig=FILE.ini.
Windows-only command line arguments
Some of these will be gneralized at some point.
-l
Enables the Log Console (same as Debug -> Log console in the menu)
-s
Prevent settings from being saved. Also disables auto-run. Kind of a weird one??
--graphics=directx11, --graphics=vulkan, --graphics=gles, --graphics=software
Enforces this GPU backend.
From PPSSPP 1.21 (and current development builds), --graphics= also accepts d3d11, opengl and, on Mac and iOS, metal.