RenPack

Open, pack and unpack Ren'Py archives (.rpa) — cross-platform desktop app for Windows and Linux (C# / .NET 10 / Avalonia 12).

Features

• Archive browser: open .rpa files via button or drag & drop. Sortable file list with size column, filter by name.
• Extract: all files or a specific selection (checkboxes) into a target folder — the archive's directory structure is preserved.
• Pack: turn a folder into a new archive in RPA-3.0 format (the version Ren'Py reads natively).
• Formats: reads RPA-2.0, RPA-3.0 and RPA-3.2 (including XOR obfuscation); writes RPA-2.0/3.0/3.2.
• Save editor: open Ren'Py save files (.save), see the screenshot and metadata (slot name, time, Ren'Py version), and edit every store variable in place — double-click or F2 changes the value (supports simple types: int, float, str, bool, None). Modifications get a gold marker (●); Save overwrites the original, Save as … writes a copy, Revert rolls everything back. The rollback log and every unknown Ren'Py class stay byte-identical — Ren'Py loads the edited save exactly like the original.
• .rpyc decompiler: turn compiled Ren'Py scripts (.rpyc) back into Ren'Py source — from inside the app, no Python, no need to start the game. Single files or entire folders (recursive, with progress). Covers dialogue, labels, menus, if/else, show/scene/hide, jump/call, python blocks, transforms with ATL bodies, screens and translations. Preserves store-variable references and reconstructs transform parameter names from the ATL body.
• AI translation: the save editor can translate variable names (which are usually short abbreviations or English words) into your target language via AI, shown in a separate column. The original name stays unchanged (it is the splice anchor when saving). Supported providers: Ollama (local, no API key), Anthropic Claude, OpenAI ChatGPT, Google Gemini, Mistral and any OpenAI-compatible endpoint (Groq, OpenRouter, LM Studio, …). API keys are stored encrypted (Windows: DPAPI; Linux/macOS: AES with a machine/user binding). Ollama models can be downloaded directly from the app (progress bar).
• Localization: the UI ships in English (default), German, French and Russian. Switch languages live under Settings → Application language — no restart needed.
• Modern card-based UI: dark theme with gold highlights, sectioned toolbars, live-focus rings, subtle row hovers. Every window inherits the same style library.
• Progress & logs: progress bar while extracting/packing, comprehensive log with automatic masking of passwords/tokens.
• Preview pane (v0.6): text, image, video and audio files (.rpy, .py, .json, .png, .jpg, .webm, .mp4, .mp3, .ogg, …) are shown live next to the file list — no need to extract first. Video shows a still frame grabbed via ffmpeg and can be played back inline at 12 fps (via ffmpeg MJPEG frame stream, real-time synced with -re). Alternative ▶ Play in default player button opens the file in your system's default player (VLC, mpv, Windows Media Player). Requires ffmpeg in PATH — the app detects it automatically and shows a per-platform install hint if missing (Fedora: sudo dnf install ffmpeg-free, Debian: sudo apt install ffmpeg, Windows: winget install Gyan.FFmpeg, macOS: brew install ffmpeg).
• Recent files, hotkeys, context menu, double-click (v0.6): Ctrl+O/P/E/F, F5, Esc, Ctrl+Shift+A/D. Recent-archives dropdown next to Open. Right-click a file for Extract single / Copy path. Double-click extracts a single file.
• Undo/Redo in the save editor (v0.6): Ctrl+Z / Ctrl+Y roll individual value edits back and forth without discarding everything.
• Save diff (v0.6): compare two save files side by side — added, removed, modified variables with filters.
• Batch extract (v0.6): pick multiple .rpa archives, each goes into its own subfolder.
• In-app log viewer (v0.6): inspect logs/RenPack.log right from the About window (filter, refresh, open folder).
• System tray + single-instance guard (v0.6): minimising drops the window into the tray, closing quits properly; a second launch raises the running instance.
• Archive diff (v0.7): compare two .rpa archives — added, removed, modified files side by side (great for analysing game updates).
• Save-to-save migration (v0.7): in the save diff view, right-click a row to copy the value from save B into the current session.
• Content filter when packing (v0.7): .DS_Store, Thumbs.db, __pycache__, .git* are skipped automatically when building an archive from a folder.
• CLI (v0.7): renpack extract archive.rpa, renpack decompile <path>, renpack diff <a> <b> for scripting and CI. Run renpack --help for details.
• KrosteMod — one-click mod installer (v0.8): pick a Ren'Py game folder, click 🚀 Build & install mod, and RenPack does the whole pipeline in one go: extract .rpa (if needed), decompile .rpyc, analyse the game, generate the mod, and drop the patched .rpy next to the originals. Original .rpyc are backed up as .rpyc.krostemod-bak, a manifest tracks every touched file so 🗑 Remove mod cleanly rolls everything back. After installing, a ▶ Launch game button starts the game's .sh/.exe directly. Mod types:
  • Walkthrough — annotates every menu: choice with what it does ({color=#e0b14c}[K love+3] [K respect-1]{/color}) so you always know the impact. Translation-aware: for games with tl/ folders, hints are injected via translate <lang> strings: blocks so translated menu text keeps working.
  • Cheat menu (F11) — an ingame overlay for direct manipulation of story stats: -10 / -1 / +1 / +10 / Set… / reset per variable, toggle for booleans, live values. Auto-groups character-container stats (fcs.morality, samantha.love) by prefix at games that use that pattern; filter matches both variable names and group labels.
  • Character rename — rename Ren'Py characters (sophia "Hi" → Anna) via a config dialog. Optional AI body-text rewrite: the AI rewrites dialogue lines so relationships/names stay consistent ("my mother" → "my aunt" when swapping the relationship).
  • AI translation — full game translation via any supported AI provider, written as a proper tl/<lang>/ folder that Ren'Py picks up natively.
  • GameProfile detection (v0.9): before generating, a per-game profile is detected (custom menu-screen names, character-container-vs-flat-store style, choice style, tl/ languages, game title). Generators consult it instead of each having their own heuristics.
  • CLI: renpack mod install <folder> [--type walkthrough|cheat], renpack mod uninstall <folder>.
• Self-update (v0.6): the About dialog can download and install a new release with one click (Windows ZIP, Linux AppImage or tar.gz) and restart the app automatically. No silent install — you always confirm.
• Update check: queries GitHub Releases (proxy-aware) and offers a hint when a new version is available.

v0.9 quality-of-life

• Inline video playback: the preview pane can play videos inline (via ffmpeg MJPEG frame stream at 12 fps, real-time via -re), no external player needed. When ffmpeg isn't installed, an install hint is shown per platform (Fedora/Debian/Windows/macOS) and the inline button hides — the external-player button still works.
• Image preview zoom: double-click a preview image (or Ctrl+Wheel) to toggle between Fit to pane and Original size — screenshots and hi-res assets are readable without extracting.
• Search inside archive contents: tick the In content box next to the filter to search inside file contents too (byte-based, works on .rpyc — matches the Pickle BINUNICODE strings). Great for finding "which script uses fcs.morality?".
• Save-editor favorites: click the ☆ column to bookmark a variable. Favorites move to the top and are remembered per save file — no more scrolling through 400 variables to find money again.
• Save-diff quick migration: each row in the save-diff view has a ← B button that copies the value from save B into save A (in addition to the right-click menu).
• Cheat menu — custom values: every numeric row has a Set… button that opens a modal for typing an absolute value (spares 47 clicks when you want to go from 3 to 50).
• Recent games in the mod installer: the ▾ dropdown next to the folder picker lists recently modded games — faster than digging through the Steam library tree every time.

Installation

Prebuilt packages live on the Releases page:

Windows: download RenPack-X.Y.Z-win-x64.zip, extract it, run RenPack.exe. No installation required (self-contained, .NET is bundled).

Linux (AppImage, recommended): download RenPack-X.Y.Z-x86_64.AppImage, mark it executable and run it:

chmod +x RenPack-*-x86_64.AppImage
./RenPack-*-x86_64.AppImage

Linux (tar.gz): extract RenPack-X.Y.Z-linux-x64.tar.gz and run ./RenPack.

Usage

Open an archive: click 📂 Open and pick a .rpa file — or drag it onto the window. The included files appear in the list; the filter box narrows them by name.

Extract everything: click ⬇ Extract all and choose a destination folder. Every file gets extracted there, subfolders included.

Extract only some files: tick the desired files in the list (the ✓ column). The status bar shows the current selection count. Then click ⬇ Extract selection.

Create a new archive: click 📦 Pack …, pick a source folder, and choose the target .rpa file. RenPack packs the folder as an RPA-3.0 archive.

Edit a save file: click 💾 Save editor, pick a .save file, and browse the store variables. Double-click a row (or press F2) to change a value. The gold ● marker shows unsaved changes; 💾 Save writes them into the original file, 💾 Save as … writes a copy, and ↩ Revert rolls them back.

Ren'Py saves typically live under ~/.renpy/<GameName>/ (Linux) or %APPDATA%/RenPy/<GameName>/ (Windows) and are named e.g. 1-1-LT1.save. Some games keep them next to the game under game/saves/.

What works today: editing simple values (int, float, str, bool, None) and Python-literal-parseable lists, dicts and tuples (e.g. [1, 2, 3], {"key": "value"} — anything ast.literal_eval accepts). Favorites (☆) pin the vars you care about to the top and are remembered per save file. The rollback log and every unknown Ren'Py class stay byte-identical — Ren'Py loads the edited file exactly like the original.

What doesn't work yet: adding brand-new variables, type changes (int → str), editing opaque Ren'Py-specific objects (Character-Container instances etc.). For those, use the Cheat mod (F11 ingame) which manipulates them via setattr at runtime.

Decompile a .rpyc file: click 🔓 .rpyc → .rpy to decompile one or more compiled Ren'Py scripts back into source. For an entire directory tree use 🔓 Folder … — RenPack walks it recursively and shows progress. Output files land next to the originals.

Translate variable names: in the save editor, click 🌐 Translate. First-time users open ⚙ Settings, pick an AI provider, and (for cloud providers) enter the API key. Ollama is the privacy-friendly default and needs no key.

Change the UI language: open ⚙ Settings → Application language and pick English, Deutsch, Français or Русский. The whole interface updates live.

Settings

• Application language: the UI language.
• AI provider: the app-wide default provider for translating variable names.
• Target language: the natural language the AI translates into (independent from the UI language — you can keep the UI in English but translate save variables into German).
• Provider-specific fields: endpoint, model name and API key (cloud providers only). Ollama can also list installed models and pull new ones directly from the settings window.

Settings live under %APPDATA%/RenPack/settings.json (Windows) or $XDG_CONFIG_HOME/RenPack/settings.json (Linux). API keys are stored encrypted, never in plain text.

For Ollama specifically, a locally running server is required:

# https://ollama.com
ollama serve

Models can be pulled from the command line (ollama pull gemma3:1b) or directly from RenPack — ⬇ Download opens a progress window.

The Test connection button in Settings sends a real test translation — handy for checking model + key before hitting Save.

Logs

RenPack logs to logs/renpack.log (rotated daily, 14 days retention). Passwords and API tokens are masked automatically. If you file a bug report, attach the relevant log lines — they save a lot of guesswork.

Development

dotnet build   # build
dotnet test    # 250+ tests (unit + headless-UI smoke tests via Avalonia.Headless)
dotnet run --project RenPack

The test suite includes headless UI smoke tests (via Avalonia.Headless — a dedicated HeadlessAvaloniaRunner dispatches test bodies onto a shared UI thread so tests work with xunit.v3 despite the official Avalonia.Headless.XUnit package being pinned to xunit v2). These smoke tests instantiate every window (MainWindow, SaveWindow, ModGeneratorWindow, SettingsWindow, AboutWindow), which catches XAML errors and broken property bindings early.

Release: the VS Code task release (tag + push) checks the git state, sets the tag and triggers the GitHub Action that builds every package.

License

MIT — see LICENSE.

---

☕ Enjoying the tool? Buy me a coffee