Command-line support: Difference between revisions

You can specify certain options when launching ''pcsx2.exe'' from the command-line under Windows, or the terminal in Linux environment. This guide will give you the list of these options.

PCSX2 versions 0.9.7 and higher have full command-line support, announced on [http://pcsx2.net/developer-blog/198-the-return-of-the-commandline.html The return of the Commandline!] blog entry.

The following format can be used to launch PCSX2:

:pcsx2.exe "'''IsoFile'''" --'''OptionName'''="'''OptionParameter'''" --'''Option2Name'''="'''Option2Parameter'''" ...

* '''IsoFile''' is the image file of the PS2 to be loaded (with full path and extension).

* '''OptionName''' specifies the option to be activated.

* '''OptionValue''' is used for the options that require some additional parameters. Do not forget to include these parameters inside quote signs ('''"''').

Example:<br />

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

The ISO file ''Final Fantasy X.iso'' will be launched in full screen mode automatically after PCSX2 is started. The plugin configuration files will to be loaded from the specified folder (''c:\My Configs\FFX'').

{{Tip|It is possible to make a short-cut with predefined command-line parameters and place in on desktop to launch your current PS2 game directly from your desktop.}}

Note that you can only specify ISO image name in the first command-line option. But you can also skip ISO image name altogether and, for instance, use ''--usecd'', ''--nodisk'' or ''--elf="'''ELFFileName'''"'' options.

At this time you can only use the following options:

==General Options==

* ''--cfgpath="'''Path'''"'': Specifies the configuration files path.

* ''--cfg="'''CFGFile'''"'': Specifies the PCSX2 configuration file to use.

* ''--forcewiz'': Forces PCSX2 to start in the ''first time wizard'' mode.

* ''--portable'': Enables portable mode to store ini and cfg the data to local PCSX2 paths instead of current user's documents path (This requires admin/root access).

* ''--console'': Forces PCSX2 ''log console'' to be visible.

* ''--fullscreen'': Starts in fullscreen mode.

* ''--windowed'': Starts in windowed mode (default).

* ''--nogui'': Disables display of the graphical user interface (you can combine it with ''--fullscreen'' when loading an ISO file, so PCSX2 presence will be hidden from the user)

* ''-h'' or ''--help'': Displays full list of command-line options (this list).

==Auto-run Options==

* ''--elf="'''ELFFile'''"'': Executes the specified ELF image on start.

* ''--nodisc'': Boots PS2 BIOS without DVD image; It is usedful to enter the PS2 system menu.

* ''--usecd'': Boots from the CDVD plugin on start (overrides '''IsoFile''' parameter). You can use this option to play directly from your DVD but you will need to set up CDVD plugin first.

 

 

* ''--dev9="'''DLLpath'''"'': Specifies the file to use as the DEV9 plugin.

The ordinary user may use this to create a shortcut to his/her game on the desktop so that PCSX2 will run without showing PCSX2 GUI at all. To do this make a link to PCSX2 main executable (pcsx2.exe) and update the '''target''' field of this link to something like this ''"C:\PS2\pcsx2.exe" -skipbios "C:\PS2\yourgame.iso"''.

Now you are able to start '''C:\PS2\yourgame.iso''' right from your desktop!