renkit

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

renkit consists of three tools:

renutil manages Ren'Py instances and takes care of installing, launching and removing them.
renotize notarizes built distributions of Ren'Py games for macOS, from any source OS renkit supports.
renconstruct automates the build process for Ren'Py games from start to finish.

renkit is written in Rust and compiled into standalone executables, batteries included, so it's easy to use anywhere. Currently it supports the following platforms (mirroring what Ren'Py itself supports):

| OS | amd64 | aarch64 | | ------- | ----- | -------------------- | | Linux | ✅ | ✅ (deployment only) | | macOS | ✅ | ✅ | | Windows | ✅ | ❌ |

Installation

<picture> <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/Mqxx/GitHub-Markdown/main/blockquotes/badge/light-theme/warning.svg"> <img alt="Warning" src="https://raw.githubusercontent.com/Mqxx/GitHub-Markdown/main/blockquotes/badge/dark-theme/warning.svg"> </picture><br>
Note that renutil and renconstruct require Java to be installed. The recommended variant at this moment is Eclipse Temurin. Starting from Ren'Py 8.2.0, Ren'Py requires Java 21. For any versions before 8.2.0, Java 8 is required. Please ensure that the correct Java version is referenced via the JAVA_HOME environment variable before running either of the two tools.

Automatic

renkit comes with several installation options for the various supported platforms. Please check out the available options for the latest release.

Manual (Linux / Windows / macOS)

Download the pre-built binaries for your operating system and architecture for the latest release and extract the resulting tar file.

After this, either add the binaries to your PATH or use them directly from within the download directory.

renutil

List installed versions

renutil list

List remote versions

renutil list -o

Show information about a specific version

renutil show 8.3.4

Launch the Ren'Py Launcher

renutil launch 8.3.4

Launch a Ren'Py project directly

renutil launch 8.3.4 -d -- ~/my-project

We use the double dash (--) to separate the arguments for Ren'Py from renutil's. This way, you can even pass things like --help through to the underlying program without renutil interfering.

Launch a Ren'Py project with an interactive Terminal REPL

renutil launch 8.3.4 -di -- ~/my-project

Launch a Ren'Py project with custom code to run after startup

renutil launch 8.3.4 -di --code 'print("Hello World!")' -- ~/my-project

Install a specific version

renutil install 8.3.4

Remove a specific version

renutil uninstall 8.3.4

Clean up an instance after use

renutil clean 8.3.4

renconstruct

Writing a config file

renconstruct uses a TOML file for configuration to supply the information required to complete the build process for the various supported platforms. A documented template is provided in this repository under docs/renconstruct.toml.

It consists of the sections listed below, which govern the behavior of renconstruct itself as well as the built-in and custom tasks that may be optionally activated.

All tasks have the following shared properties:

type: The type of the task. Valid values are notarize, keystore, convert_images and custom. See further explanation of the various task types below.
enabled: Whether the task should run or not. Defaults to false.
priorities: A table of two optional configuration options that governs the priority of a task relative to other tasks. Higher values equate to earlier execution respective to the build stage.
- pre_build: The priority of the pre-build stage of this task. Pre-build tasks run before any distributions are built. Defaults to 0.
- post_build: The priority of the post-build stage of this task. Post-build tasks run afer distributions have been built. Defaults to 0.
on_builds: A list of build names that govern whether the task should run or not. For example, if on_builds = ["mac"] then the given task will only run if the mac build is enabled in this run of renconstruct.

`notarize`

Notarizes the macOS artifact for distribution. Same as the configuration for renotize below.

bundle_id: The internal name for your app. This is typically the reverse domain notation of your website plus your application name, i.e. com.example.mygame.
key_file: The path to your private key file, typically ends in .pem. If you used the provisioning process, it will be named private-key.pem.
cert_file: The path to the Apple-generated certificate file created during the provisioning process, typically ends in .cer. If you used the provisioning process, it will be named developerID_application.cer.
app_store_key_file: The path to the combined App Store key file generated during the provisioning process, ends in .json. If you used the provisioning process, it will be named app-store-key.json.

`keystore`

Overwrites the auto-generated keystore with the given one. This is useful for distributing releases via the Play Store, which requires the same keystore to be used for all builds, for example.

keystore_apk: The base-64 encoded binary keystore file for the APK bundles.
keystore_aab: The base-64 encoded binary keystore file for the AAB bundles.
alias: An optional alias for the keystores, will be set in local.properties and bundle.properties before building.
password: An optional password for the keystores, will be set in local.properties and bundle.properties before building.

To avoid storing sensitive information in plaintext within the configuration file, the options keystore_apk, keystore_aab and password can be supplied via the respective environment variables RC_KEYSTORE_APK, RC_KEYSTORE_AAB and RC_KEYSTORE_PASSWORD instead. Options specified within the configuration file will take precedence over the environment variables.

`convert_images`

Converts the selected images in the given directories to WebP or AVIF to save space on-disk. This task specifically replaces every selected file with its converted version but does not change the file extension to ensure that all paths to assets and sprites remain the same.

This task takes a dynamic set of properties where each key is the path to a directory containing image files to be converted and its value is a table of configuration options for that particular path. That way, various paths can be converted with different options for more flexibility.

Paths are evaluated relative to the base directory of the game, i.e. game/images/bg. Absolute paths should not be used.

Each path may specify the following properties:

extensions: The list of file extensions to use. All files with an extension in this list will be converted. Defaults to ["png", "jpg"].
recursive: Whether to scan the given directory recursively or not. Defaults to true. If not recursive, will only take the images directly in the given directory.
lossless: Whether to convert to lossless WebP or lossy WebP. Defaults to true. Lossy WebP produces smaller files but may introduce artifacts, so is better suited for things like backgrounds, while lossless WebP should be used for i.e. character sprites. This has no effect when converting to AVIF.

The image format to use may be specified at the task-level using the format key, which may be one of:

webp: Converts all images to WebP. Supports lossless mode.
avif: Converts all images to AVIF. Does not support lossless mode.
hybrid-webp-avif: Converts lossless images to WebP and the rest to AVIF for optimal space savings.

It is also possible to specify custom quality values for both encoders via these flags:

webp_quality: Range of 0 to 100. Default: 90.0.
avif_quality: Range of 0 to 100. Default: 85.0.

These quality settings will only take effect when not in lossless mode.

<picture> <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/Mqxx/GitHub-Markdown/main/blockquotes/badge/light-theme/warning.svg"> <img alt="Warning" src="https://raw.githubusercontent.com/Mqxx/GitHub-Markdown/main/blockquotes/badge/dark-theme/warning.svg"> </picture><br>
Note that AVIF is only supported in Ren'Py >=8.1.0 and does not support lossless encoding!

`build`

Specifies which distributions to build. Each of these keys may have a value of true or false.

pc: Build the Windows/Linux distribution
win: Build the Windows distribution
linux: Build the Linux distribution
mac: Build the macOS distribution
web: Build the Web distribution (only on Ren'Py >=8.2.0)
steam: Build the Steam distribution
market: Build the external marketplace distribution (i.e. Itch.io)
android_apk: Build the Android distribution as an APK
android_aab: Build the Android distribution as an AAB

`options`

Various renconstruct-specific options.

task_dir: The path to a directory containing custom Python task definitions. Only active if Python support is enabled.
clear_output_dir: Whether to clear the output directory on invocation or not. Useful for repeated runs where you want to persist previous results. Defaults to false.

`renutil`

Options to pass to renutil.

version: The version of Ren'Py to use while building the d

Renkit

Install / Use

README