🏛️ ROSETTA SUITE

Universal Decryption & Localization Suite for Visual Novels & Narrative Games

Official Distribution Channel on SourceForge: rosetta-gts

---

📖 Overview

Rosetta is a high-performance, universal localization, decryption, and neural machine translation suite engineered specifically for Visual Novels, RPGs, and narrative-driven games.

Designed to break language barriers, Rosetta merges a sleek, modern desktop interface (Rosetta Studio) and a feature-complete automation terminal (Rosetta CLI) into a single unified powerhouse. It provides zero-configuration, first-class support for 4 industry-leading narrative game engines:

1. Ren'Py Engine (Visual Novels)
2. RPG Maker (MV, MZ, RGSS)
3. Godot Engine (3.x & 4.x)
4. Unity Engine (Mono & IL2CPP)

Distributed as a 100% Standalone Portable release for Windows and Linux: no Python installation, no external dependencies, and zero registry footprint required.

---

🚀 Key Highlights

• 100% Free & Zero Telemetry: No paywalls, no subscriptions, no user profiling, and no phoning home. Fully respects your computer and gaming privacy.
• Intelligent Engine Auto-Detection: Pass any game folder or executable: Rosetta automatically identifies the engine, extracts dialogue structures, and applies the optimal translation pipeline.
• FORGE 2 Pipeline & Rosetta Swarm 3.0:
• Blazing-fast neural translation with multi-provider AI support (Google Gemini, Groq, DeepL, Google NMT, Marian MT).
• High-concurrency worker threads with auto-retry watchdog cascades and zero idle time.
• SQLite WAL Persistent Cache: Every translated line is hashed and stored in a high-speed SQLite database with Write-Ahead Logging. Never re-translate identical lines across game updates.
• Surgical Tag & Variable Preservation: Strict deterministic parsing guarantees 100% protection for styling tags ({b}, {color=...}, \C[1], \N[2], \V[n]), control codes, escape characters, and code placeholders ([player_name], %(name)s).
• Deterministic Rollback (rosetta restore): Automated pre-patch snapshot manifests ensure you can revert any game back to its untouched original state with a single click.
• Smart Asset Compression: Built-in asset optimization pipeline reduces translated distributions and audio/image footprints by 40% to 80% without perceptible loss of quality.
• Safe Side-by-Side Auto-Update: Checks and downloads official releases directly from SourceForge, safely extracts the new version, migrates user data and settings, and cleans up the obsolete folder without risking your workspace.

---

🖥️ Rosetta Studio (Desktop GUI)

Rosetta Studio is the modern, responsive graphical workstation powered by Google Flutter & Flet. Built for high productivity, fluid animations, Dark Obsidian / Light Theme switching, and full HiDPI display scaling.

1. Unified Dashboard

• Drag & Drop game loading with instant engine auto-detection.
• Real-time telemetry monitoring: sentences per second (s/s), completion progress bar, elapsed time, and ETA.
• Quick navigation shortcuts to active project folders, translated patches, and backups.

2. Ren'Py Studio Workspace

• Direct scanning and extraction of .rpa archives and .rpy / .rpyc script files.
• Gender Agreement Auditor: Smart heuristic auditing to validate and fix male/female grammatical agreements in Romance languages (Italian, Spanish, French).
• Dedicated Spicy / Adult lexicon auditing mode for accurate and natural dialogue tone.
• Character dictionary isolation (characters.rpy) to safeguard speaker names.
• Export ready-to-share .zip patch archives (with in-game F8 live reload) or inject directly into game/tl/.

3. RPG Maker Studio (MV / MZ / RGSS)

• Precision parser for data/*.json, System.json, maps, and common events.
• Complete protection for inline JavaScript logic, message window control codes, and battle parameters.
• Smart Asset Shield: Automatically indexes audio and image filenames referenced in plugins.js and third-party script frameworks (VisuStella, Yanfly, DKTools), preventing missing-file runtime crashes.
• Seamless DKTools Localization plugin compatibility.

4. Godot Studio Workspace

• Full inspection, unpacking, and standalone repacking for Godot 3.x and 4.x .pck files.
• AES-256 Key Recovery: Automated decryption key discovery from the game binary via static disassembly and Level 3 active memory dumps.
• Direct scene (.tscn), script (.gd), and multilang CSV translation patching.
• Pure standalone repack without needing Godot editor dependencies.

5. Unity Studio Workspace

• Advanced TypeTree scanner supporting TextMeshPro and modern Unity UI Toolkit (UIElements / UXML).
• Support for encrypted assets, Addressables, and raw .assets archives.
• Dual Pipeline Strategy:
• Offline Static Injection: Direct binary patch injection for standalone asset files.
• BepInEx AutoTranslator: One-click deployment of pre-configured BepInEx runtime hook environment.

6. Android Mobile Porting Bridge

• Compiles PC Ren'Py Visual Novels into standalone native Android APK packages (ARM64 and x86_64).
• Automatic icon resizing, touch-control layout patchers, and manifest generation.
• Integrated ADB bridge for wireless and USB physical device deployment or Android Virtual Device (AVD) testing.

7. Control Panel & Settings

• Comprehensive API key management (Google Gemini, Groq, DeepL, Hugging Face) with live connection verification.
• Instant theme toggle (Dark Obsidian / Material 3 Light).
• Interactive changelog reader and direct developer support links.

---

⚡ Rosetta CLI (Command Line Interface)

For headless servers, power users, and batch workflow automation, Rosetta features a comprehensive command-line interface.

Universal Syntax

rosetta <command> [options...]
rosetta <engine> <subcommand> [options...]

Intelligent Auto-Detection Commands

• rosetta scan <game_path> [--with-ocr]
  Inspects the game, identifies its engine, and outputs comprehensive dialogue and asset statistics.
• rosetta translate <game_path> [--ocr]
  Runs the neural AI translation pipeline with optional OCR vector image button regeneration.
• rosetta compress <game_path>
  Optimizes textures and audio files, reducing overall game size by up to 80%.
• rosetta apply <game_path> <patch.zip>
  Applies a translation patch with automatic safety backup generation.
• rosetta restore <game_path>
  Rolls back all modifications, restoring the game to 100% original state.
• rosetta ocr
  Tools and guidance for translating and vector-rendering embedded UI button graphics.
• rosetta upload <file_or_patch.zip>
  Uploads patches or archives to cloud hosting with immediate direct download link generation.

Decryption & Key Discovery (Godot PCK)

• rosetta dump-key <game_or_pck_path> (alias: find-key)
  Scans process memory or executable binaries to extract 64-character hex AES-256 keys for encrypted PCK archives.

Android Mobile Porting Tools

• rosetta port-android <game_path>
  Builds a full standalone APK from a PC Visual Novel project.
• rosetta emulator <status|start|stop|run|setup>
  Controls local Android Virtual Devices (AVD) and handles physical device ADB connections.

Translation Cache & Maintenance

• rosetta cache [--detail]
  Displays SQLite cache statistics and translation coverage percentage chapter-by-chapter.
• rosetta import-tl <files_or_folders...>
  Imports external translation files (.rpy, .json, .csv) directly into the global persistent cache.
• rosetta clear-cache
  Purges the local SQLite translation cache.
• rosetta deaccent <files_or_folders...>
  Converts accented glyphs (e.g., à -> a', é -> e') for compatibility with custom or bitmap fonts lacking extended Unicode tables.
• rosetta audit-gender apply <file.json>
  Applies gender agreement audit suggestions across script files.

Dedicated Engine Commands

• rosetta renpy <scan|translate|port-android|gui|...>
• rosetta rpgm <scan|translate|compress|...>
• rosetta godot <scan|translate|dump-key|...>
• rosetta unity <scan|translate|compress|...>

System, Diagnostics & Updates

• rosetta update [--check] [--yes]
  Checks for, downloads, and applies the latest official portable update from SourceForge.
• rosetta doctor
  Runs a comprehensive environment diagnostic check (API keys, cache integrity, third-party tools).
• rosetta engines
  Displays the full engine capability matrix and decompiler backend statuses.
• rosetta version
  Prints current Rosetta Suite version, platform build number, and release channel.

---

📦 Download & Running

Windows (Portable Standalone)

1. Download the latest release ZIP from the Files section on SourceForge:
   Rosetta_Windows_v<version>_b<build>.zip
2. Extract the archive into any preferred directory (e.g., C:\Rosetta\).
3. Launch:
4. RosettaStudio.exe: for the full graphical workstation (pure GUI, no console window).
5. Rosetta.exe: for terminal and automation usage via PowerShell or Command Prompt.

Automatic Updates

When a new version is released on SourceForge, Rosetta alerts you in both Rosetta Studio and the CLI. Confirming the prompt downloads the new release, migrates your personal configurations and databases, and transitions smoothly into the updated suite.

---

🤝 Community & Credits

• Lead Developer & Creator: adisc
• Special Thanks: Giobol The Librarian for testing, validation, and specialized Ren'Py engine contributions.
• Support & Crowdfunding: If you love Rosetta and wish to support ongoing development, AI API fuel, and engine research, you can support the project on Ko-fi.