WARNING: Save states(and by extension, state rewinding and netplay) and saved games on emulated memory cards do not mix well unless you are extremely careful. For any given game, either use save states or the game's own save system, but not both, lest you may destroy your saved games.
A dual-core Phenom II or Athlon II at 3GHz or higher, or rough equivalent(in terms of single-core IPC), is recommended for
running Mednafen's PlayStation 1 emulation on(note that this recommendation does not apply to any unofficial ports or forks, which may have higher
CPU requirements). For better performance, the binary should be compiled for a 64-bit target(for example, x86_64) rather than 32-bit, if available.
Enabling CD image preloading into memory via the cd.image_memcache setting is recommended, to avoid short emulator pauses and audio pops due to waiting for disk accesses to complete when the emulated CD is accessed.
PSF1 playback is supported. However, many PSF1 rips won't work properly as they are broken in various ways:
Place the correct BIOS image files in the correct location. Do not rename other revisions/regions of the BIOS to match the expected filenames, or you'll likely cause emulation glitches(and cause confusion if you ever distribute or otherwise refer to these misnamed files).
The filenames listed below are per default psx.bios_* settings.
Filename: | Purpose: | SHA-256 Hash: |
---|---|---|
scph5500.bin | SCPH-5500/v3.0J BIOS image. Required for Japan-region games. | 9c0421858e217805f4abe18698afea8d5aa36ff0727eb8484944e00eb5e7eadb |
scph5501.bin | SCPH-5501/v3.0A BIOS image. Required for North America/US-region games. Reportedly the same as the SCPH-7003 BIOS image. | 11052b6499e466bbf0a709b1f9cb6834a9418e66680387912451e971cf8a1fef |
scph5502.bin | SCPH-5502/v3.0E BIOS image. Required for Europe-region games. | 1faaa18fa820a0225e488d9f086296b8e6c46df739666093987ff7d8fd352c09 |
An "axis_scale" setting(named like "psx.input.port1.dualshock.axis_scale") is provided for each possible emulated DualShock and Dual Analog controller on each port. To work around this range issue with DualShock emulation, an "axis_scale" setting of "1.33" is recommended as a starting point. Smaller values(such as "1.20") may be sufficient and provide for more precise control, so try experimenting to find the ideal for your combination of gamepad and games.
By default, no multitap is enabled. Be aware that if you enable multitap on PSX port 1, game view mapping will be inconsistent between games that support multitap and those that do not.
Enabling multitap on either PSX port may cause slight game slowdown. Some 1-and-2-player-only games half-support the multitap, but are apparently not coded with the multitap in mind, and may suffer from graphical glitches like screen tearing if multitap is enabled when running them.
(Virtual) Port Index to Game View Mappings for Multitap only on PSX Port 1 | |||
---|---|---|---|
Port Index: | Multitap-Compatible-Game: | Multitap-Incompatible-Game: | Physical Port Name: |
1 | 1 | 1 | 1A |
2 | 2 | - | 1B |
3 | 3 | - | 1C |
4 | 4 | - | 1D |
5 | 5 | 2 | 2 |
6 | - | - | - |
7 | - | - | - |
8 | - | - | - |
(Virtual) Port Index to Game View Mappings for Multitap only on PSX Port 2 | |||
---|---|---|---|
Port Index: | Multitap-Compatible-Game: | Multitap-Incompatible-Game: | Physical Port Name: |
1 | 1 | 1 | 1 |
2 | 2 | 2 | 2A |
3 | 3 | - | 2B |
4 | 4 | - | 2C |
5 | 5 | - | 2D |
6 | - | - | - |
7 | - | - | - |
8 | - | - | - |
(Virtual) Port Index to Game View Mappings for Multitap on both PSX Ports | |||
---|---|---|---|
Port Index: | Multitap-Compatible-Game: | Multitap-Incompatible-Game: | Physical Port Name: |
1 | 1 | 1 | 1A |
2 | 2 | - | 1B |
3 | 3 | - | 1C |
4 | 4 | - | 1D |
5 | 5 | 2 | 2A |
6 | 6 | - | 2B |
7 | 7 | - | 2C |
8 | 8 | - | 2D |
Key: | Emulated Button: |
---|---|
W | Up |
S | Down |
A | Left |
D | Right |
Tab | SELECT |
Enter | START |
Keypad 8 | △ |
Keypad 2 | x |
Keypad 4 | □ |
Keypad 6 | ○ |
Keypad 1 | L1 |
Keypad 7 | L2 |
Keypad 3 | R1 |
Keypad 9 | R2 |
Caution: Any settings that change emulation behavior as seen from the emulated game are shown with the setting name bolded in the table. One should be conscious of these settings if one has changed them from the default values when using network play or movies, as they can cause desychronizations if not set the same among hosts(or between the recording emulator and the playing emulator).
Setting: | Value Type: | Possible Values: | Default Value: | Description: |
---|---|---|---|---|
psx.bios_eu | string | scph5502.bin | Path to the Europe SCPH-5502/v3.0E ROM BIOS SHA-256 1faaa18fa820a0225e488d9f086296b8e6c46df739666093987ff7d8fd352c09 | |
  | ||||
