RiptOPL DOCS

Favourites

Press R3 on any game or app to star it. A virtual Favourites page gathers every starred title from every connected device into one list โ€” no matter which drive it lives on.

โ„น Favourites Start Mode is Manual by default
The Favourites tab ships enabled in Manual mode under Device Settings โ†’ Favourites Start Mode. Leave it on Manual to show the tab and control it yourself, switch it to Auto to have OPL manage it the same way it manages other device tabs, or set it to Off to hide the tab and disable R3 entirely.

Quick start

Enable the Favourites tab

Open Settings โ†’ Device Settings and set Favourites Start Mode to Manual (or Auto). Save settings. A Favourites tab now appears alongside your device pages.

Star a game

Navigate to any game or app on any device page โ€” USB, HDD, SMB, MMCE, anywhere. Highlight the title and press R3 (click the right analogue stick). A small star icon appears next to the title name to confirm it is starred. Press R3 again on the same title to remove the star.

Open the Favourites page

Switch to the Favourites tab. Every starred game you have, across all connected devices, appears here in one list. Cover art, per-game settings, Options โ€” everything works exactly as it does on the source device page.

Launch normally

Select a title on the Favourites page and press Cross to launch it. The game boots through the same path it would on its source device (OPL core or Neutrino, depending on your per-game settings).

How it works

The Favourites page is a virtual aggregator โ€” it does not copy or move games. Each entry is a live proxy to the original item on its source device list. Launching, cover art lookups, per-game config, and the Options/Info menu all forward to the source device as if you had selected the game there directly.

Persistence and compatibility

Starred games are stored in favourites.bin, written into the same shared OPL config directory as your artwork, themes, and VMCs โ€” typically mc0:/OPL/ or the root of whichever device holds your OPL config.

โ„น Shared with uOPL and wOPL
favourites.bin sits in the shared OPL folder, not in the RiptOPL-private settings area. If you have an existing favourites.bin written by uOPL or wOPL, RiptOPL will read it automatically on first boot and carry your starred games over. Your favourites will then be saved in RiptOPL's own versioned OFAV format on the next write. That OFAV format is RiptOPL's own โ€” uOPL and wOPL cannot read it back, so the carry-over is one-way only.

The on-disk format uses an OFAV magic header, a version number, and an explicit record count, followed by one record per favourite. Every field is written as an explicit scalar (no raw struct dumps), and the reader validates the header, version, record count, and every text-length field before accepting a file โ€” a corrupt or truncated favourites.bin is rejected cleanly rather than causing a crash or out-of-bounds read.

FieldValue / limit
File namefavourites.bin (shared OPL config dir)
Format magicOFAV (0x4641464F, little-endian)
Format version1
Maximum favourites512 entries
Maximum title length255 characters + NUL (256 bytes)
Import from uOPL / wOPLAutomatic, read-only (one-way carry-over)

Device Settings options

Favourites has one option in Settings โ†’ Device Settings:

SettingValuesNotes
Favourites Start Mode Off / Manual / Auto Off hides the tab and disables R3 entirely. Manual (default) shows the tab but does not auto-start into it. Auto behaves like Auto mode on a regular device tab.
โ„น R3 only works when Favourites Start Mode is on
When Favourites Start Mode is set to Off, pressing R3 does nothing โ€” no star is set and nothing is written to disk. Enable the tab first.

Theme support

The Favourites page renders using the favsMain element family (which falls back to the regular game-list main family when the theme defines no favsMain override). The star mark drawn beside favourited titles in any list uses the embedded fav_mark texture. Themes can override the appearance of the Favourites tab icon via the fav texture slot.

App favourites (items sourced from the Apps tab) are handled specially: they use the apps theme element family (correct art box geometry and case overlay) rather than the game-cover family, so a favourited app looks right even on the Favourites page.

For full details on element families and texture slots, see the Theme Engine reference.

What happens to a favourite when a device is not connected?

The record stays in favourites.bin โ€” it is never deleted just because the source device is absent. When you open the Favourites tab, RiptOPL tries to resolve each stored entry against the currently loaded device lists. Any entry whose device is not available (drive unplugged, share offline, etc.) is simply hidden from the visible list. The moment that device is connected and its game list loads, the entry becomes visible again automatically โ€” no action needed on your part.

Can I favourite a PS1 (VCD) game?

Yes. PS1 titles shown in the VCD view (accessed with L3 on a device page) can be starred with R3 just like PS2 games. They appear in the Favourites list and launch through POPSTARTER the same way they do from their source device. See PS1 Games (VCD) for how the VCD view works.

Can I favourite a Neutrino-backed game?

Yes. Neutrino per-game settings are stored in the game's own per-game config file, not in the Favourites list. A favourited game that is set to use Neutrino will still launch via Neutrino when opened from the Favourites page, because the launch path proxies to the source device entry with all its settings intact.