rs-mahito
| Crates.io | rs-mahito |
| lib.rs | rs-mahito |
| version | 0.1.0 |
| created_at | 2025-11-24 03:29:40.486436+00 |
| updated_at | 2025-11-24 03:29:40.486436+00 |
| description | A CLI tool to clear metadata from files on Windows |
| homepage | |
| repository | https://github.com/victormicco/rs-mahito |
| max_upload_size | |
| id | 1947324 |
| size | 92,449 |
Victor Micco (victormicco)
documentation
README
rs-mahito
A CLI tool to clear metadata from files on Windows NTFS filesystems.
Features
- NTFS Alternate Data Streams - Removes Zone.Identifier and other ADS that track file origin
- File Timestamps - Resets created, modified, and accessed times to a neutral date
- Office Document Properties - Clears Author, Company, Last Modified By from .docx, .xlsx, .pptx files
- File Owner - Clears NTFS file ownership (requires Administrator)
Installation
From Source
git clone https://github.com/victormicco/rs-mahito.git
cd rs-mahito
cargo build --release
The binary will be at target/release/rs-mahito.exe
From Cargo
cargo install rs-mahito
Usage
# Clean a single file
rs-mahito file -p path/to/file.txt
# Clean all files in a directory (non-recursive)
rs-mahito dir -p path/to/folder
# Clean all files recursively
rs-mahito recursive -p path/to/folder
# View file metadata info
rs-mahito info -p path/to/file.txt
# Interactive mode - select file from current directory
rs-mahito file
Options
| Flag | Description |
|---|---|
-n, --dry-run |
Preview changes without modifying files |
-v, --verbose |
Show detailed output |
-y, --yes |
Skip confirmation prompts |
-a, --admin |
Run with admin privileges (clears file owner) |
Examples
# Preview what would be cleaned
rs-mahito file -p document.docx --dry-run
# Clean entire project folder recursively without prompts
rs-mahito recursive -p ./my-project -y
# Clean with verbose output
rs-mahito dir -p ./downloads -v
# Full clean including owner (run as Administrator)
rs-mahito file -p sensitive.xlsx --admin
What Gets Cleaned
| Metadata Type | Description |
|---|---|
| Zone.Identifier | "Downloaded from internet" warning |
| SummaryInformation | OLE document properties |
| File timestamps | Created, modified, accessed dates |
| Office XML properties | Author, Company, Last Modified By |
| File owner (admin) | NTFS ownership information |
Requirements
- Windows 10/11
- Rust 1.70+ (for building from source)
License
MIT License - see LICENSE for details.
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.