Source file#
src/data/storageLayouts.json
[
{
"id": "usb-opl-apps-renamed-elf",
"name": "USB - OPL Apps per-game renamed ELF",
"storageBackend": "USB mass storage",
"launcherFrontend": "OPL Apps page",
"filesystem": "FAT32 32K/64K clusters, or exFAT through BDM Assault",
"requiredFiles": [
"Per-game VCD",
"Per-game renamed POPSTARTER.ELF",
"POPS_IOX.PAK",
"title.cfg"
],
"optionalFiles": [
"Per-game VMC folder",
"Hugopocked fixes",
"BDM Assault IRX replacements"
],
"exactPaths": [
"mass:/POPS/<Game>.VCD",
"mass:/POPS/<Game>/",
"mass:/POPS/POPS_IOX.PAK",
"mass:/APPS/<AppFolder>/<Prefix>.<Game>.ELF",
"mass:/APPS/<AppFolder>/title.cfg"
],
"sampleConfig": "title=[PS1] Soul Blade\nboot=XX.SLUS_002.40.Soul Blade.ELF",
"warnings": [
"The renamed ELF and VCD basename must match the launch method's expectations.",
"Do not store proprietary POPS files in this repository."
],
"sourceIds": [
"user-notes",
"elotrolado-pops-thread"
],
"confidence": "medium",
"verificationStatus": "verified-hardware-user"
},
{
"id": "usb-opl-db-ps1",
"name": "USB - OPL DB/Tenth PS1 page",
"storageBackend": "USB mass storage",
"launcherFrontend": "OPL DB / Tenth Anniversary PS1 page",
"filesystem": "FAT32 or exFAT through BDM Assault",
"requiredFiles": [
"POPSTARTER.ELF",
"Per-game VCD",
"POPS_IOX.PAK"
],
"optionalFiles": [
"Per-game VMC folder",
"Hugopocked fixes"
],
"exactPaths": [
"mass:/POPS/POPSTARTER.ELF",
"mass:/POPS/<Game>.VCD",
"mass:/POPS/<Game>/",
"mass:/POPS/POPS_IOX.PAK"
],
"sampleConfig": "",
"warnings": [
"Modern OPL fork behavior; do not present as original POPStarter core behavior."
],
"sourceIds": [
"user-notes"
],
"confidence": "medium",
"verificationStatus": "verified-hardware-user"
},
{
"id": "usb-wle-khn",
"name": "USB - wLE_kHn VCD launcher",
"storageBackend": "USB mass storage",
"launcherFrontend": "wLE_kHn",
"filesystem": "FAT32 or exFAT through BDM Assault",
"requiredFiles": [
"POPS_IOX.PAK",
"POPSTARTER.ELF",
"Per-game VCD",
"wLE_kHn ELF"
],
"optionalFiles": [
"Per-game VMC folder",
"Hugopocked fixes",
"title.cfg for OPL Apps launch of wLE_kHn"
],
"exactPaths": [
"mass:/POPS/POPS_IOX.PAK",
"mass:/POPS/POPSTARTER.ELF",
"mass:/POPS/<Game>.VCD",
"mass:/POPS/<Game>/",
"mass:/APPS/APP_wLE_kHn_20200810/wLE_kHn_20200810.ELF",
"mass:/APPS/APP_wLE_kHn_20200810/title.cfg"
],
"sampleConfig": "title=wLE_kHn_20200810 VCD Launcher\nboot=wLE_kHn_20200810.ELF",
"warnings": [
"User notes recommend omitting game IDs from VCD filenames for cleaner wLE_kHn lists."
],
"sourceIds": [
"user-notes",
"elotrolado-pops-thread"
],
"confidence": "medium",
"verificationStatus": "verified-hardware-user"
},
{
"id": "usb-pops0-through-pops9",
"name": "USB - POPS0 through POPS9 split folders",
"storageBackend": "USB mass storage",
"launcherFrontend": "Original POPStarter folder scan",
"filesystem": "FAT12/FAT16/FAT32; defragmented media strongly preferred",
"requiredFiles": [
"VCDs in mass:/POPS or mass:/POPS0 through mass:/POPS9",
"POPS_IOX.PAK in main mass:/POPS"
],
"optionalFiles": [
"BIOS.BIN",
"PATCH_#.BIN",
"TROJAN_#.BIN",
"VMCDIR.TXT",
"IGR TM2 textures"
],
"exactPaths": [
"mass:/POPS/POPS_IOX.PAK",
"mass:/POPS/<Game>.VCD",
"mass:/POPS0/<Game>.VCD",
"mass:/POPS1/<Game>.VCD",
"mass:/POPS9/<Game>.VCD",
"mass:/POPS#/BIOS.BIN",
"mass:/POPS#/PATCH_#.BIN",
"mass:/POPS#/TROJAN_#.BIN",
"mass:/POPS#/<Game>/CHEATS.TXT"
],
"sampleConfig": "",
"warnings": [
"POPStarter scans POPS, then POPS0 through POPS9.",
"POPS_IOX.PAK and IGR TM2 textures stay in the main POPS folder.",
"BIOS.BIN, PATCH_#.BIN, TROJAN_#.BIN, and VMCDIR.TXT do not propagate into POPS# folders; copy them into each split folder that needs them."
],
"sourceIds": [
"popsloader-docs-reference",
"shaolin-bitbucket-wiki"
],
"confidence": "high",
"verificationStatus": "recovered-cross-check"
},
{
"id": "usb-popsloader",
"name": "USB - POPSLoader app",
"storageBackend": "USB mass storage",
"launcherFrontend": "POPSLoader",
"filesystem": "FAT32 or exFAT through BDM Assault",
"requiredFiles": [
"POPSLoader ELF and POPSLDR folder",
"POPSTARTER.ELF",
"POPS_IOX.PAK",
"Per-game VCD"
],
"optionalFiles": [
"Box art PNG",
"Per-game VMC folder",
"Hugopocked fixes"
],
"exactPaths": [
"mass:/POPS/POPS_IOX.PAK",
"mass:/POPS/POPSTARTER.ELF",
"mass:/POPS/<Game>.VCD",
"mass:/POPS/<Game>/",
"mass:/APPS/PS1_POPSLDR/POPSLOADER.ELF",
"mass:/APPS/PS1_POPSLDR/POPSLDR/",
"mass:/APPS/PS1_POPSLDR/title.cfg"
],
"sampleConfig": "title=[PS1] !POPSLOADER\nboot=POPSLOADER.ELF",
"warnings": [
"POPSLoader behavior is a modern side project, not original core POPStarter behavior.",
"POPSLDR must stay next to the POPSLoader ELF according to the resource page."
],
"sourceIds": [
"user-notes",
"popsloader-el-isra"
],
"confidence": "high",
"verificationStatus": "verified-cross-source"
},
{
"id": "apa-hdd-opl-apps",
"name": "APA HDD - OPL Apps per-game renamed ELF",
"storageBackend": "Internal APA HDD/SSD",
"launcherFrontend": "OPL Apps page",
"filesystem": "PFS/APA",
"requiredFiles": [
"Per-game VCD",
"POPS.ELF",
"IOPRP252.IMG",
"Per-game renamed POPSTARTER.ELF"
],
"optionalFiles": [
"POPSTARTER.ELF for wLE_kHn style launch",
"POPS_IOX.PAK depending on workflow",
"Art in +OPL/ART"
],
"exactPaths": [
"hdd:/__.POPS/<Game>.VCD",
"hdd:/__common/POPS/IOPRP252.IMG",
"hdd:/__common/POPS/POPS.ELF",
"hdd:/__common/POPS/POPSTARTER.ELF",
"hdd:/+OPL/APPS/<Game>/<Game>.ELF",
"hdd:/+OPL/APPS/<Game>/title.cfg"
],
"sampleConfig": "title=[PS1] Soul Blade\nboot=SLUS_002.40.Soul Blade.ELF",
"warnings": [
"ElOtroLado warns OPL network start mode should not be Auto when launching HDD POPStarter via Apps, because black-screen hangs can occur.",
"__.POPS spelling matters."
],
"sourceIds": [
"user-notes",
"elotrolado-pops-thread",
"psx-place-popstarter-page-15"
],
"confidence": "high",
"verificationStatus": "verified-cross-source"
},
{
"id": "apa-hdd-opl-db",
"name": "APA HDD - OPL DB / PS1 page",
"storageBackend": "Internal APA HDD/SSD",
"launcherFrontend": "OPL DB / PS1 page",
"filesystem": "PFS/APA",
"requiredFiles": [
"Per-game VCD",
"POPS.ELF",
"IOPRP252.IMG",
"POPSTARTER.ELF",
"POPS_IOX.PAK"
],
"optionalFiles": [
"Per-game VMC folder",
"Hugopocked fixes"
],
"exactPaths": [
"hdd:/__.POPS/<Game>.VCD",
"hdd:/__common/POPS/IOPRP252.IMG",
"hdd:/__common/POPS/POPS.ELF",
"hdd:/__common/POPS/POPSTARTER.ELF",
"hdd:/__common/POPS/POPS_IOX.PAK"
],
"sampleConfig": "",
"warnings": [
"Modern OPL DB/Tenth behavior needs fork-specific verification.",
"A local screenshot reports hdd0:/__common/POPS/POPSTARTER.ELF worked as POPStarter path."
],
"sourceIds": [
"user-notes",
"discord-screenshot"
],
"confidence": "medium",
"verificationStatus": "verified-hardware-user"
},
{
"id": "apa-hdd-wle-khn",
"name": "APA HDD - wLE_kHn VCD launcher",
"storageBackend": "Internal APA HDD/SSD",
"launcherFrontend": "wLE_kHn",
"filesystem": "PFS/APA",
"requiredFiles": [
"wLE_kHn ELF",
"Per-game VCD",
"POPS.ELF",
"IOPRP252.IMG",
"POPSTARTER.ELF",
"POPS_IOX.PAK"
],
"optionalFiles": [
"Per-game VMC/fix folder",
"OPL Apps title.cfg for launching wLE_kHn"
],
"exactPaths": [
"mc0:/BOOT/BOOT.ELF",
"hdd:/__.POPS/<Game>.VCD",
"hdd:/__common/POPS/IOPRP252.IMG",
"hdd:/__common/POPS/POPS.ELF",
"hdd:/__common/POPS/POPSTARTER.ELF",
"hdd:/__common/POPS/POPS_IOX.PAK",
"hdd:/__common/POPS/<Game>/",
"hdd:/+OPL/APPS/wLE_kHn_20200810/wLE_kHn_20200810.ELF",
"hdd:/+OPL/APPS/wLE_kHn_20200810/title.cfg"
],
"sampleConfig": "title=wLE_kHn_20200810 VCD Launcher\nboot=wLE_kHn_20200810.ELF",
"warnings": [
"Use this as a launcher workflow, not as a different POPStarter storage backend.",
"__.POPS remains the VCD partition/path."
],
"sourceIds": [
"user-notes",
"elotrolado-pops-thread"
],
"confidence": "medium",
"verificationStatus": "verified-hardware-user"
},
{
"id": "apa-hdd-modern-pops0-through-pops9",
"name": "APA HDD - __.POPS through __.POPS9 split folders",
"storageBackend": "Internal APA HDD/SSD",
"launcherFrontend": "Modern WIP01/r13 HDD launch type",
"filesystem": "PFS/APA",
"requiredFiles": [
"__.POPS or __.POPS0 through __.POPS9 partitions/paths",
"__common/POPS with POPS.ELF and IOPRP252.IMG"
],
"optionalFiles": [
"POPSTARTER.ELF",
"POPS_IOX.PAK",
"Per-game support folder under __common/POPS"
],
"exactPaths": [
"hdd0:/__.POPS/<Game>.VCD",
"hdd0:/__.POPS0/<Game>.VCD",
"hdd0:/__.POPS9/<Game>.VCD",
"hdd0:/__common/POPS/POPS.ELF",
"hdd0:/__common/POPS/IOPRP252.IMG",
"hdd0:/__common/POPS/<Game>/CHEATS.TXT"
],
"sampleConfig": "",
"warnings": [
"Do not create +__.POPS; the leading plus is wrong for the POPStarter partition name.",
"Per-game VMC/fix folders go under __common/POPS, not beside the VCDs in __.POPS."
],
"sourceIds": [
"popsloader-docs-reference",
"elotrolado-pops-thread"
],
"confidence": "high",
"verificationStatus": "recovered-cross-check"
},
{
"id": "apa-hdd-legacy-pp-partition",
"name": "APA HDD legacy - PP.<game> HDDOSD-visible partition",
"storageBackend": "Internal APA HDD/SSD",
"launcherFrontend": "HDDOSD / Sony Browser 2.00 / legacy POPStarter KELF",
"filesystem": "PFS/APA partition",
"requiredFiles": [
"PP.<Game> partition",
"IMAGE0.VCD",
"POPSTARTER.KELF or matching launch entry"
],
"optionalFiles": [
"SYSTEM.CNF",
"HDDOSD sample metadata",
"Per-game VMC/fix files inside the partition workflow"
],
"exactPaths": [
"hdd0:/PP.<Game>/IMAGE0.VCD",
"pfs0:/IMAGE0.VCD",
"PP.<Game>.ELF or POPSTARTER.KELF launch entry",
"SYSTEM.CNF BOOT2 = pfs:/IMAGE0.VCD"
],
"sampleConfig": "BOOT2 = pfs:/IMAGE0.VCD\nVER = 1.00\nVMODE = NTSC",
"warnings": [
"Every partition-installed game image is named IMAGE0.VCD; game identity comes from the partition name.",
"Use PP.<name> for HDDOSD-visible installs; hidden __.<name> is a different legacy mode."
],
"sourceIds": [
"popsloader-docs-reference",
"shaolin-bitbucket-wiki"
],
"confidence": "medium",
"verificationStatus": "recovered-needs-hardware-check"
},
{
"id": "apa-hdd-legacy-hidden-partition",
"name": "APA HDD legacy - __.<game> hidden partition",
"storageBackend": "Internal APA HDD/SSD",
"launcherFrontend": "Legacy alternate POPStarter partition launch",
"filesystem": "PFS/APA partition",
"requiredFiles": [
"__.<Game> hidden partition",
"IMAGE0.VCD",
"Matching launch ELF"
],
"optionalFiles": [
"Per-game VMC/fix files inside the partition workflow"
],
"exactPaths": [
"hdd0:/__.<Game>/IMAGE0.VCD",
"pfs0:/IMAGE0.VCD",
"__.<Game>.ELF or matching legacy launch entry"
],
"sampleConfig": "",
"warnings": [
"Hidden __.<name> partition-installed games are not the same as the modern shared __.POPS VCD folder.",
"Do not rename the image away from IMAGE0.VCD inside a partition-installed game."
],
"sourceIds": [
"popsloader-docs-reference",
"shaolin-bitbucket-wiki"
],
"confidence": "medium",
"verificationStatus": "recovered-needs-hardware-check"
},
{
"id": "apa-jail-hybrid",
"name": "APA-Jail hybrid - Apps on exFAT, POPS on APA",
"storageBackend": "Internal APA HDD/SSD plus APA-Jail exFAT app side",
"launcherFrontend": "OPL Apps page",
"filesystem": "exFAT app paths plus APA/PFS POPS paths",
"requiredFiles": [
"App-side launcher on exFAT",
"VCD and POPS files on APA/PFS"
],
"optionalFiles": [
"POPS_IOX.PAK",
"Art"
],
"exactPaths": [
"exfat:hdd:APPS/<Game>/<Game>.ELF",
"exfat:hdd:APPS/<Game>/title.cfg",
"apa:hdd:/__.POPS/<Game>.VCD",
"apa:hdd:/__common/POPS/IOPRP252.IMG",
"apa:hdd:/__common/POPS/POPS.ELF",
"apa:hdd:/__common/POPS/POPSTARTER.ELF"
],
"sampleConfig": "title=Soul Blade\nboot=SLUS_002.40.Soul Blade.ELF",
"warnings": [
"POPStarter core does not support internal exFAT for VCD/POPS data; this is an app-side hybrid workflow."
],
"sourceIds": [
"user-notes"
],
"confidence": "medium",
"verificationStatus": "verified-hardware-user"
},
{
"id": "smb-opl-apps",
"name": "SMB - OPL Apps per-game renamed ELF",
"storageBackend": "SMB network share",
"launcherFrontend": "OPL Apps page",
"filesystem": "Host filesystem over SMB",
"requiredFiles": [
"Per-game VCD",
"POPS_IOX.PAK",
"SB-prefixed renamed POPSTARTER.ELF",
"OPL conf_apps.cfg",
"MC network modules"
],
"optionalFiles": [
"Per-game VMC folder on share",
"Hugopocked fixes",
"ART cover named for the SB-prefixed ELF"
],
"exactPaths": [
"PS2SMB:/POPS/<Game>.VCD",
"PS2SMB:/POPS/POPS_IOX.PAK",
"PS2SMB:/POPS/<Game>/",
"PS2SMB:/APPS/SB.<Game>.ELF",
"PS2SMB:/ART/SB.<Game>.ELF_COV.jpg",
"mc0:/OPL/conf_apps.cfg",
"mc?:/POPSTARTER/IPCONFIG.DAT",
"mc?:/POPSTARTER/SMBCONFIG.DAT",
"mc?:/POPSTARTER/poweroff.irx",
"mc?:/POPSTARTER/ps2dev9.irx",
"mc?:/POPSTARTER/ps2ip.irx",
"mc?:/POPSTARTER/ps2smap.irx",
"mc?:/POPSTARTER/smbman.irx",
"mc?:/POPSTARTER/smsutils.irx"
],
"sampleConfig": "Crash Bandicoot=smb:/APPS/SB.Crash Bandicoot.ELF\nCrash Bandicoot=smb0:/APPS/SB.Crash Bandicoot.ELF\n\nIPCONFIG.DAT:\n192.168.0.13 255.255.255.0 192.168.0.1\n\nSMBCONFIG.DAT:\n192.168.0.254 PS2SMB",
"warnings": [
"Some later OPL betas reportedly require smb0: instead of smb: in conf_apps.cfg.",
"Use .DAT, not .DAY, for IPCONFIG.DAT and SMBCONFIG.DAT.",
"Use poweroff.irx, not poweroff.irc.",
"The SMB share must allow writes for VMC creation/update.",
"SMB debug text is forced in SMB mode according to ElOtroLado."
],
"sourceIds": [
"user-notes",
"elotrolado-pops-thread"
],
"confidence": "high",
"verificationStatus": "verified-cross-source"
},
{
"id": "smb-direct-sb-launcher",
"name": "SMB - direct SB-prefixed POPStarter launcher",
"storageBackend": "SMB network share plus PS2-side ELF launch",
"launcherFrontend": "Direct renamed POPStarter ELF",
"filesystem": "Host filesystem over SMB",
"requiredFiles": [
"Shared POPSTARTER folder",
"Per-game VCD",
"POPS_IOX.PAK",
"SB-prefixed renamed POPSTARTER.ELF launched from PS2 side",
"MC network modules"
],
"optionalFiles": [
"Per-game VMC/fix folder on share",
"CHEATS.TXT",
"BIOS.BIN when legally supplied"
],
"exactPaths": [
"POPSTARTER share:/POPS/POPS_IOX.PAK",
"POPSTARTER share:/POPS/<Game>.VCD",
"POPSTARTER share:/POPS/<Game>/",
"<PS2-side launcher path>/SB.<Game>.ELF",
"mc?:/POPSTARTER/IPCONFIG.DAT",
"mc?:/POPSTARTER/SMBCONFIG.DAT",
"mc?:/POPSTARTER/poweroff.irx",
"mc?:/POPSTARTER/ps2dev9.irx",
"mc?:/POPSTARTER/ps2ip.irx",
"mc?:/POPSTARTER/ps2smap.irx",
"mc?:/POPSTARTER/smbman.irx",
"mc?:/POPSTARTER/smsutils.irx"
],
"sampleConfig": "IPCONFIG.DAT:\n192.168.0.13 255.255.255.0 192.168.0.1\n\nSMBCONFIG.DAT:\n192.168.0.254 POPSTARTER",
"warnings": [
"Do not confuse the PC/NAS POPSTARTER share with mc?:/POPSTARTER.",
"The SB. prefix selects SMB mode.",
"The share must be writable for VMC files."
],
"sourceIds": [
"elotrolado-pops-thread"
],
"confidence": "high",
"verificationStatus": "verified-single-source"
},
{
"id": "smb-opl-db-ps1",
"name": "SMB - OPL DB / PS1 page",
"storageBackend": "SMB network share",
"launcherFrontend": "OPL DB / PS1 page",
"filesystem": "Host filesystem over SMB",
"requiredFiles": [
"POPSTARTER.ELF",
"Per-game VCD",
"POPS_IOX.PAK",
"MC network modules"
],
"optionalFiles": [
"Per-game VMC/fix folder on share"
],
"exactPaths": [
"smb:/POPS/POPSTARTER.ELF",
"smb:/POPS/<Game>.VCD",
"smb:/POPS/POPS_IOX.PAK",
"smb:/POPS/<Game>/",
"mc?:/POPSTARTER/IPCONFIG.DAT",
"mc?:/POPSTARTER/SMBCONFIG.DAT"
],
"sampleConfig": "",
"warnings": [
"Modern OPL DB/PS1-page behavior needs fork-specific verification.",
"Keep this separate from the SB-prefixed OPL Apps workflow."
],
"sourceIds": [
"user-notes"
],
"confidence": "medium",
"verificationStatus": "verified-hardware-user"
},
{
"id": "bdm-assault-usb-exfat",
"name": "BDM Assault - USB exFAT driver substitution",
"storageBackend": "Memory card IRX override for USB",
"launcherFrontend": "POPStarter core or compatible launcher",
"filesystem": "exFAT USB through substituted USB drivers",
"requiredFiles": [
"bdm_assault.irx renamed to usbd.irx",
"usbd_bd_assault.irx renamed to usbhdfsd.irx"
],
"optionalFiles": [
"SYS-CONF copies for FreeMcBoot workflows"
],
"exactPaths": [
"bdm_assault.irx -> mc?:/POPSTARTER/usbd.irx",
"usbd_bd_assault.irx -> mc?:/POPSTARTER/usbhdfsd.irx",
"bdm_assault.irx -> mc?:/SYS-CONF/USBD.IRX",
"usbd_bd_assault.irx -> mc?:/SYS-CONF/USBHDFSD.IRX"
],
"sampleConfig": "",
"warnings": [
"This is USB driver substitution, not native internal exFAT support in POPStarter core.",
"BDM Assault releases are external; do not vendor binaries here."
],
"sourceIds": [
"bdm-assault",
"user-notes"
],
"confidence": "high",
"verificationStatus": "verified-primary"
},
{
"id": "popsloader-fork-devices",
"name": "POPSLoader fork - USB, MX4SIO, MMCE, APAHDD",
"storageBackend": "USB / MX4SIO / MMCE / APA HDD",
"launcherFrontend": "Ripto POPSLoader fork",
"filesystem": "Device-specific; PFS for HDD",
"requiredFiles": [
"POPSLoader app",
"POPSTARTER.ELF on a supported path",
"VCDs in device POPS folder or HDD __.POPS"
],
"optionalFiles": [
"200x200 8-bit non-interlaced RGB(A) PNG art",
"BDMA enabled for non-HDD devices"
],
"exactPaths": [
"mc0:/POPSTARTER/POPSTARTER.ELF",
"mass:/POPS/POPSTARTER.ELF",
"mx4sio:/POPS/POPSTARTER.ELF",
"mmce:/POPS/POPSTARTER.ELF",
"<device>:/POPS/<Title>.VCD",
"<device>:/POPS/<Title>.png",
"hdd:/__.POPS/<Title>.VCD",
"hdd:/__common/POPS/ART/<Title>.png"
],
"sampleConfig": "",
"warnings": [
"mc0 is required for settings and BDMA in the fork.",
"BDMA is required for all non-HDD devices and only one BDMA mode can be active at once."
],
"sourceIds": [
"popsloader-fork-ripto"
],
"confidence": "high",
"verificationStatus": "verified-primary"
}
]