Scan your filesystem and get an XML file compatible with GrandPerspective on macOS to visualize disk usage.
- Recursively scans directories and files
- Generates XML output compatible with GrandPerspective
- Skips symbolic links to prevent infinite loops
- Handles file permissions and errors
You can download prebuilt binaries in the GitHub Releases.
brew install kojix2/brew/gpscan
cargo install gpscan
gpscan [OPTIONS] <directory>
gpscan ./foo > result.gpscan
gpscan --gzip > result.gpscan.gz
- Transfer the
result.gpscan
file to your Mac. - Open it in GrandPerspective.
-o, --output <FILE> Output file (default: stdout)
-A, --apparent-size Use apparent size instead of disk usage
-m, --mounts Cross filesystem boundaries during scan
-Z, --zero-files Include zero-byte files in scan
-E, --empty-folders Include empty folders in scan
-q, --quiet Suppress all informational messages
-z, --gzip Compress output using gzip
-s, --zstd Compress output using zstd
-h, --help Print help
-V, --version Print version
RUST_LOG
: Set logging level (e.g.,RUST_LOG=debug gpscan /path
)
- Windows: Physical file size calculation uses estimated 4KB cluster size
- Linux/macOS: Uses actual filesystem block information for accurate physical sizes
git clone https://github.com/kojix2/gpscan.git
cd gpscan
cargo build --release
This project includes code generated by AI tools.