Skip to content

RVZSharp 1.1.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 09 Oct 21:57
· 13 commits to master since this release
v1.1.0
45c0492

RVZSharp 1.1.0 Release Notes

RVZSharp 1.1.0 is a feature and correctness release. The public API stays compatible
with 1.0.0 (validated at pack time against the published package via
PackageValidationBaselineVersion), so upgrading is a drop-in.

dotnet add package RVZSharp

What's new

Formats & verification

  • Legacy writers — CisoWriter, WbfsWriter and TgcWriter complete the container
    matrix and are exposed as convert -f ciso|wbfs|tgc; all-zero blocks/clusters are
    stored absent, so scrubbed images shrink.
  • Wii verification — DiscVerifier walks every partition's h0/h1/h2/h3 hash tree
    plus the TMD/H3 tables and reports per-partition issues (verify --partitions).
  • Retail ticket keys — partition keys are decrypted from the ticket with the Wii
    common key (Dolphin: TicketReader::GetTitleKey), so verify --partitions, extract
    and RVZ writing work on real encrypted discs; RVZ/WIA inputs prefer the container's
    authoritative partition key. WiiVolume.GetTitleKey(ticket) exposes the decryption.
  • Extract fixes — tmd.bin/cert.bin/h3.bin are read at their partition-relative
    offsets, h3.bin is skipped for hashless discs, and partition headers are printed by
    extract --list.
  • WBFS fixes — hd_sector_count is relative to the stream position, and the disc
    header copy is written at offset 0x200 for tools that identify discs without
    decoding.
  • Zero-group decode — RVZ/WIA partition chunks that are entirely zeroes are decoded
    back to zeroes instead of rejecting the missing exception lists.

CLI

  • --json for convert and verify, - stdin/stdout piping, and
    rvzsharp completions bash|zsh|fish|powershell. Logs and progress go to stderr, so
    stdout stays machine-readable.
  • convert --verify honors Ctrl+C (exit code 130), writer progress reaches exactly
    1.0, and the update check never blocks help runs.
  • Extract path safety — -s paths and image file names can no longer escape the
    output folder; hostile names fail with a format error.

Performance & robustness

  • Thread-safe ReadAt with a 16 MiB LRU decoded-unit cache, binary-search area lookup
    and ArrayPool group reads.
  • Parallel group compression and parallel RVZ/WIA full-image decode (--threads,
    byte-identical output for any thread count); Native AOT/trimming validated.
  • IBlobReader.Length, the async API (CopyToAsync/ReadFullyAsync/WriteAsync),
    split plain ISO (game.part0.iso), BlobStream, DiscInfo, Scrub and path
    overloads.

CLI downloads (1.1.0 bundles)

The 1.1.0 bundles are framework-dependent single-file executables: install the
.NET 10 Runtime once, then unzip
and run. They are far smaller than the self-contained 1.0.0 bundles and now cover six
runtimes, including macOS:

File Platform
rvzsharp_v1.1.0_win-x64.zip Windows 10/11, x64
rvzsharp_v1.1.0_win-arm64.zip Windows 11, arm64
rvzsharp_v1.1.0_linux-x64.zip Linux, x64
rvzsharp_v1.1.0_linux-arm64.zip Linux, arm64
rvzsharp_v1.1.0_osx-x64.zip macOS, Intel
rvzsharp_v1.1.0_osx-arm64.zip macOS, Apple Silicon

Each zip holds the RVZSharp executable (RVZSharp.exe on Windows) plus LICENSE,
README.md, WhatsNew.md and THIRD-PARTY-NOTICES.md. Verify downloads against
SHA256SUMS.txt.

Upgrading from 1.0.0? The 1.0.0 bundles were self-contained; 1.1.0 bundles require the
.NET 10 Runtime to be installed.

Trust, verified

  • 609 library tests on each of net8.0/net9.0/net10.0 plus 57 CLI tests and
    a 276-test real-file suite (90 GameCube/Wii RVZ games decoded against their official
    No-Intro SHA-1s and re-encoded back to the same hash).
  • Audited against Dolphin's implementation and the rvz-1.0.3 Go reference; every
    divergence pinned by a regression test.

Install & documentation
NuGet RVZSharp 1.1.0
Docs the docs/ wiki — format specs, library API, CLI reference
Repository github.com/purelogiccode/RVZSharp

License

GPL-2.0-or-later — the RVZ/WIA format logic derives from
Dolphin, and the library is licensed under the
same terms Dolphin uses. All dependencies and third-party components are credited in
THIRD-PARTY-NOTICES.md.

Assets 8
Loading