Home

Awesome

<h1> <img src="images/brewlet-color.svg" alt="Brewlet Icon" width="64px" /> Brewlet </h1> <a href="https://github.com/zkokaja/Brewlet/releases/latest"> <img src="https://img.shields.io/github/release/zkokaja/Brewlet.svg" alt="GitHub Release"/> </a>

The missing menulet for brew.sh.

This menulet makes it easier to use brew.sh. For example, you need to manually check if some of your packages can be updated. With Brewlet it's easy: if everything is working swimmingly, then you'll see the normal shadow <img src="images/brewlet-black.svg" width="16px" /> icon. If updates are available to be installed, the icon will become colored, <img src="images/brewlet-color.svg" width="16px" /> , to get your attention – along with a notification if you wish. Once clicked, you'll be able to upgrade your packages, among other options. In addition, Brewlet will periodically check the status of packages in the background, so you don't have to.

<img src="images/statusmenu-example.png" width="300px"/>

When new versions are available, you can update all of them at once or manually choose specific packages:

<img src="images/statusmenu-update.png" width="532px"/>

Installation

Install with brew on the command line:

brew install brewlet

Or download the latest version from releases or here (zip).

You can upgrade to the latest version by running:

brew update
brew upgrade brewlet

On the horizon

I am currently working on adding more features, listed in order of priority here:

Update vs Upgrade

The update operation pulls the latest version of Homebrew and updates the metadata related to packages. From the man pages:

Fetch the newest version of Homebrew and all formulae from GitHub using git(1) and perform any necessary migrations.

Whereas upgrade will actually upgrade your outdated packages to the latest version(s).

Upgrade outdated, unpinned formulae using the same options they were originally installed with, plus any appended brew formula options.

Developer

Contributions are welcome!

You can look for logged messages and errors with the Console app, or this command:

$ log show --predicate 'process == "Brewlet"' --info
$ log show --predicate "processID == `pgrep Brewlet`" --info --last 1h

To test for outdated packages, reinstall some older versions from a specific commit. For example:

$ brew uninstall jq 
$ brew install https://raw.githubusercontent.com/Homebrew/homebrew-core/b76347c21bbe20accf0a514b138515e30a48ad12/Formula/jq.rb

To generate images of different sizes, use Inkscape on the command line:

$ len=64 # or use a for loop
$ inkscape --export-type="png" \
           --export-file brewlet-"$len".png \
           -w "$len" \
           brewlet.svg

Brew will redirect output of the upgrade command to a temporary file, you can use this command to locate it.

$ find /var/folders -type f -name 'brewlet*log' 2> /dev/null

License & Acknowledgements

Because this app is closely tied to brew.sh, I used their icon as a template. I also decided to adopt their choice of license: BSD 2-Clause "Simplified" License.

Security & Permissions

Brewlet needs to be able to access to: