Release History

This page summarizes tagged releases and notable changes. Source: repository tags and commit history.

The LibFuseSharp NuGet package is released separately from purelogiccode/LibFuseSharp; the current package version is 1.0.1.

1.5.2 - 2026-10-29

• FUSE library is a package. Removed the vendored FuseSharp project and pinned LibFuseSharp 1.0.1 (MIT; net8.0/net9.0/net10.0). Library source, tests and releases now live in purelogiccode/LibFuseSharp.
• Clean unmount behavior preserved. The package carries the ENODEV-after-init handling (exit code 0) and readdir ENOTDIR, and supports LIBFUSESHARP_LIBRARY with the legacy SIMPLEXISODRIVE_FUSE_LIBRARY fallback.
• Tests split. The 55 FUSE library tests moved to the library repository; the app suite is 429 tests (395 core + 34 Unix), including the FuseVolumeAdapter integration tests.
• Docs and runbook. Updated the FuseSharp page, Building, Testing, Architecture, Glossary, both side menus and AGENTS.md; corrected the 1.5.1 release notes to reference LibFuseSharp.
• No breaking changes to the command line, mount behavior or supported image formats.

1.5.1 - 2026-10-29

• External unmounts are clean. umount, fusermount3 -u and Finder eject close the FUSE device; fuse_loop reports ENODEV, which is treated as a normal end of the session once init ran. The process exits with code 0 and logs that the volume was unmounted externally instead of reporting a failure.
• Correct directory errors. readdir on a regular file returns ENOTDIR; a missing path still returns ENOENT.
• No duplicate FUSE failure reports. The mount layer logs the specific cause once; the Unix front end keeps the generic exit summary below the bug-report threshold.
• FuseSharp library. The standalone FUSE 3 library now lives in its own repository and is published as LibFuseSharp 1.0.1 (MIT; net8.0/net9.0/net10.0). It adds clean external-unmount handling (ENODEV), a side-effect-free availability probe via FuseAvailability.Check(out library, candidates: null, printInstructions: false), and the LIBFUSESHARP_LIBRARY override (the legacy SIMPLEXISODRIVE_FUSE_LIBRARY name still works). The switch from the vendored project to the package landed on master after the 1.5.1 release; the 1.5.1 binaries still contain the vendored copy.
• Dependencies. CHDSharp 1.5.2, XISOSharp 1.4.4, Microsoft.NET.Test.Sdk 18.11.0, xunit.runner.visualstudio 4.0.1, Meziantou.Analyzer 3.0.317 and Roslynator.Analyzers 5.0.1.
• Documentation and automation. pages.yml deploys the GitHub Pages site and wiki.yml mirrors docs/ to the wiki, both with side menus; added SECURITY.md and the AGENTS.md release runbook; corrected the release history, version references, test counts and dependency tables.
• Tests. 484 tests (395 Windows + 89 Unix), including new FUSE session-result coverage for external unmounts.

1.5.0 - 2026-10-02

• Startup experience. The GitHub update check runs immediately at startup on both front ends; non-interactive runs print the version and URL instead of showing a dialog. A missing Dokan runtime or driver now offers the Dokan download page. -h/--help prints the usage text and exits before any network call or backend probe, and a run without arguments shows the usage text before Dokan/FUSE is checked.
• Windows command line. Options may appear before or after the mount path; a single image argument with options stays in drag-and-drop mode; folder mount paths must already exist; the administrator warning now also covers Z:.
• Reliability. Read failures surface as DokanResult.Error/-EIO instead of a silent EOF; ZArchive reader access is serialized; entry caches are case-sensitive; the XISO explorer handle is released on descriptor failures; ReaderOwningVfsVolume disposal is idempotent; and image lookup misses are classified below the bug-report threshold.
• FuseSharp. The FUSE 3 mount layer is a standalone packable library (now published as LibFuseSharp) with a new IFuseVolume/IFuseEntry POSIX-path contract. The Unix app adapts the Xbox volume through FuseVolumeAdapter, so FuseSharp no longer depends on SimpleXisoDrive.Core.
• Logging. Expected user-setup and input conditions (missing Dokan/FUSE, missing image files, invalid images, failed file-manager launches) no longer auto-report; launch statistics are tracked and awaited at shutdown, and browser Process handles are disposed.
• Tests and docs. 476 tests (395 Windows + 81 Unix) and refreshed documentation with a shared wiki/Pages side menu that now includes the FuseSharp page.

