RiptOPL DOCS

Install & First Boot

RIPTOPL.ELF is a single self-contained executable โ€” no installer, no registry, no driver. Drop it where your PS2 boot method expects an ELF and you are done with the install step. This page covers exactly what to download, where to put it, what happens the first time it runs, and what the opinionated defaults mean for you.

What is RIPTOPL.ELF?

RiptOPL is a downstream fork of Open PS2 Loader compiled to a single PS2 ELF binary. The standard build includes everything in one file โ€” GSM video-mode handling, in-game screenshots (IGS), DS3/DS4 pad emulation (PADEMU), Virtual Memory Cards (VMC), PS2RD cheats, and parental controls. There are no per-feature variant builds to choose between; the one ELF does it all. DualSense / DualShock 5 (USB) support is the only optional extra, compiled in separately with make DUALSENSE=1 โ€” check the Releases page for the current variant availability.

โ„น Private config, shared data
RiptOPL saves its master settings to settings_riptopl.cfg โ€” a different filename from canonical OPL's conf_opl.cfg and from wOPL's config. That means RiptOPL, OPL, and wOPL can all sit on the same memory card without touching each other's settings. Everything else in the OPL/ folder โ€” cover art, themes, VMCs, per-game configs (CFG/), and the favourites.bin star list โ€” is shared across all builds that understand those formats.

Release channels

RiptOPL ships from two channels. Both are built by the same CI pipeline and produce the same package format; the only difference is stability vs. recency.

ChannelTagWhen to use
Rolling pre-release rolling Latest code from master, rebuilt on every push. Best for eager testers who want new features as they land. May be unstable โ€” release notes flag when the bleeding-edge toolchain build failed.
Tagged release v* (e.g. v1.2.0-Beta-โ€ฆ) Curated, known-good versions cut manually from a tag. Use these for a stable production install.

See Releases for the full asset listing, checksums, and pull instructions. The short version: download the RIPTOPL-<sdk>-<rel>-<sha>.zip installable package, unzip it, and use the APP_RIPTOPL/RIPTOPL.ELF inside.

What is inside the installable zip?

The RIPTOPL-<sdk>-<rel>-<sha>.zip package contains:

  • APP_RIPTOPL/RIPTOPL.ELF โ€” built with the ps2dev/ps2dev:latest (bleeding-edge) toolchain.
  • APP_RIPTOPL-OLDSDK/RIPTOPL.ELF โ€” built with the pinned/stable ps2max/dev toolchain. Use this if the latest build has a regression.
  • POPSTARTER/ and POPS/ folders โ€” structure for PS1 support. POPS.ELF (the PS1 emulator) is a Sony binary and is not distributed here. POPSTARTER.ELF is a third-party community launcher, also not distributed here. These folders are not strictly empty placeholders: the release may bundle SMB and BDMA module variants in them (see the VCD / PS1 docs).
  • neutrino_*.7z โ€” the bundled Neutrino external core archive used by the network-boot (UDPBD/UDPFS) subsystem (pre-populated with the UDPFS config). It is not the target of the Neutrino ELF Path setting; per-game Neutrino requires a separate neutrino.elf on a memory card.
  • SHA256SUMS.txt โ€” hashes of every binary in the release.

The bare RIPTOPL-<version>.ELF files (both toolchains) are also published separately if you only want to drop a fresh ELF over an existing install.

Getting RIPTOPL.ELF onto your PS2

RiptOPL requires a way to boot unsigned ELFs on the PS2. The two most common are FreeMcBoot (FMCB) on a memory card and FreeDVDBoot / FHDB on an internal HDD. Any method that can launch an ELF works.

1. Download the package

Go to the Releases page and grab either the latest rolling pre-release or the most recent v* tagged release. Download the RIPTOPL-*.zip installable package and unzip it locally.

2. Copy RIPTOPL.ELF to your boot location

Use the ELF from APP_RIPTOPL/RIPTOPL.ELF inside the zip. Where it goes depends on your boot method:

  • FMCB โ€” copy RIPTOPL.ELF to a folder on a USB drive, memory card, or SMB share, then add a FMCB menu entry pointing to it. A common convention is mass:/APPS/RIPTOPL/RIPTOPL.ELF or mc0:/RIPTOPL/RIPTOPL.ELF.
  • FHDB โ€” copy into an HDD partition the same way FHDB expects its launch targets.
  • Other launchers โ€” place the ELF wherever that launcher is configured to find it; RiptOPL has no path requirements of its own.

The ELF filename itself does not matter to RiptOPL, only to your launcher's menu entry.

3. (Optional) Place the Neutrino archive

