Skip to main content

Command Line Parameters

Compatibility Matrix

CommandMediEvilSyphon Filter V1.00Syphon Filter V1.01Syphon Filter 2 V1.00Legend of Dragoon V1.00Ridge Racer R4 V1.00Syphon Filter 3 V1.03Legend of Dragoon V1.02Ridge Racer R4 V1.01Syphon Filter 2 V1.01Syphon Filter V1.03Phantom Menace V1.00Rally Cross V1.00Jet Moto 2 V1.00
--50hz-to-60hz-conversion-enabled
--[msw]-
--[ps4]-
--[ps4pro]-
--[ps5]-
--[sce]-
--agerestrict
--antial
--antialias
--app-artifacts-dir
--app-dir
--app-volume
--apply-scanout-half-pixel-shift
--assets-dir
--autokill
--automated
--biH
--bios
--bios-dir
--bios-hide-sce-osd
--boot-disc-id
--boot-script
--brightness
--budget-timeline
--cdrom-base-seek
--cdrom-cache-mode
--cdrom-cmd-time
--cdrom-fake-slow-async-read
--cdrom-max-seek
--cdrom-pause-timing
--clamp-line-thickness-max
--clamp-line-thickness-min
--clear-vram-video-mode-switch
--cmaa-max-height
--cmaa-max-width
--config
--config-local-dir
--configpath
--contrast
--ctlanalog
--cwd-dir
--defer-linked-dma-irq
--deterministic
--disable-maskpixel
--drawrect-fill-hack
--enable-change-disc-ui
--enable-user-color-adjustment
--enable-user-psp-right-stick-remapping
--enable-user-smc-check
--force-modchip-check
--force-pad-connect
--force-pad-disconnect
--gamedata-dir
--gamma
--gamma-correction
--git-rev-gamedata
--globalgamedata-dir
--gpu-24-bit-color
--gpu-headless-render-size
--gpu-scanout-fps-override
--gpu-scanout-fps-override-ntsc
--gpu-scanout-fps-override-pal
--grandia-gpu-hack
--graph-fps-resolution
--guncon
--has-shown-start-select-help
--hid
--horiz-sync-tear-allowance
--host-audio
--host-player%d-controller
--host-snapshot-dir
--hue
--id-engine
--image
--image%d
--image-dir
--imageName%d
--legacy-force-analog
--libcry
--libcrypt
--load-scripts
--locale
--maskpixel-mode
--mcH
--mcd-export
--mcd-export-dir
--mcd0
--mcd1
--mdec-dma-period%d
--metal-gear-solid
--mtap-to-host-pad
--multitap
--ntsc-region-default
--opt-cache-isolation
--pace-gpu-dma
--pace-gpu-dma-slow
--pad%d-device
--pad%d-plug-state
--pad-analog-button
--players
--postproc-aa
--present-delay-scanlines
--ps1-left-stick-action
--ps1-left-stick-deadzone-x
--ps1-left-stick-deadzone-y
--ps1-left-stick-semicircle-arc-range
--ps1-stress-ui-unlock-threshold
--ps1-title-id
--ps4-trophies
--psp-hack-multipad-to-player1-remap
--psp-right-stick-action
--psp-right-stick-deadzone-x
--psp-right-stick-deadzone-y
--psp-right-stick-lr
--psp-right-stick-semicircle-arc-range
--region
--region-dir
--remap
--remap-lstick-to-digital
--remap-rstick-to-digital
--replacement-texture-dir
--request-ntsc-region
--run-hook-msg
--saturation
--savedata-dir
--savedata-mode
--savestate-dir
--scale
--scanout-reset-maskpixel
--sce-executable-fullpath
--screenshot-dir
--screenshot-period
--screenshot-png-compress-level
--show-dev-ui
--show-fps-graph
--show-trophy-ui
--sim-analog-pad
--sio-allow-irq-during-irq
--skip-copyback-if-display-disabled
--skip-interlacing
--snap-entrypoint-filename
--snap-save
--snap-save-period
--snapshot-autokill
--snapshot-dir
--snapshot-entrypoint
--snapshot-restore
--snapshot-restore-slot
--snapshot-vram
--softgp
--softgpu
--state-H
--state-restore
--state-save
--state-save-memslots
--state-save-period
--temp-dir
--texdum
--texdump
--texrec
--texrecent
--texrep
--texreplace
--throttle
--throttle-bios
--throttle-catchup
--throttle-fps
--throttle-mode
--title-artifacts-dir
--title-dir
--title-id
--trace-host-msgs
--trace-hotload
--trace-snap-compare
--trophies
--unattended
--uprender-scale
--use-lopnor-spu
--userui-psp-right-stick-remapping
--userui-region-selector
--userui-remap-%s-pad%d
--userui-settings-graphics
--uv-mirroring-fix
--vault-dir
--vram-merge-no-delay
--vram-read-frame-delay
--waH
--wait
--wait-debug
--waitForDebugger
--xobuttonmode
Total Commands2568799198100103103103103103135154157

