homebrew-cask/README.md

74 lines
3.1 KiB
Markdown
Raw Normal View History

# NOTICE: Homebrew-cask has moved!
The original repo at https://github.com/phinze/homebrew-cask has moved
under the organizational umbrella at https://github.com/caskroom/homebrew-cask .
Web redirection happens automatically.
The location of the Cask Tap on disk has also changed, which should be
handled automatically upon upgrading. If you have technical difficulties,
please see [TAP_MIGRATION.md](doc/TAP_MIGRATION.md).
# "To install, drag this icon..." no more!
[![Build Status](https://travis-ci.org/caskroom/homebrew-cask.png?branch=master)](https://travis-ci.org/caskroom/homebrew-cask)
[![Code Climate](https://codeclimate.com/github/caskroom/homebrew-cask.png)](https://codeclimate.com/github/caskroom/homebrew-cask)
[![Bitdeli Badge](https://d2weczhvl823v0.cloudfront.net/caskroom/homebrew-cask/trend.png)](https://bitdeli.com/free "Bitdeli Badge")
2013-04-05 16:10:59 +08:00
Let's see if we can get the elegance, simplicity, and speed of Homebrew for the
installation and management of GUI Mac applications such as Google Chrome and Adium.
Homebrew-cask provides a friendly homebrew-style CLI workflow for the
administration of Mac applications distributed as binaries.
It's implemented as a `homebrew` "[external
command](https://github.com/mxcl/homebrew/wiki/External-Commands)" called
`cask`.
## Let's try it!
```sh
$ brew tap caskroom/cask
$ brew install brew-cask
$ 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
```
And there we have it. Google Chrome installed with a few quick commands: no clicking, no dragging, no dropping.
```sh
open ~/Applications/"Google Chrome.app"
```
## Learn More
* Find basic documentation on using homebrew-cask in [USAGE.md](USAGE.md)
* Want to contribute a Cask? Awesome! See [CONTRIBUTING.md](CONTRIBUTING.md)
* Want to hack on our code? Also awesome! See [HACKING.md](doc/HACKING.md)
* More project-related details and discussion are available in [FAQ.md](doc/FAQ.md) and [CASK_LANGUAGE_REFERENCE.md](doc/CASK_LANGUAGE_REFERENCE.md)
## Questions? Wanna chat?
We're really rather friendly! Here are the best places to talk about the project:
* Start an [issue on GitHub](https://github.com/caskroom/homebrew-cask/issues/new)
* 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
be shy about reporting it on our [GitHub issues page](https://github.com/caskroom/homebrew-cask/issues?state=open).
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!
Before reporting a bug, make sure you have the latest versions of Homebrew,
homebrew-cask, and all Taps by running the following command:
```bash
$ brew update && brew upgrade brew-cask && brew cleanup
```
2013-09-23 02:37:18 +08:00
## License:
Code is under the [BSD 2 Clause (NetBSD) license](LICENSE)