The bundled neutrino_*.7z is only needed for network boot (UDPBD/UDPFS), where it is used by the network-boot subsystem (pre-populated with the UDPFS config) โ€” you do not place it manually or point the Neutrino ELF Path at it. For per-game Neutrino launching you supply neutrino.elf separately: place it at mc0:NEUTRINO/neutrino.elf or mc1:NEUTRINO/neutrino.elf (or set Neutrino Device / Neutrino ELF Path to a custom location) after first boot. See Neutrino Core.

4. Prepare your storage device

OPL expects a specific folder layout on whichever device(s) you plan to load games from. You do not need to create these by hand โ€” RiptOPL will auto-create them on first boot โ€” but it helps to know what they are:

DVD/      โ† DVD5 and DVD9 ISO images
CD/       โ† CD-based game images (blue-bottom discs)
ART/      โ† cover art images
CFG/      โ† per-game settings files
VMC/      โ† Virtual Memory Card images
THM/      โ† themes
LNG/      โ† language / translation files
CHT/      โ† PS2RD cheat files
APPS/     โ† homebrew ELF files

For the APA/PFS internal HDD, OPL uses hdd0:__common/OPL/ for the non-game folders. For exFAT HDD (BDMAssault) and all other folder-based devices (USB, MMCE, MX4SIO, iLink, SMB), the folders live at the root of the device.

โ„น Auto-creation on first boot
When you enable a device mode in OPL settings and exit back to the game list, OPL automatically creates any missing folders on that device. You do not need to pre-create DVD/, ART/, etc. manually โ€” just enable the device, save settings, and the directories will appear.

First boot walkthrough

Launch RIPTOPL.ELF

Boot through FMCB, FHDB, or your chosen launcher. The first thing you will see is the Coverflow theme โ€” RiptOPL's built-in cover-art carousel. The game lists will be empty until you enable a device and have games in the right folders.

Enable your device

Navigate to Settings โ†’ Device Settings. Enable the storage device(s) you want to use. USB is already on by default โ€” if you have a USB drive with games in DVD/ and CD/, it will appear immediately. For SMB, HDD, MMCE, MX4SIO, iLink, or network boot, enable the corresponding toggle and fill in any required details (IP address for SMB/network boot, etc.).

Save settings

Go to Settings โ†’ Save Changes (or the equivalent save action in the settings screen). This writes settings_riptopl.cfg to the config path and auto-creates the device folders. From this point on, RiptOPL remembers your preferences across boots.

Launch a game

Back on the main list, your games appear under the device tabs. Highlight a title and press Cross (or Circle for Japanese-layout controllers โ€” the confirm button follows standard OPL behavior and is configurable). The game boots via OPL's built-in core by default. To use Neutrino instead, open Game Settings โ†’ Loader Core โ†’ Neutrino for that title. See Per-game Settings.

Opinionated defaults

Unlike upstream OPL โ€” which ships with most features off and expects you to enable them โ€” RiptOPL boots with a set of opinionated defaults that are on from the very first launch, before you have saved any settings. You can change any of them under Settings at any time.

SettingDefaultWhere to change
Widescreen (16:9)ONDisplay Settings
Cover art displayONDisplay Settings
Notifications (popups)ONDisplay Settings
PS2 logo on bootONDisplay Settings
Sound effects (SFX)ON (volume 80)Audio Settings
Boot soundON (volume 80)Audio Settings
BGM (background music)OFFAudio Settings
USB deviceEnabledDevice Settings
iLink, MX4SIO, exFAT HDD, UDPBDOFFDevice Settings
Device start mode (all tabs)ManualDevice Settings
Video modeAuto (0)Display Settings / GSM
Default theme<Coverflow> (built-in)Theme Settings
Delete/rename gamesEnabledGeneral Settings
Visual GameID barcodeOFFDisplay Settings
UDPBD/UDPFS network bootOFFDevice Settings
โ„น "Manual" start mode
All device tabs start in Manual mode. This means each tab is always visible, and the game list only populates when you navigate to that tab and explicitly trigger a scan โ€” no automatic background scanning on boot. If you want a tab to scan automatically when OPL starts, change its start mode to Auto in Device Settings.

Config file: settings_riptopl.cfg

RiptOPL saves its master config as settings_riptopl.cfg. This is a renamed, private config that coexists on the same memory card or device as canonical OPL (conf_opl.cfg) and wOPL without either build touching the other's settings.

If you previously used an older RiptOPL build that saved as conf_riptopl.cfg, the new build automatically migrates your settings the next time it saves โ€” you do not need to rename anything manually.

The config file is discovered and written in this priority order (first found wins on read; saves always go back to the same path it was read from):

Everything else โ€” cover art (ART/), themes (THM/), VMC images (VMC/), per-game config files (CFG/), and favourites.bin โ€” lives in the shared OPL/ folder structure and is read and written by any OPL-family build that understands those formats. RiptOPL will import an existing favourites.bin from wOPL or uOPL on first launch.

Next steps