homebrew-mac-storage-manager

A Homebrew tap for Mac Storage Manager — a cross-platform shell script that helps you reclaim disk space by identifying and managing large applications on macOS and Linux.

Table of Contents

• About This Tap
• Installation
• Usage
• Updating and Uninstalling
• Continuous Integration
• More Information
• License

---

About This Tap

This repository provides a Homebrew tap so that you can easily install the Mac Storage Manager tool via Homebrew.
The script itself is maintained in the main project repository:

• Main Project: mac-storage-manager
  There, you will find:
  • Source code and documentation
  • Screenshots and a YouTube demo video
  • A detailed guide on how to use the script

---

Installation

1. Add the Tap

brew tap NarekMosisian/mac-storage-manager

2. Install the Formula

brew install mac-storage-manager

Usage

1. Run the Storage Manager

mac-storage-manager

2. Follow the Interactive Prompts

• You may be asked if you want to use sudo find for a comprehensive system-wide scan (which can take a while).
• An interactive menu (using whiptail dialogs) will appear, allowing you to select applications and associated files to remove.

Tip: If you encounter issues or want more details about the script’s functionality, please check the main project’s README.

Updating and Uninstalling

• Update

brew update
brew upgrade mac-storage-manager

This will fetch and install the latest version once it’s published in this tap.

• Uninstall

brew uninstall mac-storage-manager
brew untap NarekMosisian/mac-storage-manager

This removes the tool and optionally the tap itself.

---

Continuous Integration

This tap repository uses GitHub Actions for continuous integration. Every push and pull request to the main branch triggers a workflow that:

• Updates Homebrew (ignoring non-critical warnings)
• Installs dependencies (jq, newt)
• Builds and installs the formula from source
• Runs tests (using brew test)
• Performs a strict audit of the formula

You can view the current CI status using the badge at the top of this README.

---

More Information

• Main Project: mac-storage-manager
  Here you will find a detailed usage guide, screenshots, demo videos, and additional notes about limitations and dependencies.

• Questions or Feedback
  Please open an issue in the main project repository if you find any bugs or have suggestions.

License

The script is licensed under the GNU Affero General Public License v3.0 (AGPLv3).
For details, see the LICENSE file in the main project.

---

Enjoy cleaning up your disk space!
With this tap, you can easily install and update Mac Storage Manager via Homebrew.