Example Usage

--bios

Compatibility
All

Path to a specific PS1 BIOS file to load.

MediEvil
--bios="bios/SCPH5501.BIN"

--bios-hide-sce-osd

Compatibility
Syphon Filter V1.00+

Hides the PS1 start up logos.

Syphon Filter V1.00
--bios-hide-sce-osd=1

--image

Compatibility
All

Path to a specific PS1 disc image to load.

MediEvil
--image="data/MediEvil(EUS).bin"

--mtap-to-host-pad

Compatibility
Rally Cross V1.00+

Allows you to define how the host (PS4) controllers are assigned to the PS1 multitap slots.

A value -1 would seem to imply the controller slot is not connected.

A value of 0 (Player 1) through 3 (Player 4) can be assigned (presumably up to 7 could be assigned, but the PS4 only connects 4 controllers).

The value for the command appears to assign the controller slots in the following comma seperated order:

1A2A1B1C1D2B2C2D
Example 1: Multitap on port 1 with 4 controllers
# Multitap connected to port 1 (1A), 1B, 1C, 1D
# Nothing connected to port 2

# PORTS MULTI 1 MULTI 2
# 1 2 1B 1C 1D 2B 2C 2D
# PS4 Player 1 - 2 3 4 - - -
--mtap-to-host-pad=0,-1, 1,2,3, -1,-1,-1

Rally Cross includes configuration which connects player 1 to port 1, and the multitap (players 2 to 4) on port 2:

Rally Cross V1.00
# Player 1 connected to port 1
# Multitap connected to port 2 (2A), 2B, 2C, 2D

# Enable 4 player multitap. Rally Cross wants the multitap mapped to Port #2

# PORTS MULTI 1 MULTI 2
# 1 2 1B 1C 1D 2B 2C 2D
# PS4 Player 1 2 - - - 3 4
--mtap-to-host-pad=0,1, -1,-1,-1, 2,3,4

--region

Compatibility
All
MediEvil
--region="SCEA"

--pad-analog-button

Compatibility
Rally Cross V1.00+

Sets the state of the analog button for all controllers.

Rally Cross V1.00
--pad-analog-button=1

When set to 0 the emulator outputs:

(JoyPort 0) Analog button status changed by app to '0'
(JoyPort 1) Analog button status changed by app to '0'
(JoyPort 2) Analog button status changed by app to '0'
(JoyPort 3) Analog button status changed by app to '0'
(JoyPort 4) Analog button status changed by app to '0'
(JoyPort 5) Analog button status changed by app to '0'
(JoyPort 6) Analog button status changed by app to '0'
(JoyPort 7) Analog button status changed by app to '0'

--pad%d-plug-state

Compatibility
Rally Cross V1.00+

No examples from official releases

Sets the state of a specific PS1 controller to always be seen as connected.

The PS1 supported 8 controllers (with 2 multitaps) and each pad number seems to correspond to a fixed controller slot:

