What is Chug?
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
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.
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 https://github.com/chrissimpkins/chug.git
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:
- App Name :
- Script Type : Shell,
- Script Path :
[local Chug repository parent directory path]/chug/src/chug.sh
- Output : Progress Bar
- Platypus Icon : Icon Selection Button > Select Image File >
[local Chug repository parent directory path]/email@example.com
- 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
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...
By default, your package updates and cleanup are indicated with a progress bar and status update text.
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).
Click the Quit button to close the update progress indicator window and exit 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/chug.sh 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.
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.