Homebrew-Cask

Important: Homebrew-Cask changed its default Caskroom location. See the relevant issue and pull request for details. If you are getting a warning about this and are unsure how to proceed, see this issue for a brief explanation of each option.

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 macOS applications such as Google Chrome and Adium.

We do this by providing a friendly Homebrew-style CLI workflow for the administration of macOS 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:
  • Bug report
  • Feature request
  • Cask request
• 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