wmc is a macOS CLI tool that reclaims storage taken up by WhatsApp media. It deletes downloaded files, clears stale references from WhatsApp's database, and removes the local media cache — so WhatsApp shows "tap to re-download" instead of broken media.
brew install Rahularya01/tap/wmcNo Rust required. Works on Apple Silicon and Intel Macs.
Requires Rust:
cargo install --git https://github.com/Rahularya01/wmc --tag v0.3.0Open the interactive terminal UI built with tuirealm. This is now the default when you run wmc with no subcommand.
wmcInside the UI you can:
- review total usage by media type
- inspect the heaviest contacts and largest files
- preview a clean before deleting anything
- rescan after WhatsApp downloads new media
See how much storage WhatsApp media is taking up in a plain non-interactive report.
wmc analyzeExample output:
Scanning: ~/Library/Group Containers/.../Message/Media
Images 42 file(s) 18.30 MB
Videos 8 file(s) 412.10 MB
Audio 15 file(s) 6.20 MB
──────────────────────────────────────
Total 65 file(s) 436.60 MB
Run `wmc` for the interactive UI or `wmc clean` to free up this space.
Delete all WhatsApp media files. You'll be asked to confirm before anything is deleted.
wmc cleanSkip the confirmation prompt:
wmc clean --yesPreview what would be deleted without actually deleting anything:
wmc clean --dry-run| Option | Description |
|---|---|
--path <DIR> |
Use a custom media directory instead of the default |
-h, --help |
Show help |
- Close WhatsApp before running
wmc clean— if WhatsApp is open, the database may be locked and deleted files could appear as corrupted instead of re-downloadable. - After cleaning,
wmcwill restart WhatsApp automatically if it was able to update the database. - This tool is macOS-only — it relies on WhatsApp Desktop's container paths and macOS system commands.
- Bump
versioninCargo.toml. - Commit and push to
main. - Tag and push the release:
git tag v0.x.0 && git push origin v0.x.0 - GitHub Actions builds the macOS binaries, creates the release, and updates the Homebrew formula automatically.