Skip to content

About

Themes for RIPPS2/RiptOPL, the PS2 front end: Adapt and Adapt Rx, each on its own on the rolling release so RIPPS2's THEMES page installs them over the network. Submit yours by pull request.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

 
 

Latest commit

 

History

64 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

English | Español | Português (Brasil) | Português | Français | Deutsch | Italiano | Nederlands | Dansk | Svenska | Polski | Čeština | Hrvatski | Srpski | Български | Русский | Ελληνικά | Magyar | Română | Galego | Shqip | Türkçe | العربية | فارسی | 日本語 | 한국어 | 简体中文 | 繁體中文 | Tiếng Việt | ລາວ | Bahasa Indonesia | Filipino | Cebuano

RIPPS2 site · repo · download · psx-place
BIBLE site · repo · download · psx-place
RIPPCSX2 site · repo · download · psx-place
Themes · Fonts · Discord · Media

RIPPS2: the dead elf in its blue hat

RIPPS2 themes

Theme RIPPS2 without touching its code.
Every look in RIPPS2 is a theme folder away: a conf_theme.cfg, 8-bit PNGs, fonts and sounds.
No ELF to rebuild. Rely on the build, theme it.

AI agent friendly: read AGENTS.md

Claude Code GitHub Copilot Cursor OpenAI Codex Gemini CLI Windsurf JetBrains AI Zed

Written for people and coding agents alike: AGENTS.md holds the rules (CLAUDE.md, GEMINI.md and .github/copilot-instructions.md point to it), THEME_KEYS.md everything the engine does, and the tools check a theme before it gets near a PS2.

