Mac Storage Manager

Features

• Delete History Viewer – shows every removed app with timestamps.
• Fast vs. Full Scans – mount-aware search or exhaustive disk crawl.
• Cross-platform discovery of .app and .desktop files.
• Interactive whiptail menus for selection & confirmation.
• Package-manager removal via brew, apt, dnf/yum, pacman.
• Critical-App-Protection to avoid deleting system-critical apps.
• Sound toggle for audio feedback on/off.
• Localization – supports over 40 languages.

Installation & Setup

1. Repo klonen

   git clone https://github.com/NarekMosisian/mac-storage-manager.git

2. Skripte ausführbar machen

   cd mac-storage-manager
   chmod +x *.sh

3. Abhängigkeiten installieren
   • jq (JSON-Parsing)
   • whiptail oder newt (Dialoge)
   • afplay (macOS) / paplay (Linux)

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

Running the Tool

./main.sh

Homebrew Support

Official Homebrew tap: NarekMosisian/homebrew-mac-storage-manager

Known Issues

• Performance: full sudo find scan can be slow.
• Permissions: ensure rights to delete system files.
• Dialogs: whiptail/newt must be installed.
• Shell: tested on Bash.

Dependencies

• jq
• whiptail/newt
• afplay (macOS) / paplay (Linux)

What Is Deleted

• Application bundles (.app, .desktop)
• Support, Caches, Preferences, Logs, Saved State
• Homebrew formulas/casks (macOS only)
• Extra files found by scan (with confirmation)

Warning

Data loss is permanent. Review files carefully before deleting.