/renutil

A collection of scripts to help you organise and use Ren'Py instances from the command line. Especially useful for headless servers.

Primary LanguagePythonMIT LicenseMIT

renUtil

CircleCI Downloads

Warning

renutil is no longer under active development. Focus has instead shifted to the new iteration of this project, renkit. It builds off of the lessons learned from renutil and aims to be a more robust and feature-rich solution. renutil will slowly be phased out in favor of renkit, but will remain available for the foreseeable future, though no further updates are planned.

A toolkit for managing Ren'Py instances via the command line.

renUtil can install, update, launch and remove instances of Ren'Py. The instances are completely independent from each other. It automatically sets up and configures RAPT so new instances are instantly ready to deploy to many different platforms. Best of all, renUtil automatically configures Ren'Py in such a way that you can run it headless, making it well suited for build servers and continuous integration pipelines.

Installation

renUtil can be installed via pip:

$ pip install renutil

Please note that renUtil requires Python 3 and will not provide backwards compatibility for Python 2 for the foreseeable future.

Usage

Usage: renutil [OPTIONS] COMMAND [ARGS]...

  Commands can be abbreviated by the shortest unique string.

  For example:
      clean -> c
      la -> launch
      li -> list

Options:
  -d, --debug / -nd, --no-debug  Print debug information or only regular
                                 output

  --help                         Show this message and exit.

Commands:
  cleanup    Clean temporary files of the specified Ren'Py version.
  install    Install the specified version of Ren'Py (including RAPT).
  launch     Launch the specified version of Ren'Py.
  list       List all available versions of Ren'Py.
  uninstall  Uninstall the specified Ren'Py version.

Disclaimer

renUtil is a hobby project and not in any way affiliated with Ren'Py. This means that there is no way I can guarantee that it will work at all, or continue to work once it does. Commands are mostly relayed to the Ren'Py CLI, so any issues with distribution building or startup are likely the fault of Ren'Py and not mine. renUtil is not likely to break on subsequent updates of Ren'Py, but it is not guaranteed that any available version will work correctly. Use this at your own discretion.