Homebrew-Cask

Important: Homebrew-Cask changed its default Caskroom location. See the relevant issue and pull request for details. If you have been bitten by this change, please see this before commenting or opening an issue.

Important: Homebrew-Cask changed its behaviour from linking apps to moving them. See the relevant issue and pull request for details.

“To install, drag this icon…” no more!

Homebrew-Cask extends Homebrew and brings its elegance, simplicity, and speed to the installation and management of GUI Mac applications such as Google Chrome and Adium.

We do this by providing a friendly Homebrew-style CLI workflow for the administration of Mac applications distributed as binaries.

It’s implemented as a homebrew external command called cask.

Let’s try it!

To start using Homebrew-Cask, you just need Homebrew installed.

$ brew cask install google-chrome
==> Downloading https://dl.google.com/chrome/mac/stable/GGRO/googlechrome.dmg
==> Moving App 'Google Chrome.app' to '/Applications/Google Chrome.app'
🍺  google-chrome staged at '/usr/local/Caskroom/google-chrome/latest' (3 files, 288K)

And there we have it. Google Chrome installed with a few quick commands: no clicking, no dragging, no dropping.

$ open /Applications/"Google Chrome.app"

Learn More

Find basic documentation on using Homebrew-Cask in USAGE.md
Want to contribute a Cask? Awesome! See CONTRIBUTING.md
Want to hack on our code? Also awesome! See hacking.md
More project-related details and discussion are available in the documentation

Questions? Wanna chat?

We’re really rather friendly! Here are the best places to talk about the project:

Start an issue on GitHub using one of these templates:
Join us (and caskbot) on IRC at #homebrew-cask on Freenode
Join us on Gitter

Reporting Bugs

We still have bugs — and we are busy fixing them! If you have a problem, don’t be shy about reporting it on our GitHub issues page. Always search for your issue before posting a new one.

When reporting bugs, remember that Homebrew-Cask is an independent project from Homebrew. Do your best to direct bug reports to the appropriate project. If your command-line started with brew cask, bring the bug to us first!

Before reporting a bug, make sure you have the latest versions of Homebrew, Homebrew-Cask, and all Taps by running the following command:

$ brew update; brew cleanup; brew cask cleanup

In addition, if you haven’t yet, run the following once to switch to the new system:

$ brew uninstall --force brew-cask; brew update

If it's been a while since you last updated Homebrew-Cask, you may still have the old phinze/cask tap installed. Run the following to clean up, then try your command again:

$ brew untap phinze/cask; brew untap caskroom/cask; brew update

If the issue persists, please use our bug report template to report the output of running the problematic command with the --verbose flag, along with the output of brew cask doctor.

License

Code is under the BSD 2 Clause (NetBSD) license

underspecified/homebrew-cask