-
Notifications
You must be signed in to change notification settings - Fork 2
Interface Behaviors
Menu behaviours that are configured from Settings but need more than a one-line description: folder browsing, the parental lock, and the audio system.
For the button map, see CONTROLS.md.
Settings → General & System → Browse Folders in Game List. Off by default.
With it on, subfolders of CD/ and DVD/ appear in the game list as browsable entries instead of
the loader flattening everything into one long list.
- Folder rows sort to the top of the list, ahead of games, and are drawn with a trailing
/. Within each group, entries sort by title. - Select opens a folder; the cancel button goes back up a level. Which face button that is depends on your Select button setting.
- A folder row has no info page and no per-game settings, so Square and Triangle do nothing on one.
Folder browsing works on BDM devices (USB, MX4SIO, iLink, exFAT HDD), MMCE, and UDPFS in Files mode.
It does not apply to:
| Device | Why |
|---|---|
| APA/PFS HDD | Stores games as HDLoader partitions; there is no CD/DVD directory tree to scan |
| PS1 / VCD list | Same — the VCD view is not a directory scan |
| UDPFS block device | Block transport, not a file tree |
| SMB / ETH |
Deferred, not yet supported. SMB paths use a different separator (\) from the loose-file scanners |
Turning the setting on simply has no effect on those pages.
Parental Lock Password, on Settings → General & System. Sets a password that must be entered before configuration can be changed. Leave it blank to disable the lock.
The parental lock guards configuration and destructive actions, not game launching. Anyone can still start any game on the list. Behind the password:
- Settings, and the per-game / per-app settings screens (Triangle on a title)
- Rename and Delete on a game entry
- Network compatibility update and Start NBD Server
It is not a content filter. If your aim is to stop a particular game being played, the parental lock will not do it — it stops the library being changed, not played.
To set one, enter a password and save. To remove one, clear the field and save — RiptOPL confirms with "Parental lock disabled."
Entering the correct password unlocks for the rest of the session: RiptOPL stops asking until the next restart, so you are not re-prompted between one settings screen and the next.
A master override password exists for a forgotten lock. Two things about it are worth knowing:
- It does not grant one-time access — it deletes the stored password and saves immediately, showing "Parental lock disabled." After that there is no lock until you set a new one.
- It cannot be chosen as your own password. Trying is rejected with "Error - this password cannot be used."
The value itself is not printed here, matching the documentation site's convention of pointing people at the community forums for it.
Settings → Audio Settings.
BGM is Ogg Vorbis (.ogg). RiptOPL streams it rather than loading it into memory, so a long
track costs no extra RAM. It looks in this order and takes the first that works:
-
<theme>/sound/bgm.ogg— a disk theme's own music. - The Default Theme Music path from Audio Settings.
-
THM/bgm.oggunder the active settings home — built-in themes only (<OPL>and<Coverflow>). A disk theme never falls through to this.
That order is why a disk theme with its own sound/bgm.ogg ignores your Default Theme Music setting:
the theme wins. To use your own track everywhere, pick a theme that ships no music of its own.
SFX are PS2 ADPCM (.adp, 44.1 kHz), supplied by the theme in its sound/ folder. There are
eight:
| File | Played when |
|---|---|
boot.adp |
RiptOPL starts (the Boot Sound setting) |
cursor.adp |
Moving the cursor |
confirm.adp |
Confirming |
cancel.adp |
Going back |
message.adp |
A message or dialog appears |
transition.adp |
Changing screen |
bd_connect.adp |
A block device is connected |
bd_disconnect.adp |
A block device is removed |
The two built-in themes use effects embedded in the ELF and read nothing from the card. A disk theme supplying only some of the eight falls back to the built-in sound for the rest.
Sound effects, the boot sound, and background music each have their own on/off switch and their own volume. See THEME_ENGINE.md for packaging audio with a theme.
- CONTROLS.md — the button map, including menu rumble
- THEME_ENGINE.md — theme-supplied audio
Related guide: Settings.
Source: docs/INTERFACE.md @ 3ce281b0793c.
Start here
Storage and networking
- USB, MX4SIO and iLink
- MMCE
- Internal HDD: APA and exFAT
- SMB shares
- Network boot: UDPFS and UDPBD
- HTTP
- NBD server
Games and features
- Neutrino core
- PS1: POPStarter and Ember
- Per-game settings
- Virtual memory cards
- GSM video modes
- In-game reset
- Cheats
- PADEMU
- RetroAchievements
- Apps
Interface and customization
Help and reference
- Troubleshooting
- ZSO format
- Backward-compatible PS3
- Credits and sources
- Features in other forks
- Project overview
Detailed references
- Complete repository guide
- Rolling release reference
- APA hard disk safety and code 402
- Autolaunch and global settings
- Controls reference
- GSM reference
- HTTP reference
- In-game reset reference
- Folders, parental lock and audio
- Language maintenance
- MX4SIO launch reference
- Neutrino reference
- PADEMU reference
- RetroAchievements reference
- Theme engine: full authoring reference
- PS1/VCD reference
- HTTP server conformance tools
- APA recovery tool