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
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.
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.cfgandSCR43.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
RIPPS2 installs these themes over the network itself, one at a time, with no PC and no zip:
- STATUS > Downloads and Updates shows how many themes you have (
2 themes installed) before anything goes online. - CHECK FOR UPDATES starts the network and asks GitHub what is on this repo's rolling release.
- 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
THMfolder that are not on the release (yours, or a RiptOPL theme you copied over), so you can see everything you have in one place. - Cross installs that one theme into
THMon 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. - 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.
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.
- Fork this repo and put your theme in
themes/thm_<Name>/: itsconf_theme.cfg, images, fonts and optionalsound/, all in that one folder (the PS2 reads one folder). - 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>). - 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. - 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).
- Once it is tested and merged, it gets its line in
tools/make_release_assets.py, its.tarandthemes.txtline go on the rolling release, its GIF goes in RIPPS2'smedia/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.
| 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.
- 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...).
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. |
| 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








