Skip to content

kojix2/gpscan

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

gpscan

Cargo Build & Test Crates.io Crates.io Lines of Code

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

Installation

Downloading

You can download prebuilt binaries in the GitHub Releases.

Homebrew

homebrew tap

brew install kojix2/brew/gpscan

Building

cargo install gpscan

Usage

Basic usage

gpscan [OPTIONS] <directory>
gpscan ./foo > result.gpscan
gpscan --gzip > result.gpscan.gz
  1. Transfer the result.gpscan file to your Mac.
  2. Open it in GrandPerspective.

Options

  -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

Environment Variables

  • RUST_LOG: Set logging level (e.g., RUST_LOG=debug gpscan /path)

Platform Notes

  • Windows: Physical file size calculation uses estimated 4KB cluster size
  • Linux/macOS: Uses actual filesystem block information for accurate physical sizes

Development

git clone https://github.com/kojix2/gpscan.git
cd gpscan
cargo build --release

License

MIT

This project includes code generated by AI tools.

About

Generate GrandPerspective-compatible XML files

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •  

Languages