Repository navigation
pathmemo 0.2.0
Windows 10 1809 or later, x64 or arm64. One file, self-contained - no installer, and
no runtime to install alongside it.
- Download
pathmemo-0.2.0-win-x64.zip, or-win-arm64on an ARM machine. - Unpack it anywhere.
- Double-click
pathmemo.exefor the window, or run it from a terminal:
pathmemo scan,pathmemo top --min 1GB,pathmemo audit.
Windows will warn that the publisher is unknown, because the executable is not
code-signed. Choose More info -> Run anyway, or check your download against the
SHA-256 below first.
Administrator rights are optional, and change what the scanner can see: with them it
reads $MFT directly, which is roughly 40x faster and reaches paths a directory walk is
denied.
Nothing is deleted without an explicit confirmation, and what is deleted goes to a
quarantine that pathmemo restore reverses.
The first public release: one self-contained pathmemo.exe, no installer and no
runtime to install alongside it.
The two faces
- A window. Double-click the executable and it opens a real window — volume
cards with their used space, a browsable tree of the largest directories with
a clickable breadcrumb, a treemap panel, and a scan that runs from the toolbar
without freezing anything. The window is drawn directly on Win32 and GDI, so it
costs 0.27 MB of the download rather than the 100 MB a UI framework would have. - A command line. The same file, typed into a terminal, prints to that
terminal and answers with exit codes:scan,tree,top,history,diff,
audit,reclaim,dupes,rm,restore,purge,ops,errors,
export,config,status,doctor. Every one of them takes--format json
orcsvwhere a table would be the answer. - Terminal screens.
pathmemo --tuigives the same browsing in any terminal,
for a machine with no desktop — overview, tree, reclaim and duplicates.
Finding the space
- Two scanners. A directory walk that needs no rights, and a scanner that reads
$MFTdirectly when run as administrator — roughly 40× faster (1.27M files in
9.6 s against 41 s), and it sees paths a walk is denied. - An incremental rescan from the USN change journal, and scheduling to keep
snapshots current. Both need administrator rights; without them every scan is a
full one anddoctorsays so. - Snapshots are stored under
%LOCALAPPDATA%\pathmemowith a history, sodiff
can say what changed since last time — two 1.6M-node snapshots compared in
105 ms. - Space Audit: 21 probes for the space no file browser shows — shadow copies,
the component store, hibernation, page and crash dump files, Windows Update
leftovers, per-app caches.
Freeing it
- Reclaim: 31 rules over what a scan found, each with its own risk and
recovery note, so the recommendation says what is lost as well as what is
gained. - Duplicates: five stages, from a size grouping that cut 1.23M files to 8,508
candidates in 0.44 s, to a content hash with a cache that makes the second run
cheap. - Deletion, deliberately narrow. Nothing is ever deleted without an explicit
confirmation, deletions go to a quarantine thatrestorereverses, and every
operation is journalled (ops). A path guard refuses system and boot paths
before anything is touched — it held a canary intact through 19,478 junction
swaps aimed at making the deleter follow a link out of its own tree.
Known limitations of this release
- The window shows the volumes and the tree. Audit, reclaim and duplicates are
the commands and the terminal screens for now, and each tab in the window says
so rather than pretending otherwise. - The window has only been run on x64 at 96 dpi and a single monitor. The arm64
binary is built and tested by the same suite, but its window is unverified, as
is scaling above 100% and dragging between monitors of different scale. - Unelevated, the walk scanner runs: some paths are unreadable, hard-link
deduplication covers only files of 1 MB and over, and alternate data streams
are not counted. Elevation removes all three.
382 tests, passing both as an ordinary user and as an administrator, and the full list
of what is measured rather than claimed is in
README §21.
SHA-256
135538856955aec34d24d7eb25db8eacbbce66cef76b5cc5ff7db1309e1bb0ba pathmemo-0.2.0-win-arm64.zip
a13618bd5d0763d96b9dcb3d0e96fbfea63815fec44cef367f9c69e5c4bc54a0 pathmemo-0.2.0-win-x64.zip