Simple, clickable Homebrew package management for OS X
Shell HTML
Latest commit 7f314fd Mar 31, 2016 @chrissimpkins updated readme
Failed to load latest commit information.


Chug - cool, refreshing, and no aftertaste

What is Chug?

Progress bar displays Chug progress

Chug is an OS X application that turns your routine installed Homebrew package upgrades and outdated package cleanup into a simple desktop icon click workflow.

The tool will perform the following actions through Homebrew without the need for a terminal or manual/scripted/aliased command execution on the command line:

  • Update the Homebrew formulae
  • Examine your system for outdated packages
  • Upgrade all outdated packages
  • Remove all outdated packages following successful upgrades


  • Download the Chug installer (Click Me)
  • Double click the installer icon
  • Drag and drop the icon to the Application directory in the installer window
  • Prost!

System Requirements

OS X 10.7 or later and support for 64-bit Intel binaries

The Homebrew executable must be installed on the path /usr/local/bin/brew (as recommended by the Homebrew developers) to use the default Chug build.

Use the following command to confirm that the Homebrew executable is installed on the correct path:

$ which brew

If the output from the above command is not /usr/local/bin/brew, please see the Homebrew documentation for details on how to modify your install path, or modify the Chug shell script with your Homebrew executable path and rebuild the application bundle. See the customization section below for details.


You have the option to

  • a) Install the pre-built OS X application that is released in the Chug repository
  • b) Customize and build the OS X application bundle yourself

A. Install the Pre-Built Application Bundle

Download the Chug installer, double click on the installer file, and then drag and drop the Chug application icon to the Applications directory in the installer window.

Chug drag and drop install

You can access Chug via Launchpad and pin the icon to your dock for easy access.

B. Build the Application Yourself and Install Application Bundle

You can build Chug yourself with the free, open source tool Platypus. This serves as a GUI application bundler around a simple shell script that executes your Homebrew tasks. If you intend to customize Chug before you build a new version, additional details are found below. The following instructions are current as of the Platypus v5.1 release.

Obtain the Chug repository files by either cloning the Chug repository files on your local system with git:

$ git clone

download the repository ZIP archive file, then unpack it on your system.

Download Platypus and install it on your OS X system. Launch Platypus.

Then, configure the Platypus profile settings:

Platypus settings for Chug builds

  • App Name : Chug
  • Script Type : Shell, /bin/sh
  • Script Path : [local Chug repository parent directory path]/chug/src/
  • Output : Progress Bar
  • Platypus Icon : Icon Selection Button > Select Image File > [local Chug repository parent directory path]/chug/img/chug@3x.png
  • Identifier : com.csimpkins.Chug
  • Author : Christopher Simpkins
  • Version : set to the appropriate version number (changelog)
  • Bundled Files : [local Chug repository parent directory path]/chug/docs/Credits.html

Check the Remain running after initial execution checkbox and uncheck any others that are checked by default. Click the Create button and build your application in the directory of your choice.


Double click that handsome beer label icon to start chugging...

Chug drag and drop install

Package Updates

By default, your package updates and cleanup are indicated with a progress bar and status update text.

Progress bar displays Chug progress

Click the Details dropdown to view the standard output text from Homebrew as the updates and cleanup take place (or afterwards to review a log of your updates).

Verbose output with the Details dropdown

Click the Quit button to close the update progress indicator window and exit Chug.

Customize Chug

Customize the Shell Script

Your Homebrew upgrades and cleanup are executed with an extensively annotated shell script. Load the shell script on your local Chug repository path src/ in a text editor and modify it so that it meets your needs. Then follow the build instructions above to bundle a new version of the application. Pull requests with generally useful changes are highly encouraged!

Customize the Icon

You can modify the application icon in Platypus. Click the cogwheel icon below the icon display in the upper left hand corner of the Platypus profile window and select Select Image File. Use the menus to select any image on your system. It is not necessary to use the .icns format, .png files work just fine. Use the build instructions above to bundle your application with the new icon.

If you create something shiny and neat, submit it as a pull request and we'll make it available to others who don't like chocolate brown on their desktop :)

Customize the Standard Output Typeface

Chug uses Monaco 11 as the default standard output typeface (displayed when you click the Details button on the interface). To modify it, click the Text Settings button in Platypus, then select the typeface and size that you would like to use.

Modify typeface settings in Chug

Use the build instructions above to bundle your application with the new typeface settings.


If Chug isn't cool, refreshing, with no aftertaste, please submit a new issue report on the Github repository issue tracker.


Chug is licensed under the MIT license. The full text of the license is here.