RPX-KIT

Description

A toolkit for extracting or viewing only RPA-3.0 archives made with Renpy

Features

Safe Unpickling. Uses a custom SafeUnpickler that blocks all external imports during deserialization.

Zero Dependencies.

CLI Mask Filtering. Filter files directly using shell-style patterns (e.g., -m "*.png"). Extract or list only what you need without dumping the entire archive to disk first.

Cross-Platform. Works identically on Windows, Linux, and macOS. Path handling is abstracted via pathlib, so no slash-related issues.

Installation

Via pip

pip install rpx-kit

or

pip install git+https://github.com/Padorublad3/rpx-kit.git

Usage

rpx-kit [-l | -o DIR] [-m PATTERN]... INPUT_PATH

Arguments:
  INPUT_PATHS       Input .rpa archive(s) files or directory, better wrap them with quotes

Options:
  -l, --list       Print list of files contained in the archive
  -o, --output     Target directory for extraction (creates if missing)
  -m, --mask       Filter by fnmatch pattern (repeatable, e.g., -m "*.png")
  -v, --version    Print current version

Examples

List all PNG and JPG files:

rpx-kit mygame/archive.rpa -m "*.png" -m "*.jpg" -l

Save the list to a text file:

rpx-kit mygame/archive.rpa -m "*.png" -m "*.jpg" -l > result.txt

Extract only PNG and JPG files to a folder:

rpx-kit mygame/archive.rpa -m "*.png" -m "*.jpg" -o destination_folder

rpx-kit mygame/archive.rpa mygame/archive2.rpa -m "*.png" -m "*.jpg" -o destination_folder

rpx-kit mygame -m "*.png" -m "*.jpg" -o destination_folder

Mask Cheat Sheet

Masks use standard shell-style patterns (fnmatch). Remember to wrap them in quotes!

Tips:

1. Extensions: Always start with *. for extensions. ✅ -m "*.jpg" ❌ -m ".jpg" (looks for a file literally named .jpg)
2. Paths vs Names: Masks work on both full paths and filenames.
   • -m "images/*" finds everything inside the images/ folder.
   • -m "bg_*" finds any file starting with bg_, regardless of its folder.
3. OR Logic: Multiple -m flags are combined with OR.

Disclaimer

This program is intended for people who have the legal rights or the consent of the target app authors to access or decompress the archive files. Any illegal or otherwise unintended usage of this software is discouraged and unsupported.

Credits

This software was developed with orientation on Ren'Py's source code for working with RPA files. Credits for the development of the Ren'Py archive format belong to the contributors of the Ren'Py project.

Support

If this tool saved you time, consider supporting the developer:

ERC-20 0x8BA3456DBf94891881204ECB7a0f2fbdb6228D8A

SOL H93HCZ1KqvnmAgDh9Enyi2xgUnXXXA5yb7uDxeshQJq