Go to file
commitay bc2a1b2076 usage.md: add drivers tap (#31767) 2017-04-02 13:50:50 +01:00
.github Reporting bugs revamp (#31717) 2017-04-01 22:47:53 +08:00
Casks Update 115browser to 8.2.0.25 (#31770) 2017-04-02 13:47:54 +01:00
ci/travis Travis: Add Sierra support (#28732) 2017-01-07 20:07:49 +00:00
developer/bin sync_templates_and_ci: add drivers repo (#29357) 2017-01-24 20:37:56 +00:00
doc Reporting bugs revamp (#31717) 2017-04-01 22:47:53 +08:00
.editorconfig add .editorconfig file 2015-09-08 01:42:23 +01:00
.gitattributes Create .gitattributes 2015-09-21 13:57:20 +01:00
.gitignore Ignore vendored bundler dependencies 2016-08-02 23:06:35 -04:00
.travis.yml Travis: Add Sierra support (#28732) 2017-01-07 20:07:49 +00:00
CONDUCT.md Update Code of Conduct to Contributor Covenant 1.4 2016-02-23 22:00:02 +01:00
CONTRIBUTING.md CONTRIBUTING.md: use curly brackets in bash vars (#31347) 2017-03-27 18:22:01 +01:00
LICENSE Update LICENSE 2017-01-02 01:03:17 +08:00
README.md Reporting bugs revamp (#31717) 2017-04-01 22:47:53 +08:00
USAGE.md usage.md: add drivers tap (#31767) 2017-04-02 13:50:50 +01:00
tap_migrations.json Migrate exa to Homebrew (#31240) 2017-03-30 19:35:17 +08:00

README.md

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.

Its implemented as a homebrew external command called cask.

Build Status Join the chat at https://gitter.im/caskroom/homebrew-cask

Lets try it!

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

Installing Atom (animated gif)

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

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 will ensure the problem isnt an outdated setup on your side. Note this command is a fix-all that will reset the state of all your taps, so if you have changes on those that you want to keep, deal with them first.

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

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

Requests

Start an issue on GitHub following one of these templates:

Questions? Wanna chat?

Were 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