Skip to content

ROMS Support

Aldo Vargas edited this page Nov 8, 2024 · 26 revisions

Configuration

ROMS require RetroArch and PKGLAUNCHER installed. PKGLAUNCHER is installed automatically in the recent versions.

The ROMS setting must be check-marked in the section "Scan for Content" of /setup.ps3 image

ROMS are supported on internal hdd0, FAT32 USB devices, on ps3netsrv & using prepISO (ntfs/ext2/exFAT) image

Notes:

  • Some cores are only available on RetroArch CE.
  • NOT all cores play well on the PS3 (large majority play at full speed)
  • ROMS subfolders can be all uppercase, lowercase or first letter capitalized. i.e. /ROMS/SNES, /ROMS/snes or /ROMS/Snes
  • Since build 1.47.47, /dev_hdd0/tmp/wm_res/roms_path.txt can be used to specify which ROMS paths are allowed

ROMS Paths

PATH EMULATOR (Libretro Core) REMARKS
/ROMS/SNES/ snes9x2010_libretro_ps3.SELF
snes9x_next_libretro_ps3.SELF
snes9x2005_plus_libretro_ps3.SELF
snes9x2005_libretro_ps3.SELF
snes9x_libretro_ps3.SELF
mednafen_snes_libretro_ps3.SELF
Super Nintendo
/ROMS/SNES9X/ snes9x_libretro_ps3.SELF Super Nintendo (SNES9X)
/ROMS/SNES9X2005/ snes9x2005_plus_libretro_ps3.SELF Super Nintendo (SNES9X 2005)
/ROMS/SNES9X2010/ snes9x2010_libretro_ps3.SELF Super Nintendo (SNES9X 2010)
/ROMS/SNES9X_NEXT/ snes9x_next_libretro_ps3.SELF Super Nintendo (SNES9X_NEXT)
/ROMS/MSNES/ mednafen_snes_libretro_ps3.SELF Super Nintendo (MSNES)
/ROMS/NES/ fceumm_libretro_ps3.SELF
nestopia_libretro_ps3.SELF
quicknes_libretro_ps3.SELF
Nintendo NES
/ROMS/FCEUMM/ fceumm_libretro_ps3.SELF Nintendo NES (FCEUMM)
/ROMS/NESTOPIA/ nestopia_libretro_ps3.SELF Nintendo NES (Nestopia)
/ROMS/QNES/ quicknes_libretro_ps3.SELF Nintendo NES (QNES)
/ROMS/GEN
/ROMS/GENESIS/
/ROMS/MASTER/
genesis_plus_gx_wide_libretro_ps3.SELF
genesis_plus_gx_libretro_ps3.SELF
picodrive_libretro_ps3.SELF
SEGA Genesis
/ROMS/MEGAD
/ROMS/MEGADRIVE/
/ROMS/SEGACD/
genesis_plus_gx_wide_libretro_ps3.SELF
genesis_plus_gx_libretro_ps3.SELF
picodrive_libretro_ps3.SELF
SEGA Megadrive
/ROMS/PICO/ picodrive_libretro_ps3.SELF SEGA MS/MD/CD/32X (PicoDrive)
/ROMS/GG/
/ROMS/GGEAR
gearsystem_libretro_ps3.SELF SEGA Game Gear
/ROMS/GEARBOY/ gearboy_libretro_ps3.SELF SEGA Game Gear (GEARBOY)
/ROMS/SG1000/ bluemsx_libretro_ps3.SELF SEGA SG-1000
/ROMS/GBA/ vba_next_libretro_ps3.SELF
mgba_libretro_ps3.SELF
Nintendo Gameboy Advance
/ROMS/VBA/ vba_next_libretro_ps3.SELF Nintendo Gameboy Advance (VBA)
/ROMS/MGBA/ mgba_libretro_ps3.SELF Nintendo Gameboy Advance (mGBA)
/ROMS/GB/ gambatte_libretro_ps3.SELF
gearboy_libretro_ps3.SELF
tgbdual_libretro_ps3.SELF
Nintendo Gameboy
/ROMS/GBC/ gambatte_libretro_ps3.SELF Nintendo Gameboy Color
/ROMS/GAMBATTE/ gambatte_libretro_ps3.SELF Nintendo Gameboy (GAMBATTE)
/ROMS/VBOY/ mednafen_vb_libretro_ps3.SELF Nintendo Virtual Boy
/ROMS/FBA/ fb_alpha_libretro_ps3.SELF
fbalpha_libretro_ps3.SELF
fbalpha2012_libretro_ps3.SELF
Arcade (FB Alpha)
/ROMS/FBA2012/ fbalpha2012_libretro_ps3.SELF Arcade (FBA 2012)
/ROMS/FBNEO/ fbneo_libretro_ps3.SELF Arcade (FinalBurn Neo)
/ROMS/NEOCD/ neocd_libretro_ps3.SELF Neo Geo CD (NeoCD)
/ROMS/NEO/
/ROMS/NEOGEO/
fbneo_light_libretro_ps3.SELF
fbneo_libretro_ps3.SELF
neocd_libretro_ps3.SELF
Neo Geo (FinalBurn Neo)
NeoGeo & CPS Systems only
/ROMS/NGP/
/ROMS/NGPC/
mednafen_ngp_libretro_ps3.SELF Neogeo Pocket
/ROMS/MAME/ mame2003_libretro_ps3.SELF
mame2000_libretro_ps3.SELF
mame2003_plus_libretro_ps3.SELF
mame2003_midway_libretro_ps3.SELF
mame078_libretro_ps3.SELF
Arcade (MAME)
/ROMS/MAME078/ mame078_libretro_ps3.SELF Arcade (MAME 0.78)
/ROMS/MAME2000/ mame2000_libretro_ps3.SELF Arcade (MAME 2000)
/ROMS/MAME2003/ mame2003_libretro_ps3.SELF Arcade (MAME 2003)
/ROMS/MAMEPLUS/ mame2003_plus_libretro_ps3.SELF Arcade (MAME 2003 Plus)
/ROMS/MIDWAY/ mame2003_midway_libretro_ps3.SELF Arcade (MAME 2003 Midway)
/ROMS/QUAKE/ tyrquake_libretro_ps3.SELF iD Software - Quake
/ROMS/DOOM/ prboom_libretro_ps3.SELF iD Software - Doom
/ROMS/PCE/ mednafen_pce_fast_libretro_ps3.SELF NEC PC Engine
/ROMS/PCECD/ mednafen_pce_fast_libretro_ps3.SELF NEC PC Engine CD
/ROMS/PCFX/ mednafen_pcfx_libretro_ps3.SELF NEC PC Engine FX
/ROMS/SGX/ mednafen_supergrafx_libretro_ps3.SELF
mednafen_pce_libretro_ps3.SELF
NEC PC Engine SuperGrafx
/ROMS/ATARI/ stella_libretro_ps3.SELF Atari 2600
/ROMS/STELLA/ stella2014_libretro_ps3.SELF Atari 2600 (Stella 2014)
/ROMS/ATARI2600/ stella_libretro_ps3.SELF
stella2014_libretro_ps3.SELF
Atari 2600
/ROMS/ATARI800/ atari800_libretro_ps3.SELF
a5200_libretro_ps3
Atari 5200
/ROMS/ATARI5200/ a5200_libretro_ps3
atari800_libretro_ps3.SELF
Atari 5200
/ROMS/ATARI7800/ prosystem_libretro_ps3.SELF Atari 7800
/ROMS/HATARI/ hatari_libretro_ps3.SELF Atari ST (HATARI)
/ROMS/LYNX/ mednafen_lynx_libretro_ps3.SELF Atari Lynx
/ROMS/JAGUAR/ virtualjaguar_libretro_ps3.SELF Atari Jaguar
/ROMS/HANDY/ handy_libretro_ps3.SELF Atari Lynx (HANDY)
/ROMS/AMIGA/
/ROMS/CD32/
puae_libretro_ps3.SELF Commodore AMIGA
/ROMS/VICE/
/ROMS/X64/
vice_x64_libretro_ps3.SELF Commodore 64
/ROMS/X64SC/ vice_x64sc_libretro_ps3.SELF Commodore C64 SuperCPU
/ROMS/XSCPU64/ vice_xscpu64_libretro_ps3.SELF Commodore C64 SuperCPU
/ROMS/X64DTV/ vice_x64dtv_libretro_ps3.SELF Commodore C64 Direct to TV
/ROMS/X128/ vice_x128_libretro_ps3.SELF Commodore C128
/ROMS/XCBM2/ vice_xcbm2_libretro_ps3.SELF Commodore CBM-II
/ROMS/XCBM25X0/
/ROMS/XCBM5/
vice_xcbm5x0_libretro_ps3.SELF Commodore CBM-II 5x0
/ROMS/XPET/ vice_xpet_libretro_ps3.SELF Commodore PET
/ROMS/XPLUS4/ vice_xplus4_libretro_ps3.SELF Commodore PLUS/4
/ROMS/XVIC/ vice_xvic_libretro_ps3.SELF Commodore VIC-20
/ROMS/FMSX/ fmsx_libretro_ps3.SELF
bluemsx_libretro_ps3.SELF
Microsoft MSX (fMSX)
/ROMS/BMSX/
/ROMS/MSX/
/ROMS/MSX2/
/ROMS/BLUEMSX/
bluemsx_libretro_ps3.SELF Microsoft MSX
/ROMS/COLECO/ gearcoleco_libretro_ps3.SELF Coleco ColecoVision
/ROMS/O2EM o2em_libretro_ps3.SELF Magnavox Odyssey²
/ROMS/INTV/ freeintv_libretro_ps3.SELF Mattel IntelliVision
/ROMS/ZX81/ 81_libretro_ps3.SELF Sinclair ZX81
/ROMS/FUSE/ fuse_libretro_ps3.SELF Sinclair Spectrum (FUSE)
/ROMS/2048/ 2048_libretro_ps3.SELF 2048
/ROMS/CAP32/ cap32_libretro_ps3.SELF Amstrad - CPC (Caprice32)
/ROMS/CANNONBALL/ cannonball_libretro_ps3.SELF Cannonball
/ROMS/NXENGINE/ nxengine_libretro_ps3.SELF Cave Story (NXEngine)
/ROMS/DOS/ dosbox_libretro_ps3.SELF DOSBox
/ROMS/DOSBOX/ dosbox_svn_libretro_ps3.SELF
dosbox_libretro_ps3.SELF
DOSBox SVN
/ROMS/GME/ gme_libretro_ps3.SELF Game Music Emu
/ROMS/GW/ gw_libretro_ps3.SELF Handheld Electronic (GW)
/ROMS/JAVAME/
/ROMS/JME/
/ROMS/SQUIRREL/
squirreljme_libretro_ps3.SELF Java ME (SquirrelJME)
/ROMS/JUMP/ jumpnbump_libretro_ps3.SELF Jump 'n Bump
/ROMS/MU/
/ROMS/PALM/
mu_libretro_ps3.SELF Palm OS (Mu)
/ROMS/POKEMINI/ pokemini_libretro_ps3.SELF Portable Pokémon Mini
/ROMS/SCUMMVM/ scummvm_libretro_ps3.SELF ScummVM
/ROMS/THEODORE/ theodore_libretro_ps3.SELF Thomson MO/TO (THEODORE)
/ROMS/VECX/ vecx_libretro_ps3.SELF Vectrex
/ROMS/WSWAM/
/ROMS/WSWAMC/
mednafen_wswan_libretro_ps3.SELF WonderSwan

