Mac Storage Manager

View on GitHub
Mac Storage Manager

Mac Storage Manager

An interactive shell tool that scans, ranks, and optionally uninstalls storage hogs on macOS/Linux via a clear menu interface.

Key Features

  • 🔍 Calculates disk usage for Homebrew formulas, casks, and application bundles (.app / .desktop)
  • ⚡ Quick scan vs. full scan using sudo find (mount-aware or exhaustive search)
  • 🧩 Deduplicates results to show the largest size per application
  • 🗑️ Direct uninstallation via Brew, apt, dnf/yum, or pacman
  • 🛡️ Protects critical system apps (e.g., Finder, Safari, Terminal)
  • 🌐 Localization: supports over 40 languages via config file
  • 🔈 Optional sound feedback (toggle on/off)
  • 📜 Logs all actions to a log file

Installation

  1. Clone the repo:
    git clone https://github.com/NarekMosisian/mac-storage-manager.git
  2. Make scripts executable:
    cd mac-storage-manager
chmod +x *.sh
  3. Install dependencies:
    • jq (JSON parsing)
    • whiptail or newt (dialog boxes)
    • afplay (macOS) / paplay (Linux)
    # macOS
brew install jq newt

# Debian/Ubuntu
sudo apt-get update && sudo apt-get install jq newt paplay

First Run

Launch the main script:

./main.sh

Choose “Quick Scan” or “Full Scan” then select the largest items for removal.

Homebrew Tap

For easy installation and updates via Brew:
NarekMosisian/homebrew-mac-storage-manager

Known Issues

  • Full sudo find scans can be slow on large drives.
  • Requires permissions to delete system-level files.
  • whiptail/newt must be installed correctly.
  • Tested primarily on Bash (macOS).

License & Support

License: AGPL-3.0
LICENSE