1.4.0 - 2026-09-29

• Cross-platform. The application was split into a shared SimpleXisoDrive.Core library and two front ends: SimpleXisoDrive (Windows, Dokan) and SimpleXisoDrive.Unix (Linux/macOS, FUSE 3 via libfuse3/macFUSE). Native builds are produced for win-x64, win-arm64, linux-x64, linux-arm64, osx-x64 and osx-arm64.
• Xbox ISO CHD support. .chd images mount directly through CHDSharp with on-demand hunk decompression (CHD V1–V5, all codecs). CD/GD-ROM CHDs are rejected up front and the decompressed image must parse as XDVDFS. A renamed CHD still mounts by content detection.
• Virtual image.iso. The -i/--image-iso option exposes the raw Xbox image as a virtual read-only image.iso at the mount root. Plain ISO/XISO and CISO inputs are served on demand; a ZArchive directory tree is synthesized into an XISO entirely in memory with XISOSharp’s layout primitives (byte-identical to XisoWriter.PackFromDirectory output for the same tree), and a single-embedded-XISO archive serves the embedded image. Nothing is extracted to disk.
• Review fixes and hardening. The volume size no longer double-counts image.iso for images that are not additional content; extension-specific openers fall back to content detection so renamed .iso/.chd/.zar files always mount; entry and listing caches are bounded (4096 entries / 512 listings) so a long-lived mount cannot grow without limit; disposal is idempotent across volumes and decorators; and stream/reader ownership is closed on every error path.
• FUSE-specific fixes. macOS uses the exported fuse_new_31 entry point (macFUSE’s libfuse3 disables ELF symbol versioning), the statfs wake-up poke allocates a buffer large enough for the macOS structure, temporary mount directories are cleaned up, and option matching is case-insensitive like the Windows front end.
• Services. Logging is routed through Serilog with a console level switch (--debug) and a rolling file sink; Warning-and-higher events are archived to error.log and forwarded to the bug report API with an 8-per-minute rate limit. In-flight reports are tracked and given a 5-second grace period at shutdown, all API clients share one connection pool, and the update prompt never blocks scripted runs (the Windows message box is skipped when the console is redirected).
• Tests. The suite grew from 89 to 336 tests: 286 in SimpleXisoDrive.Tests and 50 in SimpleXisoDrive.Unix.Tests (FUSE struct layouts, resolver, mount arguments, path/time/directory helpers, option validation).
• Documentation. Added a side menu for both renderings of this documentation: docs/_Sidebar.md for the GitHub wiki and docs/_data/navigation.yml + docs/_layouts/default.html for the published site (GitHub Pages). All pages were refreshed for the cross-platform, CHD and --image-iso releases.

1.3.0 - 2026-09-13