Not real RetroArch cores, but the following folders are also scanned under ROMS section. These can be used to show extra PlayStation games in a separated list or to allow list large catalogs taking the advantage of the large memory allocation of this section.

PATH REMARKS
/ROMS/PSXISO/ PlayStation CUE/BIN images
/ROMS/PS2ISO/ PlayStation 2 ISO images & PS2 Classics .BIN.ENC
/ROMS/PS3ISO/ PlayStation 3 ISO images
/ROMS/PSPISO/ PlayStation Portable ISO images

Cores formerly included in RetroArch but not supported on PS3:

PATH EMULATOR (Libretro Core) REMARKS
/ROMS/BK/ bk_libretro_ps3.SELF Elektronika - BK-0010/BK-0011(M)
/ROMS/BOMBER/
/ROMS/MRBOOM/
mrboom_libretro_ps3.SELF Bomberman (Mr.Boom)
/ROMS/ECWOLF/ ecwolf_libretro_ps3.SELF Wolfenstein 3D (ECWolf)
/ROMS/FREECHAF/ freechaf_libretro_ps3.SELF Fairchild ChannelF (FreeChaF)
/ROMS/GPSP/ gpsp_libretro_ps3.SELF Nintendo - Game Boy Advance (gpSP)
/ROMS/LUA/ lutro_libretro_ps3.SELF Lua Engine (Lutro)
/ROMS/DS/
/ROMS/DESMUME/
desmume2015_libretro_ps3.SELF Nintendo DS (DESMUME)
/ROMS/NEKOP2/ nekop2_libretro_ps3.SELF NEC - PC-98 (Neko Project II)
/ROMS/NP2KAI/ np2kai_libretro_ps3.SELF NEC - PC-98 (Neko Project II Kai)
/ROMS/QUAKE2/ vitaquake2_libretro_ps3.SELF iD Software - Quake2
/ROMS/TGBDUAL/ tgbdual_libretro_ps3.SELF Nintendo Gameboy (TGBDUAL)
/ROMS/UZEM/ uzem_libretro_ps3.SELF Uzebox (Uzem)
/ROMS/X1/ x1_libretro_ps3.SELF Sharp X1 (X Millennium)

