https://github.com/drpetersonfernandes/batchconverttorvz
A Windows desktop utility for batch converting GameCube and Wii disc images to RVZ format with verification capabilities.
https://github.com/drpetersonfernandes/batchconverttorvz
dolphin dolphin-emu gamecube iso rvz tools wii
Last synced: about 2 months ago
JSON representation
A Windows desktop utility for batch converting GameCube and Wii disc images to RVZ format with verification capabilities.
- Host: GitHub
- URL: https://github.com/drpetersonfernandes/batchconverttorvz
- Owner: drpetersonfernandes
- License: gpl-3.0
- Created: 2025-05-23T17:03:27.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2026-04-12T06:38:29.000Z (3 months ago)
- Last Synced: 2026-04-12T08:11:09.736Z (3 months ago)
- Topics: dolphin, dolphin-emu, gamecube, iso, rvz, tools, wii
- Language: C#
- Homepage: https://www.purelogiccode.com
- Size: 15.8 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: ReadMe.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# Batch Convert to RVZ
[](https://github.com/drpetersonfernandes/BatchConvertToRVZ/releases)
[](https://dotnet.microsoft.com/download/dotnet/10.0)
[](LICENSE.txt)
[](https://github.com/drpetersonfernandes/BatchConvertToRVZ/releases)
A Windows desktop utility for batch converting GameCube and Wii disc images to RVZ format with verification capabilities.
## Overview
Batch Convert to RVZ is a comprehensive Windows application that provides a user-friendly interface for converting multiple GameCube and Wii game files to the RVZ format. It uses **DolphinTool** from the Dolphin Emulator project for conversions and verification, while providing advanced features like batch processing and archive extraction.
## Features
### Conversion Features
- **Batch Processing**: Convert multiple files in a single operation.
- **Supported Input Formats**: Handles GameCube and Wii disc images (`.iso`, `.gcm`, `.wbfs`, `.nkit.iso`) and archives containing them (`.zip`, `.7z`, `.rar`).
- **Archive Extraction**: Automatically extracts and processes game files from ZIP, 7Z, and RAR archives using SharpCompress.
- **Configurable Compression**: Customize compression method, level, and block size for optimal results.
- **Smart File Handling**: Skips files that already exist in the output directory.
- **Delete Original Option**: Optionally remove source files (including archives) after successful conversion.
- **Robust Parsing**: Advanced logic for handling compound extensions like `.nkit.iso` and localized number formats.
### Verification Features
- **RVZ Integrity Verification**: Verify the integrity of existing RVZ files using DolphinTool.
- **Real-time Feedback**: Live logging of DolphinTool verification output (not just at the end).
- **Batch Verification**: Check multiple RVZ files in a single operation.
- **File Organization**: Automatically move verified files to `_Success` or `_Failed` subfolders.
- **Detailed Reporting**: Get comprehensive verification results for each file.
### User Experience
- **Smooth Progress Tracking**: A single, overall progress bar that smoothly tracks the entire batch operation, including real-time percentages from active tasks.
- **Intelligent Auto-Scroll**: The log viewer only snaps to the bottom if you are already looking at the latest logs, allowing you to read previous errors without interruption.
- **Immediate Cancellation**: Stop extractions and conversions instantly, even for massive 8GB+ files, thanks to asynchronous I/O and cancellation token support.
- **Optimized Logging**: High-performance log processing that handles thousands of lines without UI stuttering or high memory usage.
- **Thread-Safe Dialogs**: Robust UI handling that prevents crashes when showing error messages or update prompts from background threads.
- **Auto-Update Checking**: Accurate version comparison between GitHub release tags and assembly versions with seamless GitHub integration.
### Technical Features
- **Asynchronous Architecture**: Fully async/await implementation to keep the UI responsive during intensive I/O and processing.
- **Cross-Architecture Support**: Native support for both x64 and ARM64 Windows systems.
- **Global Error Reporting**: Automatic bug reporting to developers with comprehensive error details.
- **Robust Cleanup**: Asynchronous retry logic for deleting locked temporary files and directories.
- **Memory Management**: Efficient string handling and proper resource disposal to prevent leaks.
## Architecture
The application follows a modular architecture with clear separation of concerns:
| Component | Responsibility |
|-----------|----------------|
| `MainWindow` | UI coordination, user interaction handling, operation orchestration |
| `ConversionService` | Core conversion logic, progress tracking, cancellation support |
| `VerificationService` | RVZ integrity verification with real-time output |
| `ExtractionService` | Archive extraction (ZIP, 7Z, RAR) with cancellation support |
| `FileService` | File scanning, filtering, and output path management |
| `UpdateService` | GitHub API integration for checking application updates |
| `BugReportService` | Automatic error reporting to development team |
| `StatsService` | Statistics tracking for conversion and verification operations |
| `SharedHttpHandler` | Shared HttpClient configuration for update and bug report services |
| `FileItem` | Data model for file state, progress, and status tracking |
| `GitHubRelease` | Data model for GitHub release information |
| `SystemInfo` | System information data model |
| `DolphinTool` | External tool for RVZ conversion and verification |
| `SharpCompress` | Third-party library for archive extraction |
## Supported File Formats
### Input Formats
- **ISO files**: GameCube and Wii disc images (`.iso`)
- **GCM files**: GameCube disc images (`.gcm`)
- **WBFS files**: Wii Backup File System images (`.wbfs`)
- **NKit ISO files**: NKit compressed ISO files (`.nkit.iso`)
- **Archive files**: ZIP, 7Z, and RAR archives containing game files (`.zip`, `.7z`, `.rar`)
### Output Formats
- **RVZ files**: Compressed GameCube/Wii disc images (`.rvz`)
## Requirements
- **Runtime**: [.NET 10.0 Runtime](https://dotnet.microsoft.com/download/dotnet/10.0)
- **Operating System**: Windows 10 or later (x64 or ARM64)
- **Dependencies**: All required files are included in the release:
- `DolphinTool.exe` (x64 systems)
- `DolphinTool_arm64.exe` (ARM64 systems)
## Installation
1. Download the latest release from the [Releases page](https://github.com/drpetersonfernandes/BatchConvertToRVZ/releases)
2. Extract the ZIP file to a folder of your choice
3. Run `BatchConvertToRVZ.exe`
## Usage
### Converting Files
1. **Select Input Folder**: Click "Browse" next to "Input Folder" to select the folder containing game files or archives to convert.
2. **Select Output Folder**: Click "Browse" next to "Output Folder" to choose where the RVZ files will be saved.
3. **Configure General Settings**:
- Check "Delete original files after conversion" to remove source files after successful conversion.
4. **Configure Compression Settings**:
- **Method**: Choose compression algorithm (zstd, zlib, lzma, lzma2, bzip2, lz4).
- **Level**: Adjust compression level (varies by method, e.g., 1-22 for zstd).
- **Block Size**: Select block size (32KB to 2MB, 128KB recommended).
5. **Start Conversion**: Click "Start Conversion" to begin the batch process.
6. **Monitor Progress**: Watch the smooth overall progress bar, statistics, and real-time log messages.
7. **Cancel (if needed)**: Click "Cancel" to stop the operation gracefully and instantly.
### Verifying RVZ Files
1. **Switch to Verify Tab**: Click the "Verify Integrity" tab.
2. **Select Verify Folder**: Click "Browse" to select the folder containing RVZ files to verify.
3. **Configure Options**:
- Check "Move failed RVZ files to '_Failed' subfolder" to organize problematic files.
- Check "Move successful RVZ files to '_Success' subfolder" to organize verified files.
4. **Start Verification**: Click "Start Verification" to begin checking file integrity with real-time feedback.
5. **Review Results**: Check the log and statistics for detailed verification results.
### Menu Options
- **File > Exit**: Close the application.
- **Help > Check for Updates**: Manually check for new versions on GitHub.
- **Help > About**: View application information and credits.
## Compression Settings Guide
### Compression Methods
| Method | Speed | Compression | Use Case |
|--------|-------|-------------|----------|
| **zstd** (default) | Fast | Good | Best balance for most users |
| zlib | Medium | Good | Maximum compatibility |
| lzma/lzma2 | Slow | Excellent | Maximum compression |
| bzip2 | Slow | Good | Alternative option |
| lz4 | Very Fast | Moderate | Speed priority |
### Recommended Settings
- **Default**: zstd, level 5, 128KB block size
- **Maximum Compression**: lzma2, level 9, 2MB block size
- **Fastest Conversion**: lz4, level 1, 32KB block size
## About RVZ Format
RVZ is a compressed disk image format developed specifically for the Dolphin Emulator. It is designed to store GameCube and Wii game data efficiently while retaining all necessary information for emulation.
### Key Benefits
- **Efficient Compression**: Significantly reduces file sizes compared to raw ISO images using advanced compression algorithms like Zstandard.
- **Lossless**: Compression is completely lossless, meaning no game data is lost during conversion.
- **Metadata Preservation**: Maintains all important disc metadata and structure.
- **Data Integrity**: Includes built-in verification to ensure image integrity.
- **Full Compatibility**: Directly supported by modern versions of Dolphin Emulator.
- **Faster Loading**: Often loads faster than uncompressed ISOs due to reduced I/O overhead.
## Troubleshooting
- **Missing Dependencies**: Ensure `DolphinTool.exe` (or `DolphinTool_arm64.exe` for ARM64 systems) is present in the application directory.
- **Permission Issues**: Make sure you have read permissions for input directories and write permissions for output directories.
- **Archive Extraction Failures**: Verify that the archive files are not corrupted. The app now supports instant cancellation if extraction hangs.
- **Conversion Errors**: Check the detailed real-time log output for specific error messages.
- **Performance Issues**: Try reducing the number of concurrent files if you experience system instability.
- **Auto-Reporting**: The application automatically reports unexpected errors to developers for continuous improvement.
## Development
### Project Structure
```
BatchConvertToRVZ/
├── App.xaml.cs # Application entry point, global exception handling
├── MainWindow.xaml # Main UI definition
├── MainWindow.xaml.cs # Main UI logic and operation orchestration
├── AboutWindow.xaml # About dialog UI
├── AboutWindow.xaml.cs # About dialog logic
├── services/
│ ├── BugReportService.cs # Automatic error reporting service
│ ├── ConversionService.cs # Core conversion logic
│ ├── ExtractionService.cs # Archive extraction logic
│ ├── FileService.cs # File scanning and filtering
│ ├── SharedHttpHandler.cs # Shared HTTP client configuration
│ ├── StatsService.cs # Statistics tracking service
│ ├── UpdateService.cs # GitHub update checking service
│ └── VerificationService.cs # RVZ integrity verification
├── models/
│ ├── FileItem.cs # File state and progress tracking model
│ ├── GitHubRelease.cs # GitHub API response model
│ └── SystemInfo.cs # System information model
├── icon/ # Application icons
├── images/ # UI images (menu icons, logo)
├── DolphinTool*.exe # External conversion/verification tool
└── BatchConvertToRVZ.Tests/ # Unit tests (xUnit)
```
### Building from Source
1. Install [.NET 10.0 SDK](https://dotnet.microsoft.com/download/dotnet/10.0)
2. Clone the repository
3. Run `dotnet build` or open in Visual Studio / JetBrains Rider
### Running Tests
The project includes unit tests covering models and services using xUnit:
```bash
dotnet test
```
## Acknowledgements
- **DolphinTool**: Uses `DolphinTool` from the [Dolphin Emulator project](https://dolphin-emu.org/) for RVZ conversion and verification.
- **SharpCompress**: Uses the [SharpCompress](https://github.com/adamhathcock/sharpcompress) library for reliable archive extraction.
- **Development**: Created and maintained by [Pure Logic Code](https://www.purelogiccode.com)
## Support the Project
### ⭐ Give us a Star!
If you find this application useful, please consider giving us a star on GitHub! It helps others discover the project and motivates us to continue improving it.
[⭐ Star this project on GitHub](https://github.com/drpetersonfernandes/BatchConvertToRVZ)
### 💖 Support Development
This application is developed and maintained for free. If you'd like to support continued development and new features, consider making a donation:
[💖 Donate to Pure Logic Code](https://www.purelogiccode.com/donate)
Your support helps us:
- Add new features and improvements
- Maintain compatibility with new versions of dependencies
- Provide ongoing bug fixes and support
- Create more useful tools for the community
---
Thank you for using **Batch Convert to RVZ**! For more information, support, and other useful tools, visit [purelogiccode.com](https://www.purelogiccode.com)