psx.bios_jp | string | scph5500.bin | Path to the Japan SCPH-5500/v3.0J ROM BIOS SHA-256 9c0421858e217805f4abe18698afea8d5aa36ff0727eb8484944e00eb5e7eadb | |
  | ||||
psx.bios_na | string | scph5501.bin | Path to the North America SCPH-5501/v3.0A ROM BIOS SHA-256 11052b6499e466bbf0a709b1f9cb6834a9418e66680387912451e971cf8a1fef | |
  | ||||
psx.bios_sanity | boolean | 0 1 | 1 | Enable BIOS ROM image sanity checks. Enables blacklisting of known bad BIOS dumps and known BIOS versions that don't match the region of the hardware being emulated. |
  | ||||
psx.cd_sanity | boolean | 0 1 | 1 | Enable CD (image) sanity checks. Sanity checks are only performed on discs detected(via heuristics) to be PS1 discs. The checks primarily consist of ensuring that Q subchannel data is as expected for a typical commercially-released PS1 disc. |
  | ||||
psx.correct_aspect | boolean | 0 1 | 1 | Correct aspect ratio. Disabling aspect ratio correction with this setting should be considered a hack. |
  | ||||
psx.dbg_mask | multi-enum | none warning stdout cdc memcard | none | Enable debug messages.
|
  | ||||
psx.h_overscan | boolean | 0 1 | 1 | Show horizontal overscan area. |
  | ||||
psx.input.analog_mode_ct | boolean | 0 1 | 0 | Enable analog mode combo-button alternate toggle. When enabled, instead of the configured Analog mode toggle button for the emulated DualShock, use a combination of buttons held down for one emulated second to toggle it instead. The specific combination is controlled via the "psx.input.analog_mode_ct.compare" setting, which by default is Select, Start, and all four shoulder buttons. |
  | ||||
psx.input.analog_mode_ct.compare | integer | 0x0000 through 0xFFFF | 0x0F09 | Compare value for analog mode combo-button alternate toggle. 0x0001=SELECT |
  | ||||
psx.input.mouse_sensitivity | real | through | 1.00 | Emulated mouse sensitivity. |
  | ||||
psx.input.port1 | enum | none gamepad dualshock dualanalog analogjoy mouse negcon guncon justifier dancepad popnmusic | gamepad | Input device for Virtual Port 1
|
  | ||||
psx.input.port1.analogjoy.axis_scale | real | 1.00 through 1.50 | 1.00 | Analog axis scale coefficient for Analog Joystick on Virtual Port 1. |
  | ||||
psx.input.port1.dualanalog.axis_scale | real | 1.00 through 1.50 | 1.00 | Analog axis scale coefficient for Dual Analog on Virtual Port 1. |
  | ||||
psx.input.port1.dualshock.axis_scale | real | 1.00 through 1.50 | 1.00 | Analog axis scale coefficient for DualShock on Virtual Port 1. |
  | ||||
psx.input.port1.gun_chairs | integer | 0x000000 through 0x1000000 | 0xFF0000 | Crosshairs color for lightgun on virtual port 1. A value of 0x1000000 disables crosshair drawing. |
  | ||||
psx.input.port1.memcard | boolean | 0 1 | 1 | Emulate memory card on virtual port 1. |
  | ||||
psx.input.port2 | enum | none gamepad dualshock dualanalog analogjoy mouse negcon guncon justifier dancepad popnmusic | gamepad | Input device for Virtual Port 2
|
  | ||||
psx.input.port2.analogjoy.axis_scale | real | 1.00 through 1.50 | 1.00 | Analog axis scale coefficient for Analog Joystick on Virtual Port 2. |
  | ||||
psx.input.port2.dualanalog.axis_scale | real | 1.00 through 1.50 | 1.00 | Analog axis scale coefficient for Dual Analog on Virtual Port 2. |
  | ||||
