GerbilSoft/rvthtool
1
Fork 0
mirror of https://github.com/GerbilSoft/rvthtool.git synced 2025-06-18 19:45:35 -04:00
Code Issues Actions Packages Projects Releases Wiki Activity

README.md: Added more README stuff.

Browse Source
This commit is contained in:
David Korth 2018-01-16 22:40:35 -05:00
parent 66ea6ef47a
commit b7a09f57a2
1 changed files with 69 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

69
README.md
View File

@ -1 +1,70 @@
# RVT-H Tool
This is an open-source tool for managing RVT-H Reader consoles.
[![License: GPL v2](https://img.shields.io/badge/License-GPL%20v2-blue.svg)](https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html)
## 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.
## Planned Features
* Installation of GameCube and Wii disc images. Wii disc images must be
either unencrypted or debug-encrypted in order to run correctly.
* Support for both CISO and WBFS formats for importing.
* Direct undeletion of disc images on the RVT-H system.
* 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.)
* 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.
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
are also supported.
Direct device access on Windows is currently untested.
List disc images: `sudo ./rvthtool /dev/sdb`
Extract disc image: `sudo ./rvthtool /dev/sdb 1`
* Replace `1` with the bank number.
## Encryption
The RVT-H's front-panel USB interface is not encrypted. A raw dump of the
internal HDD taken by disassembling the system and connecting the HDD
directly to the PC may be encrypted; I have not checked this yet.
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](https://dolphin-emu.org/) 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 copies 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.