RVT-H Tool
Go to file
2018-09-17 20:47:08 -04:00
cmake [cmake] FindNettle.cmake: Set NETTLE_LIBRARY and HOGWEED_LIBRARY on Windows. 2018-06-07 00:20:42 -04:00
debian rvthtool v1.1 2018-09-17 20:47:08 -04:00
doc [doc] CMakeLists.txt: Install disc_image.md. 2018-06-07 00:44:53 -04:00
extlib [getopt_msvc] Added a version of getopt for MSVC. 2018-02-13 19:44:32 -05:00
src Remove qrvthtool for v1.1. 2018-09-17 20:42:44 -04:00
win32 [win32] amd64/lib/: Strip the DLLs. 2018-04-26 00:57:36 -04:00
.gitattributes .gitattributes: Also ignore the win32/ directory, since this has precompiled binaries. 2018-04-21 13:25:16 -04:00
.gitignore [win32] Added a Win32 precompiled build of nettle-3.4 for Windows. 2018-01-28 17:19:04 -05:00
.travis.yml [qrvthtool] Initial Qt UI for rvthtool. 2018-06-07 01:56:49 -04:00
appveyor.cmd appveyor.cmd: Add QTDIR to CMAKE_PREFIX_PATH. 2018-06-07 02:05:30 -04:00
appveyor.yml appveyor.yml: Updated the version number. 2018-06-07 01:35:31 -04:00
CMakeLists.txt rvthtool v1.1 2018-09-17 20:47:08 -04:00
git_version.sh Initial import of RVT-H Tool. 2018-01-15 06:58:54 -05:00
LICENSE Initial import of RVT-H Tool. 2018-01-15 06:58:54 -05:00
NEWS.md rvthtool v1.1 2018-09-17 20:47:08 -04:00
README.md rvthtool v1.0 2018-06-07 00:22:46 -04:00
travis.sh Enable unit tests in travis-ci and appveyor. 2018-01-20 03:18:15 -05:00

RVT-H Tool

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

License: GPL v2
Travis Build Status AppVeyor Build status

RVT-H Reader, RVT-R Reader, Wii RVL-001, and Commodore 1541C

Current Features

  • Lists all disc images currently installed on the RVT-H system.
  • Can find "deleted" images that aren't accessible on the RVT-H but are still present on the HDD, and has an option to undelete these images.
    • Can undelete any image deleted by rvtwriter, which only clears the bank table entry.
    • Can undelete Wii images that were "flushed" using the front-panel button.
      • GameCube images deleted this way cannot currently be undeleted.
  • Extracts disc images from an RVT-H system or HDD image into a GCM file.
    • Supports optional recryption to convert a debug-encrypted image to retail encryption with fake-signed ticket and TMD.
  • 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 onto an RVT-H system. If importing a retail Wii disc image, it will automatically be re-signed and re-encrypted using the debug keys. (Update partitions will be removed, since retail updates won't work properly on RVT-H.)
    • Supported image formats: GCM, headered GCM, CISO, WBFS
    • Split WBFS is not currently supported. Combine the .wbfs and .wbfs1 files before processing.
  • 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.
  • Querying all available RVT-H Reader devices to determine which device name is associated with which reader. (Linux with UDEV only at the moment.)
  • Converting unencrypted debug-signed disc images to retail fake-signed and debug-encrypted debug-signed.

Planned Features

  • Extend the bank table to support more than 8 banks. Requires an RVT-H Reader with an HDD larger than 40 GB.
    • Bank 1 will be relocated to before the bank table, limiting it to GameCube images.

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.

The following commands assume /dev/sdb is the RVT-H Reader, and will extract bank 1.

  • List disc images:
    • $ sudo ./rvthtool list /dev/sdb
  • Extract a bank with no modifications:
    • $ sudo ./rvthtool extract /dev/sdb 1 disc.gcm
  • Extract a bank and convert to retail fakesigned encryption:
    • $ sudo ./rvthtool extract --recrypt=retail /dev/sdb 1 disc.gcm
  • Delete a bank:
    • $ sudo ./rvthtool delete /dev/sdb 1
    • NOTE: This will only clear the bank table entry.
  • Undelete a bank:
    • $ sudo ./rvthtool undelete /dev/sdb 1
  • Import a GameCube or Wii game:
    • $ sudo ./rvthtool import /dev/sdb 1 disc.gcm
    • If the game is retail-encrypted, it will be converted to debug encryption and signed using the debug keys.
  • Convert an RVT-R disc image to retail fakesigned:
    • $ ./rvthtool extract --recrypt=retail RVT-R.gcm RetailFakesigned.gcm
    • The bank number may be omitted if the source file is a standalone disc image instead of an RVT-H HDD image or RVT-H Reader device.
  • Query available RVT-H Readers:
$ ./rvthtool query

/dev/sdb
- Manufacturer:  Nintendo Co., Ltd.
- Product Name:  RVT-H READER
- Serial Number: abcdefgh
- HDD Firmware:  01.0
- HDD Vendor:    WDC     
- HDD Model:     WD800BEVE-00UYT0
- HDD Size:      74.5 GB

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 playable on the Dolphin emulator with no changes. They can also be used on retail consoles with a USB loader if the image is re-encrypted and fakesigned using the retail encryption key.

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.