psx.input.port2.dualshock.axis_scale | real | 1.00 through 1.50 | 1.00 | Analog axis scale coefficient for DualShock on Virtual Port 2. |
  | ||||
psx.input.port2.gun_chairs | integer | 0x000000 through 0x1000000 | 0x00FF00 | Crosshairs color for lightgun on virtual port 2. A value of 0x1000000 disables crosshair drawing. |
  | ||||
psx.input.port2.memcard | boolean | 0 1 | 1 | Emulate memory card on virtual port 2. |
  | ||||
psx.input.port3 | enum | none gamepad dualshock dualanalog analogjoy mouse negcon guncon justifier dancepad popnmusic | gamepad | Input device for Virtual Port 3
|
  | ||||
psx.input.port3.analogjoy.axis_scale | real | 1.00 through 1.50 | 1.00 | Analog axis scale coefficient for Analog Joystick on Virtual Port 3. |
  | ||||
psx.input.port3.dualanalog.axis_scale | real | 1.00 through 1.50 | 1.00 | Analog axis scale coefficient for Dual Analog on Virtual Port 3. |
  | ||||
psx.input.port3.dualshock.axis_scale | real | 1.00 through 1.50 | 1.00 | Analog axis scale coefficient for DualShock on Virtual Port 3. |
  | ||||
psx.input.port3.gun_chairs | integer | 0x000000 through 0x1000000 | 0xFF00FF | Crosshairs color for lightgun on virtual port 3. A value of 0x1000000 disables crosshair drawing. |
  | ||||
psx.input.port3.memcard | boolean | 0 1 | 1 | Emulate memory card on virtual port 3. |
  | ||||
psx.input.port4 | enum | none gamepad dualshock dualanalog analogjoy mouse negcon guncon justifier dancepad popnmusic | gamepad | Input device for Virtual Port 4
|
  | ||||
psx.input.port4.analogjoy.axis_scale | real | 1.00 through 1.50 | 1.00 | Analog axis scale coefficient for Analog Joystick on Virtual Port 4. |
  | ||||
psx.input.port4.dualanalog.axis_scale | real | 1.00 through 1.50 | 1.00 | Analog axis scale coefficient for Dual Analog on Virtual Port 4. |
  | ||||
psx.input.port4.dualshock.axis_scale | real | 1.00 through 1.50 | 1.00 | Analog axis scale coefficient for DualShock on Virtual Port 4. |
  | ||||
psx.input.port4.gun_chairs | integer | 0x000000 through 0x1000000 | 0xFF8000 | Crosshairs color for lightgun on virtual port 4. A value of 0x1000000 disables crosshair drawing. |
  | ||||
psx.input.port4.memcard | boolean | 0 1 | 1 | Emulate memory card on virtual port 4. |
  | ||||
psx.input.port5 | enum | none gamepad dualshock dualanalog analogjoy mouse negcon guncon justifier dancepad popnmusic | gamepad | Input device for Virtual Port 5
|
  | ||||
psx.input.port5.analogjoy.axis_scale | real | 1.00 through 1.50 | 1.00 | Analog axis scale coefficient for Analog Joystick on Virtual Port 5. |
  | ||||
psx.input.port5.dualanalog.axis_scale | real | 1.00 through 1.50 | 1.00 | Analog axis scale coefficient for Dual Analog on Virtual Port 5. |
  | ||||
psx.input.port5.dualshock.axis_scale | real | 1.00 through 1.50 | 1.00 | Analog axis scale coefficient for DualShock on Virtual Port 5. |
  | ||||
psx.input.port5.gun_chairs | integer | 0x000000 through 0x1000000 | 0xFFFF00 | Crosshairs color for lightgun on virtual port 5. A value of 0x1000000 disables crosshair drawing. |
  | ||||
psx.input.port5.memcard | boolean | 0 1 | 1 | Emulate memory card on virtual port 5. |
  | ||||
psx.input.port6 | enum | none gamepad dualshock dualanalog analogjoy mouse negcon guncon justifier dancepad popnmusic | gamepad | Input device for Virtual Port 6
|
  | ||||
psx.input.port6.analogjoy.axis_scale | real | 1.00 through 1.50 | 1.00 | Analog axis scale coefficient for Analog Joystick on Virtual Port 6. |
  | ||||
psx.input.port6.dualanalog.axis_scale | real | 1.00 through 1.50 | 1.00 | Analog axis scale coefficient for Dual Analog on Virtual Port 6. |
  | ||||
