rpycdec

A tool for decompiling Ren'py compiled script files (.rpyc and .rpymc).

Features

Decompile .rpyc and .rpymc files to readable Ren'Py script code
Extract RPA archives
Create RPA archives from existing files or directories
Extract and edit Ren'Py save files (.save → JSON → .save)
Extract Ren'Py games from Android APK files
Extract translations from compiled scripts to tl/{language}/ directories
Support for multiple Ren'Py versions (7.x, 8.x)

Installation

Install with pip:

pip install rpycdec

Or install from source:

git clone https://github.com/cnfatal/rpycdec.git
cd rpycdec
pip install .

Usage

Command Line Interface

Decompile a single file:

rpycdec decompile script.rpyc

Decompile all files in a directory:

rpycdec decompile /path/to/game/

Extract RPA archive:

rpycdec unrpa archive.rpa

Extract files whose archive paths match a regular expression:

rpycdec unrpa archive.rpa -e '\.rpyc?$'

Extract files with one of several suffixes (case-insensitive):

rpycdec unrpa archive.rpa -s .rpy .rpyc

--expression/-e may be repeated, as may --suffix/-s. When both are used, a file is extracted if it matches any expression or any suffix.

Create RPA archive:

rpycdec rpa /path/to/game/files -o archive.rpa

Extract Ren'Py game from Android APK:

rpycdec extract-game game.apk

Extract translations:

rpycdec extract-translate /path/to/game/ -l Chinese

Security Warning

This tool processes .rpyc, .rpymc, .rpa, and .save files which use Python's pickle format internally. rpycdec uses restricted unpicklers with whitelist-based class loading to mitigate arbitrary code execution risks, but no pickle safeguard is perfect. Only process files from sources you trust.

Set RPYCDEC_NO_WARNING=1 to suppress the CLI security warning.

Troubleshooting

Q: Pickle error ModuleNotFoundError: No module named '...'

A: This means our fake renpy/store packages don't cover the class your file needs. Please open an issue with the Ren'Py version and the file that failed.

Contributing

Contributions are welcome! Please open an issue before submitting major changes so we can discuss the approach.

Community & Support

GitHub Issues — Bug reports and feature requests
Telegram Group — Community discussion and support

Alternative

unrpyc - The well-established and widely-used Ren'Py script decompiler

2.8 KiB Raw Blame History