Download the themes (Adapt, Adapt Rx; edition 136, 11/03/2026: the source name over the list with the sidebar, Pop In alone with the categories across the top; two files a theme, conf_theme.cfg and SCR43.png, everything else RIPPS2's own; one release, always the newest) | needs RIPPS2 build 115 or later (its built-in font, badges, case and busy mark) | RIPGRID and RIPFLOW are built into RIPPS2: nothing to copy | RIPPS2, the PS2 front end | show your theme or ask about one in the RIPPS2 thread on psx-place

Straight to the PS2: the THEMES page (RIPPS2 build 162 and later)

RIPPS2 installs these themes over the network itself, one at a time, with no PC and no zip:

  1. STATUS > Downloads and Updates shows how many themes you have (2 themes installed) before anything goes online.
  2. CHECK FOR UPDATES starts the network and asks GitHub what is on this repo's rolling release.
  3. THEMES lists every theme there with its size and a short blurb, each one Current, Update or Not installed, and below them, Added by hand: the themes in your THM folder that are not on the release (yours, or a RiptOPL theme you copied over), so you can see everything you have in one place.
  4. Cross installs that one theme into THM on your drive. It comes over HTTPS, is checked against GitHub's SHA-256 digest, and replaces the old folder only once it is whole, so a cut download keeps the theme you had.
  5. Pick it in Settings > Interface > Theme.

The release carries each theme as its own thm_<Name>.tar plus themes.txt (one line a theme: file, folder, name, blurb), and nothing else: to install one by hand, unpack its .tar into your THM folder. A theme on the release is on every RIPPS2's THEMES page the next time it checks.

The pillars rise at boot, the game list comes up, and START opens the menu over them STATUS, CHECK FOR UPDATES, and Downloads and Updates The THEMES page: each theme Current or Update, with its size

Adapt Adapt: each game's art under frosted glass, the list on clear glass beside it. Adapt Rx Adapt Rx: Adapt mirrored, the list on the left and the case on the right. RIPPS2 RIPPS2 (built in): the game list in glass over the pillars.
RIPFLOW RIPFLOW (built in): the games as a flow of covers. RIPGRID RIPGRID (built in): the games as a grid of tiles over the chosen game's art.

Get your theme on the release (and on every RIPPS2's THEMES page)

Theme makers are welcome, RiptOPL theme makers included: a RiptOPL theme already runs on RIPPS2's engine, and THEME_KEYS.md adds what RIPPS2 can do on top.

  1. Fork this repo and put your theme in themes/thm_<Name>/: its conf_theme.cfg, images, fonts and optional sound/, all in that one folder (the PS2 reads one folder).
  2. Follow AGENTS.md: the creation header at the top of conf_theme.cfg (name, maker, created and updated dates, every asset's maker), the key glossary, every PNG 8-bit palette (python3 tools/png8.py themes/thm_<Name>).
  3. Check it: python3 tools/check_theme.py themes/thm_<Name> with no errors, then run it in PCSX2 (System > Start File, RIPPS2.elf) or on a PS2: layout, motion and fades only show there.
  4. Open a pull request with the theme's name, a one-line blurb for the THEMES page, the RIPPS2 build you tested on, and a short clip or a few screenshots in the pull request itself (pictures are not committed to the repo).
  5. Once it is tested and merged, it gets its line in tools/make_release_assets.py, its .tar and themes.txt line go on the rolling release, its GIF goes in RIPPS2's media/themes, and RIPPS2's THEMES page offers it to everyone. Its maker is credited in its header and in themes/README.md.

Questions or a theme to show first: Discord or the RIPPS2 thread on psx-place.

The themes

Theme Look Needs RIPPS2
Adapt / Adapt Rx akilluminati47's Adapt (RiptOPL): each game's art under frosted glass (zoomed, not stretched, in 16:9) with Adapt's side bar as a frosted strip on the left, the game's cover in RIPPS2's case with its reflection and the disc on one side, the list on clear glass on the other (Rx swaps the list and the case, and puts LAUNCH DISC at the right of the bar, over its disc). The disc always sits right under LAUNCH DISC. Info page on clear glass with 4:3 screenshots, tipping with the right stick as one sheet; page morphs between them, Settings over the pillars, no towers on the game pages. No sounds of their own (from 10/12/2026): your AUDIO folder rips play. The source name pops in (from build 81 as a toast: ALL GAMES, HDD GAMES...). From edition 113 the three categories are glyphs in the frosted side bar (category_layout=sidebar, build 113): Left on the list opens each one's drawer beside it. From edition 115 each theme is its conf_theme.cfg and SCR43.png. The game list's case shows the front cover, then the back, crossfading; the info page puts its text on the other side from the list's (Adapt right, Adapt Rx left). build 80
RIPGRID (built into RIPPS2 from build 91: pick it in Settings > Interface > Theme) Adapt's frosted screen and side bar with the games as a 4x2 cover grid, centred; the selection breathes with a soft glow and tips with the right stick, games without a cover show their serial in pixel type, and Circle cycles the sources. A 0.42 s right-stick hold turns the chosen case over to its back cover (build 97; it stays turned), pages slide in and out on L2 / R2 or at a row's edge, the game's disc pops in as it launches, and the chosen game's name sits under the grid in RIPPS2 Sleek Bold. It ships inside the ELF, so it is no longer in this pack. built in

Install: copy a thm_... folder into a THM folder on your drive (USB, HDD, MMCE, memory card), as for any OPL theme, then pick it in RIPPS2's Settings > Interface > Theme, or hold SELECT on the game list for 4.2 seconds to step through the themes. RIPGRID and RIPFLOW are already there.

Every conf_theme.cfg here opens with its creation header (name, maker, created and updated dates, credits), then the key glossary (docs/key_glossary.cfg: every key a theme can use, as comments), then the theme. Copy the glossary into your own theme's config to keep it at hand.

On the console

  • Hold SELECT for 4.2 seconds on the game list to step to the next theme (a quick press still refreshes the list).
  • Right stick tips the art: the whole info page as one plane, Adapt's case and disc, RIPGRID's chosen cover.
  • RIPGRID (built in): the D-pad moves through the grid, a row's edge turns the page; Circle cycles the sources (USB, HDD, ALL GAMES...).

Make your own

docs/THEME_KEYS.md is the whole engine, as of RIPPS2 build 100, all of it reachable from a theme folder:

What a theme can do
Look Frosted glass panels over each game's art, a full-screen frosted layer, side bars, clear glass, a cover Grid, RIPPS2's case with a reflection, 4:3 screenshots on 16:9, wide-crop backgrounds, towers on or off.
Motion Right-stick tilt that moves a whole page as one sheet (or one cover), page morphs between the list and the info page, art that eases in, descriptions that roll, info-page slideshows, the source name as a toast.
Fonts 16 font slots, your .ttf or RIPPS2's built-in faces, in capitals or not; the slots RIPPS2's own pages draw with, so a theme restyles menus, the category bar and the view word too.
Colour The theme's colours, and its own Colors and More: colour theme (RIPPS2, Ember, Blood, Ectoplasm, Amethyst, Bone), category bar, hints, glyphs, category order. The user always gets the last word.
Images Any of RIPPS2's own images (button glyphs, badges, loaders, the flying mark, the PS1 / PS2 logos) replaced by shipping a PNG of the same name.
Sound A sound/ folder with any of the 15 events (boot, cursor, confirm, page in and out, launch, disc...) and sound/bgm.ogg for its own music.

The kit

AGENTS.md The rules: read first.
docs/THEME_KEYS.md Everything RIPPS2's engine does for a theme: keys, elements, fonts, effects, images, sounds.
docs/THEME_ENGINE_RiptOPL.md The engine underneath (RiptOPL's reference).
docs/key_glossary.cfg Every key on one page, as # comments: the glossary at the top of each conf_theme.cfg here.
tools/check_theme.py Will it load? Numbering, types, missing files, misplaced keys, values RIPPS2 knows, 8-bit images.
tools/mirror_theme.py Draft the other-side layout of a theme.
tools/png8.py Make every image an 8-bit palette PNG: RIPPS2 keeps those as 8-bit textures, a quarter of the VRAM.
tools/gen_adapt_family.py Writes Adapt and Adapt Rx from one layout, each with its header and the glossary (edit it, not their conf_theme.cfg; set its EDITION_DATE when they change).
python3 tools/check_theme.py themes/*
python3 tools/png8.py themes/thm_MyTheme
python3 tools/mirror_theme.py "themes/thm_Adapt" "themes/thm_Adapt Rx" "Adapt Rx"

Python 3, with Pillow and numpy (pip install pillow numpy) for png8.py. Then look at it for real: in PCSX2 (System > Start File, RIPPS2.elf) with the theme on its virtual drive, or on a PS2.

RIPPS2 site · repo · download · psx-place
BIBLE site · repo · download · psx-place
RIPPCSX2 site · repo · download · psx-place
Themes · Fonts · Discord · Media

About

Themes for RIPPS2/RiptOPL, the PS2 front end: Adapt and Adapt Rx, each on its own on the rolling release so RIPPS2's THEMES page installs them over the network. Submit yours by pull request.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages