An Android application to extract and create Ren'Py RPA files directly on your device.

• Extract RPA Archives: Unpack Ren'Py game archives to access images, scripts, audio, and other assets
• Create RPA Archives: Package files and folders into RPA v3 format archives
• Batch Operations:
  • Extract multiple RPA files at once to a shared destination folder
  • Combine multiple files/folders into a single RPA archive
• Multi-Select Support: Long-press to select multiple files or folders for batch operations
• Smart Directory Defaults: Output directory automatically defaults to the location of selected input files
• Direct File Path Access: Uses direct filesystem access for fast operations
• Real-time Progress Tracking: View extraction/creation progress with file counts, speed, and ETA

• Android 11 or higher
• MANAGE_EXTERNAL_STORAGE permission: Required for direct file system access
• Storage: Enough space for extracted/created archives

1. Download the latest APK from the Releases page
2. Enable "Install from Unknown Sources" if needed
3. Install the APK
4. Grant storage permissions when prompted (MANAGE_EXTERNAL_STORAGE)

• Android Studio Arctic Fox or later
• Android SDK with API 34+
• Python 3.8+ (for Chaquopy build)
• Gradle 8.0+

1. Clone the repository:

   git clone https://github.com/yourusername/Rentool.git
   cd Rentool

2. Open the project in Android Studio

3. Sync Gradle files (Android Studio should prompt automatically)

4. Build the APK:

   • Via Android Studio: Build → Build Bundle(s) / APK(s) → Build APK(s)
   • Via Command Line:

     ./gradlew assembleDebug

5. The APK will be located at:

   app/build/outputs/apk/debug/app-debug.apk
   

The project uses Chaquopy to integrate Python for RPA archive handling. Chaquopy will automatically detect your Python installation during build.

If auto-detection fails, you can manually specify your Python path in app/build.gradle:

python {
    buildPython "/path/to/python"
}

1. Tap the "Extract RPA" card
2. Browse and select one or more .rpa files:
   • Single tap: Select one file
   • Long-press: Enter multi-select mode to choose multiple files
3. Select the destination folder (defaults to the folder containing the RPA files)
4. Wait for extraction to complete
5. Files will be extracted to the chosen directory (overwrites existing files)

1. Tap the "Create RPA" card
2. Browse and select files/folders to archive:
   • Single tap: Select one folder
   • Long-press: Enter multi-select mode to choose multiple items
3. Enter a name for the output RPA file (e.g., archive.rpa)
4. Wait for creation to complete
5. The RPA file will be created in the parent directory of selected items

Batch Extraction:

• Select multiple RPA files
• All files are extracted sequentially to the same destination folder
• Progress shows current file (e.g., "Extracting RPA... (2 of 5)")

Batch Creation:

• Select multiple files/folders
• All items are combined into a single RPA archive
• Files maintain their directory structure in the archive

• RPA Version: v3 (Ren'Py 7.4+)
• Format Key: 0xDEADBEEF (standard Ren'Py key)
• Compression: ZLib

• Uses direct File API for maximum performance
• Requires MANAGE_EXTERNAL_STORAGE permission on Android 11+
• Files are overwritten without prompting during extraction
• Batch creation uses temporary directory for combining multiple sources

• JSON-based progress file updated in real-time
• Polling interval: 500ms
• Tracks: file count, current file, speed (files/sec), ETA

• Language: Java, Python
• UI Framework: Material Design 3
• Python Integration: Chaquopy
• RPA Library: rpatool.py
• File Picker: Custom RecyclerView-based picker with multi-select

• RPA Format: Based on Ren'Py archive specification
• Python Integration: Chaquopy
• Folder Icons: Icons8
• Rpatool: Shizmob
• Unrpyc: CensoredUsername

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.

Contributions are welcome! Please feel free to submit a Pull Request.

This tool is intended for educational purposes and for modding/backing up Ren'Py games you own. Respect game developers' intellectual property and terms of service.

For issues, questions, or feature requests, please open an issue on the GitHub Issues page.