mtibben / homebrew-cask

A CLI workflow for the administration of Mac applications distributed as binaries

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 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.

Slower, now:

$ brew cask install atom
==> Satisfying dependencies
complete
==> Downloading https://github.com/atom/atom/releases/download/v1.8.0/atom-mac.zip
######################################################################## 100.0%
==> Verifying checksum for Cask atom
==> Moving App 'Atom.app' to '/Applications/Atom.app'
==> Symlinking Binary 'apm' to '/usr/local/bin/apm'
==> Symlinking 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

Like most pieces of software, Homebrew-Cask has bugs — and we are busy fixing them! If you find a new bug tell us about it, but before you do make sure the problem isn’t simply an outdated setup on your side, by following this guide.

If your issue persists, follow these instructions to the appropriate course of action:

• A cask fails to install:
  • curl error
  • Permission denied error
  • sha256 mismatch error
  • source is not there error
  • Unlisted reason
• brew cask list shows wrong information
• uninstall wrongly reports cask as not installed
• Error: Unknown command: cask error
• My problem isn’t listed

Requests

• Start an issue on GitHub following one of these templates:
  • Feature request
  • Cask request

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 (and caskbot) on IRC at #homebrew-cask on Freenode
• Join us on Gitter

License

Code is under the BSD 2 Clause (NetBSD) license