Repository navigation
CHDSharp v1.5.0
CHDSharp v1.5.0 — What's New
Released: 2026-10-16 · Full changelog · NuGet
CHDSharp v1.5.0 is the first release produced end-to-end by the GitHub Actions pipeline:
one tag push builds the six platform bundles, creates the GitHub release, publishes the
NuGet package, and updates the wiki and
the documentation site.
Download (CLI)
| Platform | Bundle |
|---|---|
| Windows x64 | CHDSharp_win-x64_v1.5.0.zip |
| Windows ARM64 | CHDSharp_win-arm64_v1.5.0.zip |
| Linux x64 | CHDSharp_linux-x64_v1.5.0.zip |
| Linux ARM64 | CHDSharp_linux-arm64_v1.5.0.zip |
| macOS Intel | CHDSharp_osx-x64_v1.5.0.zip |
| macOS Apple Silicon | CHDSharp_osx-arm64_v1.5.0.zip |
Every bundle contains a framework-dependent single-file CHDSharp / CHDSharp.exe
build (the .NET runtime is not embedded) plus LICENSE.txt, README.md, README.txt
and this document. The .NET 10 runtime
is required. On Linux/macOS run chmod +x CHDSharp if the binary is not executable after
unzipping.
Fixed: built-in update check
The CLI's "a new version is available" notice now links directly to the download for
your platform. The bundle the release ships (CHDSharp_<os>-<arch>_v<version>.zip) is
exactly the name the update check looks up; previously it searched for the wrong asset
name built from the currently running version, so the direct link never resolved and
users were sent to the releases page instead.
Release engineering
- One tag, one release —
Releaseworkflow: bundles (win/linux/osx × x64/arm64),
GitHub release, NuGet push, wiki sync, Pages rebuild. The workflow refuses to run if
the tag does not matchDirectory.Build.props. - NuGet publishing is idempotent — re-running the workflow skips a version that is
already on nuget.org. - GitHub releases now ship only the CLI — the WPF Tester remains source-only.
Also in this release
- Wiki + documentation site in sync — the
docs/folder is deployed twice from CI:
as the documentation site and as the
GitHub wiki, both with the same side menu. - Dark theme by default on the documentation site (with a persisted light/dark toggle).
- Test harness hardening — test-spawned CLI runs set
CHDSHARP_NO_BUG_REPORTS=1/
CHDSHARP_NO_TELEMETRY=1, so local full-suite runs no longer file bug reports. - Badges on every README (CI, release, NuGet, platform, parity, license).
Upgrading from v1.4.3 (or earlier)
v1.5.0 rolls up everything from v1.4.4 and v1.4.5:
- Multisession cue parity — ports MAME's
REM SESSION/REM LEAD-IN/REM LEAD-OUT
/ session-pregap layout rules (IsoBuster/ImgBurn single-bin trim with zero-filled
inter-session gaps, Redump/DiscImageCreator synthesized lead-in/out,.imgheuristic).
Multisession cues now encode byte-identically tochdman createcd. - Redump multi-cue Dreamcast GD-ROM parity — cues with
REM SINGLE-DENSITY AREA/
REM HIGH-DENSITY AREAmarkers get the fullis_gdicuelayout (split pregap regions,
LBA-45000 padding,CHGDmetadata); verified byte-identical on a real 1.19 GB Redump
multi-cue with a byte-perfectchdman extractcdround-trip. - cdrdao TOC
STARTparity — a bareSTARTline (cdrdao's documented form) is
accepted as "no pregap", matching MAME 0.289'sparse_tocexactly.
NuGet
dotnet add package CHDSharp --version 1.5.0Targets net8.0, net9.0 and net10.0 — pure C#, zero native dependencies. Every
codec (zlib, lzma, huffman, flac, zstd, AVHuff and the CD variants) is implemented
in-repo and ships inside the package.