Command-line support

From PCSX2 Wiki
Revision as of 23:53, 8 December 2014 by DoctorMuerte (talk | contribs)
Jump to navigation Jump to search

PCSX2 versions 0.9.7 and higher have full commandline support, announced on The return of the Commandline! blog entry. This means you can activate certain options when launching pcsx2.exe from the command line on Windows, or the terminal on a Linux environment, those options are called arguments, wich are described below.

Command line arguments can be added to a shortcut. That means you can have as many shortcuts to pcsx2.exe with different options and settings as you like.

Lightbulb.png Tip:
If you have different games that need different emulation settings and plugins configuration, you can make as many shortcuts as you need with custom settings.


You use the following format:

pcsx2.exe "IsoFile" --option="value"


  • IsoFile is the image file of the PS2 to be loaded. Remember to include full path between ( " ) and the file extension.
  • --option is the argument used to active a certain option. Read below for the full list.
  • value determines certain parameters needed for some options. Should be included betwen (") and follow a (=) symbol.

Example: c:\PCSX2\pcsx2.exe "c:\PS2\Final Fantasy X.iso" --fullscreen --cfgpath="c:\My Configs\FFX"

In this example, PCSX2 is going to open Final Fantasy X, run it on full screen, and the plugin configuration files are going to he loaded from the folder specified folder, in this case: c:\My Configs\FFX.

Options list

The full list of options are:

General Options

  • --cfgpath=[dir] {changes the configuration file path}
  • --cfg=[file] {specifies the PCSX2 configuration file to use}
  • --forcewiz {forces PCSX2 to start the First-time Wizard}
  • --portable {enables portable mode operation (requires admin/root access)}
  • --console {forces the program log/console to be visible}
  • --fullscreen {use fullscreen GS mode}
  • --windowed {use windowed GS mode}
  • --nogui {disables display of the gui while running games}
  • -h, --help {displays this list of command line options}

Auto-Run Options

  • --elf=[file] {executes an ELF image}
  • --nodisc {boots an empty dvd tray; use to enter the PS2 system menu}
  • --usecd {boots from the CDVD plugin (overrides IsoFile parameter)}

Compatibility Options

  • --nohacks {disables all speedhacks}
  • --gamefixes=[fix,fix] {Enable specific gamefixes for this session. Valid fixes are: VuAddSub,VuClipFlag,FpuCompare,FpuMul,FpuNeg,EETiming,SkipMpeg,OPHFlag,DMABusy,VIFFIFO,VI,FMVinSoftware}
  • --fullboot {disables fast booting}

Plugin Overrides

  • --gs=[dllpath] {specify the file to use as the GS plugin}
  • --pad=[dllpath] {specify the file to use as the PAD plugin}
  • --spu2=[dllpath] {specify the file to use as the SPU2 plugin}
  • --cdvd=[dllpath] {specify the file to use as the CDVD plugin}
  • --usb=[dllpath] {specify the file to use as the USB plugin}
  • --fw=[dllpath] {specify the file to use as the FW plugin}
  • --dev9=[dllpath] {specify the file to use as the DEV9 plugin}

Commandline options and shortcuts

The ordinary user may use this to create a shortcut to his/her game on the desktop so that PCSX2 will run the game immediately. To do this make a link to PCSX2 main executable (pcsx2.exe) and update the target field of this link, it will look something like:

"C:\PS2\pcsx2.exe" -skipbios "C:\PS2\yourgame.iso"

And thus you'll be able to start C:\PS2\yourgame.iso right from your desktop!

Commandline options and Steam

Commandline options and XBMC