DiskShelf 1.3.0

DiskShelf — a private, read-only catalog of all your external drives on macOS. Scan a drive once, then browse its entire file tree, sizes, previews and structure long after it's unplugged.

⚠️ Beta — a personal project, shared as-is. Works well and is safe by design (read-only, no networking), but it's an early build and not notarized yet.

📥 Install

1. Download DiskShelf-v1.3.0.dmg below and open it.
2. Drag DiskShelf onto the Applications folder.
3. Allow the first launch (the build isn't notarized, so macOS blocks it — it's safe):
   • Most reliable (macOS Sequoia & Tahoe) — run once in Terminal, then open the app normally:

     xattr -dr com.apple.quarantine /Applications/DiskShelf.app
     

     It only clears the "downloaded from the internet" flag; it doesn't modify the app.
   • Via Settings (older macOS) — after it's blocked, open System Settings → Privacy & Security, scroll down, click "Open Anyway", confirm. (On Tahoe this button is often hidden — use the Terminal method.)
4. On the first scan, allow read-only access to removable volumes.

Full step-by-step is inside the DMG ("How to install.txt"). Requires macOS 13+ · Apple Silicon & Intel.

✨ Highlights

• 🔎 Global search across every scanned drive at once (⇧⌘F), offline ones included
• 🔌 Offline browsing of folders, sizes, dates and structure
• 🔢 Drive numbers matching your physical labels, shown everywhere and in exports
• 🧮 Space planner — suggests what to move where to free N GB (never touches files)
• ♻️ Duplicate finder across drives, with reveal-in-Finder
• 📤 Export the whole catalog to CSV / Markdown / JSON

🔒 Safety

DiskShelf never writes to the drives it scans — a scan is read-only enumeration. No networking; everything stays local. See SECURITY.md.