rvthtool/README.md

RVT-H Tool

This is an open-source tool for managing RVT-H Reader consoles.

Current Features

• Lists all disc images currently installed on the RVT-H system.
• Lists "deleted" images that aren't accessible on the RVT-H but are still present on the HDD.
• Extracts disc images from the RVT-H into an image file.
• Allows deletion and undeletion of banks on an RVT-H system.
• Signature verification for all Wii disc images. Indicates if the signature is valid, invalid, or fakesigned. (Game partition only at the moment.)
• Installation of GameCube and Wii disc images. Wii disc images must be either unencrypted or debug-encrypted in order to run correctly.
• Automatic re-signing of retail Wii disc images to allow them to run on the RVT-H system. (Update partitions will be removed, since retail updates won't work properly on RVT-H.)
  • NOTE: Currently broken on Windows due to /dev/urandom not existing.

Planned Features

• Support for both CISO and WBFS formats for importing.
• Standalone disc image re-signing to convert e.g. retail to debug, debug to retail, unencrypted to debug, etc. Conversion to retail will result in a fakesigned image.
  • Support for both CISO and WBFS formats for converting retail to debug and vice-versa, but not encrypted to unencrypted.
• RVT-H device scanning to determine which device names are associated with connected RVT-H Readers.

A future version will also add a GUI.

Usage

The following commands assume /dev/sdb is the RVT-H device.

Full unencrypted RVT-H disk image dumps taken from the front-panel USB port and by dumping the drive directly are also supported.

Direct device access on Windows is possible by specifying \\.\PhysicalDriveN, where N is the physical disk number. Disk Management will show the physical disk number in the bottom pane.

WARNING: Disk Management will prompt to initialize the RVT-H device. DO NOT ALLOW IT TO INITIALIZE THE DRIVE; this may cause data loss.

List disc images: sudo ./rvthtool list /dev/sdb

Extract disc image: sudo ./rvthtool extract /dev/sdb 1 disc.gcm

• Replace 1 with the bank number.

Delete a bank: sudo ./rvthtool delete /dev/sdb 1

• Replace 1 with the bank number.

Undelete a bank: sudo ./rvthtool undelete /dev/sdb 1

• Replace 1 with the bank number.

Import a GameCube or Wii game: sudo ./rvthtool import /dev/sdb 1 disc.gcm

• Replace 1 with the bank number.
• If the game is retail-encrypted, it will be converted to debug encryption and signed using the debug keys.

Encryption

The RVT-H's internal hard drive is not encrypted. This allows rvthtool to operate on an RVT-H system that's connected directly using USB, as well as disk image dumps from both the USB interface and from a direct HDD dump.

Disc images on the RVT-H may or may not be encrypted:

• GameCube: Not encrypted.
• Wii: May be encrypted using the RVT-R debug key, or not encrypted.

Wii disc images encrypted using the RVT-R debug key are currently playable on the Dolphin emulator and on retail consoles with a USB loader, if the image is re-encrypted and fakesigned using the retail keys.

Unencrypted Wii disc images are not currently usable on Dolphin or retail consoles. I have been working on adding unencrypted image support to Dolphin but have not been successful yet.

Note about Debug IOS

RVT-R disc images typically include debug versions of IOS. These will not install on retail consoles, since they're encrypted with debug keys. Do NOT attempt to install them by re-encrypting them with the retail keys. Doing so will most likely result in a brick, especially if the 128 MB mode IOS WADs are used.