Skip to main content

Extract files from the RPA archive format (from the Ren'Py Visual Novel Engine).

Project description

unrpa - Extract files from the RPA archive format.


unrpa is a tool to extract files from the RPA archive format (from the Ren'Py Visual Novel Engine.

It can also be used as a library.


Package manager

The best way to install unrpa is through your package manager, if a package is available for your operating system. I maintain an AUR package for Arch Linux users.


You can also install unrpa through pip, the Python package manager. You can do this on Windows with:

py -3 -m pip install "unrpa"

Or use python3 rather than py -3 on unix systems. You can see the official documentation for more help installing through pip.

From source

You can also download the latest release and extract it.


You will need Python 3.7 or later in order to run it (either install through your package manager or directly from

If you are trying to extract more exotic RPA archives, there may be additional dependencies. unrpa should instruct you how to install them if required.


When installed through your package manager or pip, you should be able to use unrpa by opening a terminal or command prompt and doing something like:

unrpa -mp "path/to/output/dir" "path/to/archive.rpa"

If you are running from source, you will need execute python directly:

  • On most unix systems, open a terminal in the directory containing unrpa then:

    python3 -m unrpa -mp "path/to/output/dir" "path/to/archive.rpa"
  • On most Windows systems, open a Command Prompt in the directory containing unrpa then:

    py -3 -m unrpa -mp "path\to\output\dir" "path\to\archive.rpa"

Command line usage

usage: unrpa [-h] [-v] [-s] [-l] [-p PATH] [-m] [-f VERSION]
             [--continue-on-error] [-o OFFSET] [-k KEY] [--version]


Positional Argument Description
FILENAME the RPA file to extract.
Optional Argument Description
-h, --help show this help message and exit
-v, --verbose explain what is being done [default].
-s, --silent no output.
-l, --list only list contents, do not extract.
-p PATH, --path PATH will extract to the given path.
-m, --mkdir will make any non-existent directories in extraction path.
-f VERSION, --force VERSION forces an archive version. May result in failure.
Possible versions: RPA-1.0, RPA-2.0, RPA-3.0, ALT-1.0, ZiX-12A, ZiX-12B, RPA-3.2.
--continue-on-error try to continue extraction when something goes wrong.
-o OFFSET, --offset OFFSET sets an offset to be used to decode unsupported archives.
-k KEY, --key KEY sets a key to be used to decode unsupported archives.
--version show program's version number and exit


Common errors

  • Check you are using the latest version of Python 3.
  • Check you are using quotes around file paths.
  • Video guides may be out of date, please check this file for up-to-date advice on using the tool.

New errors

If something goes wrong while extracting an archive, please make an issue.

New variants of the RPA format get created regularly, so new games might not work - generally support can be added quickly though.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for unrpa, version 2.1.1
Filename, size File type Python version Upload date Hashes
Filename, size unrpa-2.1.1-py3-none-any.whl (26.1 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size unrpa-2.1.1.tar.gz (12.2 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page