Skip to content

Releases: MetalSyntax/DiskRecovery

DiskRecovery v0.1.0 — first public release

Choose a tag to compare

@MetalSyntax MetalSyntax released this 28 Jul 02:09

First public, open-source release of DiskRecovery: a macOS TUI for low-level
disk recovery and formatting, written in Rust (ratatui + crossterm).

Built for the case of an external drive with slow or damaged sectors (the
original motivating case: a 320GB Toshiba drive) that Disk Utility.app hangs
or takes forever on before it even shows up.

Highlights

  • Disk list with manufacturer, size, bus, and partition scheme; the
    system boot disk is always hidden and can never be selected.
  • Format as GPT or MBR (ExFAT, FAT32, or Mac OS Extended Journaled for
    GPT).
  • Quick wipe — zeroes the partition table (head + backup GPT header)
    with a real byte-progress bar, throughput, and ETA.
  • Full sweep — zeroes the entire disk to force the drive's firmware to
    reallocate damaged sectors to its spare pool, where possible.
  • SMART check (read-only) — combines diskutil info with smartctl
    attributes like Reallocated_Sector_Ct when smartmontools is installed.
  • Mandatory typed confirmation before any destructive action, plus a
    --dry-run mode to explore the whole interface without touching a real
    disk.
  • Stall detection — flags when an operation hasn't reported progress in
    5+ seconds, which is exactly what happens when a bad sector starts
    failing.

What's new in this release

  • MIT license — this project is now FOSS.
  • Bilingual docs: README.md (English) and README.es.md (Spanish).
  • 70+ unit tests (state machine, executor argument-building, plist parsing,
    byte-level wipe correctness, and full-screen rendering via an in-memory
    TestBackend) — no real hardware touched.
  • .claude/skills/ with contributor guides on architecture, testing,
    security, i18n, TUI design, and release packaging.
  • CI (fmt/clippy/test on every push) and a release workflow that
    builds this very .app bundle.

Installation

Download DiskRecovery-0.1.0-macos.zip below, unzip it, and open
DiskRecovery.app. Since it isn't notarized with a paid Apple Developer
account, Gatekeeper will warn about an unidentified developer the first
time — right-click → Open, or run:

xattr -d com.apple.quarantine DiskRecovery.app

Verify the download against the published .sha256 checksum before running
it, since this tool needs root to operate on raw block devices.

⚠️ Warning

This tool writes directly to block devices. Formatting and wiping are
irreversible. Always verify the disk identifier, manufacturer, and size
on the confirmation screen before typing the identifier and pressing Enter.

**Full Changelog**: https://github.com/MetalSyntax/DiskRecovery/commits/v0.1.0