psx.input.port6.dualshock.axis_scale | real | 1.00 through 1.50 | 1.00 | Analog axis scale coefficient for DualShock on Virtual Port 6. |
  | ||||
psx.input.port6.gun_chairs | integer | 0x000000 through 0x1000000 | 0x00FFFF | Crosshairs color for lightgun on virtual port 6. A value of 0x1000000 disables crosshair drawing. |
  | ||||
psx.input.port6.memcard | boolean | 0 1 | 1 | Emulate memory card on virtual port 6. |
  | ||||
psx.input.port7 | enum | none gamepad dualshock dualanalog analogjoy mouse negcon guncon justifier dancepad popnmusic | gamepad | Input device for Virtual Port 7
|
  | ||||
psx.input.port7.analogjoy.axis_scale | real | 1.00 through 1.50 | 1.00 | Analog axis scale coefficient for Analog Joystick on Virtual Port 7. |
  | ||||
psx.input.port7.dualanalog.axis_scale | real | 1.00 through 1.50 | 1.00 | Analog axis scale coefficient for Dual Analog on Virtual Port 7. |
  | ||||
psx.input.port7.dualshock.axis_scale | real | 1.00 through 1.50 | 1.00 | Analog axis scale coefficient for DualShock on Virtual Port 7. |
  | ||||
psx.input.port7.gun_chairs | integer | 0x000000 through 0x1000000 | 0x0080FF | Crosshairs color for lightgun on virtual port 7. A value of 0x1000000 disables crosshair drawing. |
  | ||||
psx.input.port7.memcard | boolean | 0 1 | 1 | Emulate memory card on virtual port 7. |
  | ||||
psx.input.port8 | enum | none gamepad dualshock dualanalog analogjoy mouse negcon guncon justifier dancepad popnmusic | gamepad | Input device for Virtual Port 8
|
  | ||||
psx.input.port8.analogjoy.axis_scale | real | 1.00 through 1.50 | 1.00 | Analog axis scale coefficient for Analog Joystick on Virtual Port 8. |
  | ||||
psx.input.port8.dualanalog.axis_scale | real | 1.00 through 1.50 | 1.00 | Analog axis scale coefficient for Dual Analog on Virtual Port 8. |
  | ||||
psx.input.port8.dualshock.axis_scale | real | 1.00 through 1.50 | 1.00 | Analog axis scale coefficient for DualShock on Virtual Port 8. |
  | ||||
psx.input.port8.gun_chairs | integer | 0x000000 through 0x1000000 | 0x8000FF | Crosshairs color for lightgun on virtual port 8. A value of 0x1000000 disables crosshair drawing. |
  | ||||
psx.input.port8.memcard | boolean | 0 1 | 1 | Emulate memory card on virtual port 8. |
  | ||||
psx.input.pport1.multitap | boolean | 0 1 | 0 | Enable multitap on PSX port 1. Makes 3 more virtual ports available. |
  | ||||
psx.input.pport2.multitap | boolean | 0 1 | 0 | Enable multitap on PSX port 2. Makes 3 more virtual ports available. |
  | ||||
psx.region_autodetect | boolean | 0 1 | 1 | Attempt to auto-detect region of game. |
  | ||||
psx.region_default | enum | jp na eu | jp | Default region to use. Used if region autodetection fails or is disabled.
|
  | ||||
psx.slend | integer | 0 through 239 | 239 | Last displayed scanline in NTSC mode. |
  | ||||
psx.slendp | integer | 0 through 287 | 287 | Last displayed scanline in PAL mode. |
  | ||||
psx.slstart | integer | 0 through 239 | 0 | First displayed scanline in NTSC mode. |
  | ||||
psx.slstartp | integer | 0 through 287 | 0 | First displayed scanline in PAL mode. |
  | ||||
psx.spu.resamp_quality | integer | 0 through 10 | 5 | SPU output resampler quality. 0 is lowest quality and CPU usage, 10 is highest quality and CPU usage. The resampler that this setting refers to is used for converting from 44.1KHz to the sampling rate of the host audio device Mednafen is using. Changing Mednafen's output rate, via the "sound.rate" setting, to "44100" may bypass the resampler, which can decrease CPU usage by Mednafen, and can increase or decrease audio quality, depending on various operating system and hardware factors. |
  |
