RiptOPL DOCS

Getting Started

From nothing to your first game running โ€” pick a storage device, place your files, enable the device, and launch. The whole process takes about ten minutes.

โ„น Already installed RiptOPL?
If RIPTOPL.ELF is already on your PS2 and booting, skip ahead to Pick a device. If you still need to get the ELF onto your console, start with Install & First Boot first.

What you need

Which release should I download?

The rolling pre-release is rebuilt from master on every push and always includes the bundled Neutrino core. It may occasionally be unstable. Tagged v* releases are manually cut, known-good snapshots. Either way, the full installable package zip (RIPTOPL-<sdk>-<rel>-<sha>.zip) contains the ELF, the bundled Neutrino archive, and a language pack โ€” download the zip rather than a bare ELF if you intend to use Neutrino or per-game language overrides. See Releases for details.

Pick a device

RiptOPL supports eight storage backends. Choose whichever matches your hardware:

DeviceWhat it needsWhere to go next
USBUSB drive formatted FAT32 or exFAT, plugged into the PS2's USB portUSB / MX4SIO / iLink
MX4SIOMX4SIO adapter + SD card in the memory-card slot (FAT32 or exFAT)USB / MX4SIO / iLink
MMCESD2PSX, MemCard PRO2, or compatible MMCE device in the memory-card slotMMCE
iLinkIEEE 1394 (FireWire) SBP2 storage deviceUSB / MX4SIO / iLink
SMBA network share on a PC or NAS (SMBv1); PS2 needs a network adapterSMB
Internal HDD (APA)Internal ATA HDD formatted with APA/PFS โ€” classic PS2 HDD setupInternal HDD
Internal HDD (exFAT)Internal ATA HDD formatted exFAT โ€” BDM path, same folder layout as USBInternal HDD
Network boot (UDPBD / UDPFS)PS2 network adapter + a PC running the server; requires NeutrinoNetwork Boot
โ„น Simplest first-time choice
A USB drive is the fastest path to a first working game. Format it FAT32 (or exFAT for drives over 32 GB), plug it in, and follow the steps below.

The OPL folder structure

All folder-based devices โ€” USB, MX4SIO, MMCE, iLink, SMB, and an exFAT HDD โ€” share the same directory layout under a root OPL/ folder (or at the root of the device, depending on your setup). RiptOPL creates these folders automatically the first time it boots and you enable a device โ€” you do not need to create them by hand.

DVD/        PS2 DVD games (ISO, ZSO, or USBExtreme ul.* split files)
CD/         PS2 CD games (ISO, ZSO โ€” blue-bottom discs)
ART/        Cover art images (game-id_COV.png, game-id_ICO.png, etc.)
CFG/        Per-game configuration files (saved by OPL automatically)
VMC/        Virtual Memory Card images (8 MB โ€“ 64 MB .bin files)
THM/        Theme folders
LNG/        Translation files
CHT/        PS2RD cheat files (.cht)
IMG/         PS2RD prebuilt cheat image files (game-id.img)
APPS/       Homebrew ELF applications
โ„น APA/PFS HDD is different
An APA-formatted internal HDD stores games as HDLoader partitions, not as files in DVD/ or CD/. The CFG/, ART/, VMC/, THM/, CHT/, LNG/, and APPS/ folders still apply, but they live under hdd0:__common/OPL/. See Internal HDD for the full workflow.

Supported game image formats

Walk-through: USB to first launch

These steps use USB as the example โ€” the pattern is identical for every folder-based device.

1. Prepare the drive

Format your USB drive as FAT32 (for drives up to 32 GB) or exFAT (larger drives or games over 4 GB). Use the default allocation unit size when formatting exFAT. Create a DVD folder at the root of the drive (or let OPL create it on first boot), then copy your game ISO into it:

USB root
โ””โ”€โ”€ DVD/
    โ””โ”€โ”€ My Game Title.iso

For games larger than 4 GB on a FAT32 drive, use USBExtreme / USBUtil to split them into ul.* files in DVD/ instead. On exFAT you can use a plain ISO regardless of size.

2. Plug in and boot RiptOPL

Connect the USB drive to the PS2's USB port, then launch RIPTOPL.ELF from your homebrew launcher (FMCB, FHDB, or equivalent). RiptOPL boots directly into the Coverflow game list. The first boot also creates any missing OPL folders on the drive automatically.

3. Enable USB in Device Settings

RiptOPL ships with USB enabled by default. If your game list is empty, confirm USB is on:

  1. Press Start to open the main menu.
  2. Navigate to Device Settings.
  3. Ensure USB Games is set to On.
  4. Press Cross to confirm and return (on Japanese consoles, Circle confirms โ€” the confirm button follows the console's regional convention).

The game list refreshes and your title should now appear in the Coverflow carousel.

4. Launch a test game

Scroll to your game in the Coverflow list (left / right on the D-pad or left stick), then press Cross to launch it. OPL loads the game using its built-in OPL core by default. If the game boots successfully, you are done.

If the game freezes or does not boot, open Game Settings for that title (highlight it, press Triangle) and try enabling compatibility modes one at a time. See Per-game Settings for a full explanation of the compatibility flags.

5. Save your settings

After a successful launch, go back to the main menu (press Start) and choose Save Changes. This writes settings_riptopl.cfg to your storage device so RiptOPL remembers your configuration on every subsequent boot.

โ„น Where the config file lives
RiptOPL saves its master config as settings_riptopl.cfg โ€” distinct from upstream OPL's conf_opl.cfg. Both builds can share the same memory card or storage device without overwriting each other's settings. Art, themes, VMCs, per-game configs, and favourites in the shared OPL/ folders are visible to all OPL builds.

Where to go next

You have a working game. Here are the most common things to set up next:

Can I use RiptOPL alongside stock OPL or wOPL on the same memory card?

Yes. RiptOPL saves its master config as settings_riptopl.cfg โ€” not conf_opl.cfg โ€” so the two builds never overwrite each other's settings. Everything else in the shared OPL/ folder (artwork, themes, VMCs, per-game configs in CFG/, and favourites.bin) is shared between all OPL-family builds. RiptOPL will also auto-import an existing uOPL / wOPL favourites.bin on first run.

Do I need Neutrino to play games?

No. RiptOPL ships with OPL's built-in core, which handles the vast majority of PS2 games without any extra setup. Neutrino is an optional external core you can assign per game for titles that benefit from it โ€” for example, those that need its compatibility modes or network-boot features (UDPBD / UDPFS). See Neutrino Core for details. Neutrino is bundled inside the release zip and does not need to be downloaded separately.

My game list is empty after enabling a device. What do I check?

First confirm the game files are in the correct folder on the device: DVD/ for DVD images, CD/ for CD images. OPL is case-sensitive โ€” dvd is not the same as DVD. Also check that the image extension is .iso or .zso, and that the drive is plugged in before RiptOPL boots. For FAT32 drives, games over 4 GB must be in USBExtreme format. See Troubleshooting for further diagnostic steps.