Metadata-Version: 2.1
Name: unrpa
Version: 2.1.1
Summary: Extract files from the RPA archive format (from the Ren'Py Visual Novel Engine).
Home-page: https://github.com/Lattyware/unrpa
Author: Gareth Latty
Author-email: gareth@lattyware.co.uk
License: UNKNOWN
Keywords: renpy rpa archive extract
Platform: UNKNOWN
Classifier: Topic :: System :: Archiving
Classifier: Programming Language :: Python :: 3.7
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Operating System :: OS Independent
Classifier: Environment :: Console
Requires-Python: >=3.7
Description-Content-Type: text/markdown

# unrpa - Extract files from the RPA archive format.

## About

unrpa is a tool to extract files from the RPA archive format (from 
[the Ren'Py Visual Novel Engine](http://www.renpy.org/).

It can also be used as a library.

## Installation

### 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](https://aur.archlinux.org/packages/unrpa/) for Arch Linux users.

### pip

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](https://packaging.python.org/tutorials/installing-packages/) for more help installing 
through pip.

### From source

You can also [download the latest release](https://github.com/Lattyware/unrpa/releases/latest)
and extract it.

## Dependencies

You will need Python 3.7 or later in order to run it (either install through
your package manager or
[directly from python.org](https://www.python.org/downloads/)).

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.

### Examples

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]
             FILENAME
```

### Options

| 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.<br>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                         |

## Errors

### 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](https://github.com/Lattyware/unrpa/issues/new). 

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


