Homebrew Cask

“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 Atom and Google Chrome.

We do this by providing a friendly CLI workflow for the administration of macOS applications distributed as binaries.

Let’s try it!

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

Slower, now:

$ brew cask install atom
==> Satisfying dependencies
==> Downloading https://github.com/atom/atom/releases/download/v1.35.1/atom-mac.zip
==> Downloading from https://github-production-release-asset-2e65be.s3.amazonaws.co
######################################################################## 100.0%
==> Verifying SHA-256 checksum for Cask 'atom'.
==> Installing Cask atom
==> Moving App 'Atom.app' to '/Applications/Atom.app'.
==> Linking Binary 'apm' to '/usr/local/bin/apm'.
==> Linking Binary 'atom.sh' to '/usr/local/bin/atom'.
🍺  atom was successfully installed!

And there we have it. Atom installed with one quick command: no clicking, no dragging, no dropping.

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

Reporting bugs

If you ignore this guide, your issue may be closed without review.

Before reporting a bug, run brew update-reset && brew update and try your command again. This is a fix-all that will reset the state of all your taps, ensuring the problem isn’t an outdated setup on your side.

If your issue persists, search for it before opening a new one. If you find an open issue and have any new information, add it in a comment. If you find a closed issue, try the solutions there.

If the issue is still not solved, see the guides for common problems:

• Examples of common errors and their solutions
• curl error
• Permission denied error
• Checksum does not match error
• source is not there error
• wrong number of arguments error
• The app can’t be opened because it is from an unidentified developer
• My problem isn’t listed

Requests

• Cask requests will be automatically closed. If you want a cask added, submit a pull request.
• For a feature request, use this template.

Questions? Wanna chat?

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

• If none of the templates above is appropriate, open an issue.
• Join us on discourse.brew.sh (forum)

License

Code is under the BSD 2 Clause (NetBSD) license