• Added the -i/--image-iso option: the mount also exposes a virtual read-only image.iso file at the volume root for emulators that only accept a disc image (such as xemu). Plain ISO/XISO and CISO inputs are served on demand (CISO blocks are decompressed through the XISOSharp block device), and a ZArchive directory tree is synthesized into an XISO entirely in memory (XISOSharp layout primitives; file data read from the archive on demand) with no extraction. The synthesized image is byte-identical to XisoWriter.PackFromDirectory output for the same tree.
• Added ZArchive (.zar) mounting: directory-tree archives expose their game files directly, and archives containing a single embedded XISO image mount that image — all with on-demand zstd block decompression and no extraction to disk.
• Introduced the IVfsVolume/IVfsEntry abstraction with XisoVfsVolume, ZarVfsVolume, ReaderOwningVfsVolume, and VfsVolumeFactory; VfsContainer is now a facade over the selected volume.
• ZAR mounting uses the ZArchiveSharp 1.3.0 mount-host reader API: node-handle enumeration (TryGetDirEntry), canonical names (TryGetNodeName), computed volume size (TotalUncompressedSize), seekable entry streams (OpenRead), shared-read opens, and typed ZArchiveOpenFailure reasons surfaced in errors.
• Migrated all XDVDFS parsing to XISOSharp 1.2.0: path images use a keep-open XisoExplorer and embedded images use the XisoReader stream APIs (including rebuilt sector-0 images). The in-repo parser (IsoSt, VolumeDescriptor, FileEntry, XisoFsFileAttributes) was removed.
• Path resolution now recognizes .iso, .xiso, .cso (single or split .1.cso sets), and .zar, and a renamed ZArchive still mounts.
• Added GitHub Actions CI: every push/pull request builds and tests on Windows and uploads TRX and coverage artifacts; the release_* workflow verifies the tag against AssemblyVersion, packages framework-dependent single-file win-x64/win-arm64 zips, and creates the GitHub release.
• Expanded the test suite from 43 to 110 tests, covering XISO directory trees and reads, the Dokan operation layer, stream-backed embedded images, parallel reads, resolver CISO cases, the virtual image.iso sources (including byte-identity with the whole-image writer), and API key decryption.
• Added tests for ZAR volumes, embedded XISO images, format detection, and the extended resolver.
• Hardened error handling: locked or unreadable images surface real I/O errors instead of “invalid image”, ZArchive open failures keep their type (missing/denied/read error vs bad format), and the embedded-ISO probe no longer leaks the archive reader on an unexpected error.
• The API key for the bug report and stats endpoints is no longer stored in plain text: it is double-encrypted in the assembly (AES-256-CBC over a SHA-256 XOR layer) and decrypted once at startup.
• Fixed a console race where the drag-and-drop key watcher could swallow the key press meant for an error prompt.
• Integrated Serilog logging with console and rolling file sinks.
• Enriched bug reports with environment details (OS, architecture, bitness, paths).
• Added regex match timeouts for wildcard searches and version parsing.
• Added analyzer packages (Meziantou, Roslynator) and analyzer-driven cleanups.
• Added XML documentation to the public API.

1.2.0 - 2026-06-21

• Added XGD3 (0x02080000) and GLOBAL (0x0FD90000) partition offset support.
• Added a unit test project covering FileEntry, IsoSt, VolumeDescriptor, path resolution, and attribute flags.
• Refactored IsoSt for testability with an internal stream constructor.
• Removed the Launch.bat helper.
• Bumped version and added company metadata to both projects.
• Cleaned up project references.

1.1.0 - 2026-04-12

• Renamed ErrorLogger to BugReport and added StatsService for anonymous launch statistics.
• Improved error handling and logging across mount and file operations.
• Added the green CRT console theme.
• Strengthened binary tree safety (cycle detection and iteration limits).
• Pointed the statistics endpoint at the production service.

1.0.3 - 2026-02-13

• Refactored InvalidImageException handling for clearer error reporting.
• Added command-line hints when a path cannot be resolved (directory, missing extension, quoting).
• Improved recovery when the specified ISO path is invalid.

1.0.2 - 2026-01-24

• Reduced the update checker HTTP timeout to 5 seconds.
• Made CheckForUpdateAsync awaitable.

1.0.1 - 2026-01-24

• Added Windows ARM64 support.
• Updated documentation for multi-architecture releases.

1.0.0 - 2026-01-24

Initial public release lineage:

• .NET 10 port with LangVersion 14 and global.json SDK pinning.
• Dokan-based mounting with write protection and administrator-aware options.
• Drive letter normalization (Z:\ -> Z:).
• Drag-and-drop mounting with automatic drive letter selection (M: through R:) and key-press unmounting.
• Update checker, error logger, and read-only XDVDFS parsing with binary tree traversal.
• Support for standard Xbox ISOs and rebuilt XISO images.

Version scheme

Versions follow major.minor.patch. Release tags use the release_<version> prefix (for example release_1.5.2), and the update checker extracts the numeric portion from GitHub tag names when comparing against the installed version. The LibFuseSharp NuGet package is versioned independently in its own repository.

See Building for where to bump the version.