The ROMS folder names listed on XMB are obtained from /dev_hdd0/tmp/wm_lang/LANG_ROMS.TXT

ROMS File Extensions

The supported ROMS extensions are defined in /dev_hdd0/tmp/wm_res/roms_extensions.txt

Each core in RetroArch defines the allowed file extensions in the info files.

PKGLAUNCH maps the emulator core based in the folder name. If the folder is not detected, a core will be mapped based on the file extension.

ROMS Alias

Since version 1.47.46e it's possible to show a custom game name read from gamelist.txt placed in the same folder of the ROMS. This feature is useful for emulators that use romsets with specific names like FBA or MAME.

This is an example of gamelist.txt. Add one game per line:

romfile1.ext [description 1]
romfile2.ext [description 2]
romfile3.ext [description 3]

Covers & Media Files

Since version 1.47.27 the ROMS support the display of the following custom media files when mounted:

The current covers of ROMS in PNG format will be used as ICON0.PNG (JPG will show the default icon)
<rom-full-path-without-file-extension>.PNG or <rom-full-path-without-file-extension>.png (320x176)
<rom-full-path-without-file-extension>.PIC1.PNG will be used as screen background [HD] (1920x1080)
<rom-full-path-without-file-extension>.PIC0.PNG will be used as overlay picture [HD only] (1000x560)
<rom-full-path-without-file-extension>.PIC2.PNG will be used as overlay picture [SD only] (310x250)
<rom-full-path-without-file-extension>.ICON1.PAM will be used for animated icon (320x176)
<rom-full-path-without-file-extension>.SND0.AT3 will be used for background music on XMB

Note: ICON1.PAM + SND0.AT3 should not exceed 2.4MB

Multi Gameboot Mod

webMAN MOD supports custom gameboot per system when a ROM is mounted. This feature uses the custom_render_plugin.rco from DeViL303's Multi Gameboot Mod

20 Gameboots Animations

This Mod is included in Ultimate Toolbox by DeViL303.

A multi gameboot package installer with gameboot animations per emulator for firmwares 4.84-4.88 and 4.89-4.91 can be installed manually or directly from the XMB online updater.

The file custom_render_plugin.rco must be copied to /dev_blind/vsh/resource
The patched game_ext_plugin.sprx, the sounds and media files should be copied to /dev_hdd0/tmp/gameboot.

The following media files are copied to PKGLAUNCH when a game is mounted:

***_ICON1.PAM, ***_SND0.AT3, ***_PIC0.PNG, ***_PIC1.PNG, ***_PIC2.PNG

*** is the 3 letter code of the emulator: rom, sns, nes, gba, gby, gen, neo, mam, fba, pce, ata, cmd, ids.