Setting: | Value Type: | Possible Values: | Default Value: | Description: |
---|---|---|---|---|
psx.debugger.disfontsize | enum | 5x7 6x9 6x12 6x13 9x18 | 5x7 | Disassembly font size. Note: Setting the font size to larger than the default may cause text overlap in the debugger.
|
  | ||||
psx.debugger.memcharenc | string | shift_jis | Character encoding for the debugger's memory editor. | |
  | ||||
psx.enable | boolean | 0 1 | 1 | Enable (automatic) usage of this module. |
  | ||||
psx.forcemono | boolean | 0 1 | 0 | Force monophonic sound output. |
  | ||||
psx.scanlines | integer | -100 through 100 | 0 | Enable scanlines with specified opacity. Opacity is specified in %; IE a value of "100" will give entirely black scanlines. |
  | ||||
psx.shader | enum | none autoip autoipsharper scale2x sabr ipsharper ipxnoty ipynotx ipxnotysharper ipynotxsharper goat | none | Enable specified OpenGL shader. Obviously, this will only work with the OpenGL "video.driver" setting, and only on cards and OpenGL implementations that support shaders, otherwise you will get a black screen, or Mednafen may display an error message when starting up. When a shader is enabled, the "psx.videoip" setting is ignored.
|
  | ||||
psx.shader.goat.fprog | boolean | 0 1 | 0 | Force interlaced video to be treated as progressive. When disabled, the default, the "video.deinterlacer" setting is effectively ignored with respect to what appears on the screen, unless it's set to "blend" or "blend_rg". When enabled, it may be prudent to disable the scanlines effect controlled by the "psx.shader.goat.slen" setting, or else the scanline effect may look objectionable. |
  | ||||
psx.shader.goat.hdiv | real | -2.00 through 2.00 | 0.50 | Constant RGB horizontal divergence. |
  | ||||
psx.shader.goat.pat | enum | goatron borg slenderman | goatron | Mask pattern.
|
  | ||||
psx.shader.goat.slen | boolean | 0 1 | 1 | Enable scanlines effect. |
  | ||||
psx.shader.goat.tp | real | 0.00 through 1.00 | 0.50 | Transparency of otherwise-opaque mask areas. |
  | ||||
psx.shader.goat.vdiv | real | -2.00 through 2.00 | 0.50 | Constant RGB vertical divergence. |
  | ||||
psx.special | enum | none hq2x hq3x hq4x scale2x scale3x scale4x 2xsai super2xsai supereagle nn2x nn3x nn4x nny2x nny3x nny4x | none | Enable specified special video scaler. The destination rectangle is NOT altered by this setting, so if you have xscale and yscale set to "2", and try to use a 3x scaling filter like hq3x, the image is not going to look that great. The nearest-neighbor scalers are intended for use with bilinear interpolation enabled, for a sharper image, though the "autoipsharper" shader may provide better results.
|
  | ||||
psx.stretch | enum | 0 full aspect aspect_int aspect_mult2 | aspect_mult2 | Stretch to fill screen.
|
  | ||||
psx.tblur | boolean | 0 1 | 0 | Enable video temporal blur(50/50 previous/current frame by default). |
  | ||||
psx.tblur.accum | boolean | 0 1 | 0 | Accumulate color data rather than discarding it. |
  | ||||
psx.tblur.accum.amount | real | 0 through 100 | 50 | Blur amount in accumulation mode, specified in percentage of accumulation buffer to mix with the current frame. |
  | ||||
psx.videoip | enum | 0 1 x y | 1 | Enable (bi)linear interpolation.
|
  | ||||
psx.xres | integer | 0 through 65536 | 0 | Full-screen horizontal resolution. A value of "0" will cause the current desktop horizontal resolution to be used. |
  | ||||
psx.xscale | real | 0.01 through 256 | 3.000000 | Scaling factor for the X axis in windowed mode. |
  | ||||
psx.xscalefs | real | 0.01 through 256 | 1.000000 | Scaling factor for the X axis in fullscreen mode. For this setting to have any effect, the "psx.stretch" setting must be set to "0". |
  | ||||
psx.yres | integer | 0 through 65536 | 0 | Full-screen vertical resolution. A value of "0" will cause the current desktop vertical resolution to be used. |
  | ||||
psx.yscale | real | 0.01 through 256 | 3.000000 | Scaling factor for the Y axis in windowed mode. |
  | ||||
psx.yscalefs | real | 0.01 through 256 | 1.000000 | Scaling factor for the Y axis in fullscreen mode. For this setting to have any effect, the "psx.stretch" setting must be set to "0". |
  |