PS1 Controller SlotPad Number
1 (1A)0
2 (1B)1
1B2
1C3
1D4
2B5
2C6
2D7
Example 1
# Force controllers in ports 1 and 2 to always be connected
--pad0-plug-state=1
--pad1-plug-state=1

This can be useful for testing multitap configurations when you only have access to a limited number of actual controllers.

For example when you have a multitap connected to port 1 with 4 controllers connected to it, you could configure controllers 2 to 4 to always be connected. You can then swap users in the PS4 to test different player slots.

Example 2
# Force controllers in ports 1B, 1C, 1D to always be connected
--pad2-plug-state=1 # Player 2
--pad3-plug-state=1 # Player 3
--pad4-plug-state=1 # Player 4

# You can of course also make the controller in 1A always connected too:
--pad0-plug-state=1 # Player 1

--pace-gpu-dma

Compatibility
Syphon Filter V1.00+
Syphon Filter V1.00
--pace-gpu-dma=true

--scale

Compatibility
All
MediEvil
# x1=1280x720, x2=1920x1080, x4=3840x2160
--scale=1
Syphon Filter V1.00
--scale=6

--texrecent

Compatibility
MediEvil
Syphon Filter V1.00+
MediEvil
--texrecent=true

--userui-remap-%s-pad%d

Compatibility
Rally Cross V1.00+

No examples from official releases

Allows remapping of controller buttons.

The syntax appears to be:
--userui-remap-ps1-pad[0-3]=host_button:ps1_button, host_button:ps1_button

The pad values (0 to 3), seem to map to the PS4 player number rather than the PS1 pad numbers.

Host Buttons
(DS4)
PS1 Buttons
crosscross
circlecircle
triangletriangle
squaresquare
l1l1
r1r1
l2l2
r2r2
l3l3
r3r3
leftleft
rightright
upup
downdown
lstick.leftlstick.left
lstick.rightlstick.right
lstick.uplstick.up
lstick.downlstick.down
rstick.leftrstick.left
rstick.rightrstick.right
rstick.uprstick.up
rstick.downrstick.down
tpad_left
tpad_right
start
Example 1
# Remap Player 1 and Player 2
# Cross button to Triangle
# Triangle button to Cross

# Remap Player 1 DS4 PS1 DS4 PS1
--userui-remap-ps1-pad0=cross:triangle, triangle,cross

# Remap Player 2 DS4 PS1 DS4 PS1
--userui-remap-ps1-pad1=cross:triangle, triangle,cross
Example 2 - Quake 2
# Remap Player 1 and Player 2
# Quake 2 "Both Sticks" control scheme has strafe and turn on the wrong
# analog sticks, relative to a modern control scheme.
# This swaps the x-axis between analog sticks so move and strafe are on the left stick
# and turn and look up/down are on the right.

# Remap Player 1 DS4 PS1 DS4 PS1 DS4 PS1 DS4 PS1
--userui-remap-ps1-pad0=lstick.left:rstick.left, lstick.right:rstick.right, rstick.left:lstick.left, rstick.right:lstick.right

# Remap Player 2 DS4 PS1 DS4 PS1 DS4 PS1 DS4 PS1
--userui-remap-ps1-pad1=lstick.left:rstick.left, lstick.right:rstick.right, rstick.left:lstick.left, rstick.right:lstick.right

If you supply bad configuration, the emulator will output a message like:

ReportError --userui-ps1-remap-pad has an unknown PS1 button name=

--userui-settings-graphics

Compatibility
Syphon Filter 2 V1.00+

No examples from official releases

Enables access to the Graphics emulator menu, which includes options:

  • Uprendering scale factor (No upscale -> 6x scale)
  • Filter (None Bicubic, Lanczos, Cubic)
  • Anti-Aliasing (None, FXAA, CMAA)

Emulator Graphics menu

Example 1
# Enable emulator Graphics menu
--userui-settings-graphics=1