2015-03-23 10:00:36 +08:00
# Homebrew-Cask
2013-08-13 05:03:06 +08:00
2015-03-23 10:00:36 +08:00
_“To install, drag this icon…” no more!_
2013-04-05 16:10:59 +08:00
2012-03-05 10:46:30 +08:00
Let's see if we can get the elegance, simplicity, and speed of Homebrew for the
2013-12-08 02:16:58 +08:00
installation and management of GUI Mac applications such as Google Chrome and Adium.
2012-03-05 10:46:30 +08:00
2014-01-18 09:14:48 +08:00
Homebrew-cask provides a friendly homebrew-style CLI workflow for the
2012-03-05 10:46:30 +08:00
administration of Mac applications distributed as binaries.
2015-01-10 00:38:35 +08:00
It's implemented as a `homebrew` [external command ](https://github.com/Homebrew/homebrew/blob/master/share/doc/homebrew/External-Commands.md )
2014-09-08 21:33:33 +08:00
called `cask` .
2012-03-05 10:46:30 +08:00
2015-03-22 23:56:27 +08:00
[![Build Status ](https://img.shields.io/travis/caskroom/homebrew-cask/master.svg )](https://travis-ci.org/caskroom/homebrew-cask)
[![Code Climate ](https://img.shields.io/codeclimate/github/caskroom/homebrew-cask.svg )](https://codeclimate.com/github/caskroom/homebrew-cask)
[![Coverage Status ](https://img.shields.io/coveralls/caskroom/homebrew-cask.svg )](https://coveralls.io/r/caskroom/homebrew-cask)
2013-04-29 03:20:03 +08:00
## Let's try it!
2013-09-19 23:14:57 +08:00
```sh
2014-07-21 13:52:11 +08:00
$ brew install caskroom/cask/brew-cask
2013-09-19 23:14:57 +08:00
$ brew cask install google-chrome
=> Downloading https://dl.google.com/chrome/mac/stable/GGRO/googlechrome.dmg
=> Success! google-chrome installed to /opt/homebrew-cask/Caskroom/google-chrome/stable-channel
=> Linking Google Chrome.app to /Users/phinze/Applications/Google Chrome.app
```
2013-12-08 02:16:58 +08:00
And there we have it. Google Chrome installed with a few quick commands: no clicking, no dragging, no dropping.
2013-09-19 23:14:57 +08:00
```sh
2014-09-16 20:30:12 +08:00
$ open ~/Applications/"Google Chrome.app"
2013-09-19 23:14:57 +08:00
```
2013-04-29 03:20:03 +08:00
## Learn More
2012-10-11 02:55:24 +08:00
2014-01-18 09:14:48 +08:00
* Find basic documentation on using homebrew-cask in [USAGE.md ](USAGE.md )
2014-01-19 00:20:29 +08:00
* Want to contribute a Cask? Awesome! See [CONTRIBUTING.md ](CONTRIBUTING.md )
2014-12-03 01:20:13 +08:00
* Want to hack on our code? Also awesome! See [hacking.md ](doc/hacking.md )
2014-03-01 21:24:24 +08:00
* More project-related details and discussion are available in [FAQ.md ](doc/FAQ.md ) and [CASK_LANGUAGE_REFERENCE.md ](doc/CASK_LANGUAGE_REFERENCE.md )
2013-07-09 22:30:07 +08:00
## Questions? Wanna chat?
We're really rather friendly! Here are the best places to talk about the project:
2014-05-03 23:16:12 +08:00
* Start an [issue on GitHub ](https://github.com/caskroom/homebrew-cask/issues/new )
2013-07-09 22:30:07 +08:00
* Join us on IRC, we're at `#homebrew-cask` on Freenode
2013-09-23 02:37:18 +08:00
2014-01-27 23:45:24 +08:00
## Reporting Bugs
We still have bugs -- and we are busy fixing them! If you have a problem, don't
2015-03-15 22:02:13 +08:00
be shy about reporting it on our [GitHub issues page ](https://github.com/caskroom/homebrew-cask/issues?state=open ). Always search for your issue before posting a new one.
2014-01-27 23:45:24 +08:00
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!
2015-01-11 11:49:24 +08:00
Before reporting a bug, make sure you have the latest versions of homebrew,
2014-02-21 21:58:19 +08:00
homebrew-cask, and all Taps by running the following command:
```bash
2014-06-14 20:39:58 +08:00
$ brew update & & brew upgrade brew-cask & & brew cleanup & & brew cask cleanup
2014-02-21 21:58:19 +08:00
```
2015-01-12 01:22:00 +08:00
If the issue persists, please run the problematic command with the `--verbose` flag
and post its and `brew cask doctor` 's outputs in distinct [fenced code blocks ](https://help.github.com/articles/github-flavored-markdown/#fenced-code-blocks ).
2015-01-11 01:36:08 +08:00
2013-09-23 02:37:18 +08:00
## License:
2014-01-07 16:08:08 +08:00
Code is under the [BSD 2 Clause (NetBSD) license ](LICENSE )