2018-09-04 16:25:49 +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
2023-01-25 04:25:49 +08:00
Homebrew Cask extends [Homebrew ](https://brew.sh ) and brings its elegance, simplicity, and speed to the installation and management of GUI macOS applications such as Visual Studio Code and Google Chrome.
2012-03-05 10:46:30 +08:00
2018-09-04 16:25:49 +08:00
We do this by providing a friendly CLI workflow for the administration of macOS applications distributed as binaries.
2012-03-05 10:46:30 +08:00
2020-12-12 07:01:52 +08:00
[![Join us on GitHub discussions ](https://img.shields.io/badge/github-discussions-informational )](https://github.com/Homebrew/discussions)
2015-03-22 23:56:27 +08:00
2015-09-07 21:23:51 +08:00
## Let’ s try it!
2015-09-16 06:24:11 +08:00
2018-09-04 16:25:49 +08:00
To start using Homebrew Cask, you just need [Homebrew ](https://brew.sh/ ) installed.
2015-12-22 20:33:44 +08:00
2023-01-25 04:25:49 +08:00
< img src = "https://i.imgur.com/FNNM6WL.gif" width = "547" alt = "Installing and uninstalling Alfred (animated gif)" >
2015-09-16 06:24:11 +08:00
2016-07-02 12:39:51 +08:00
Slower, now:
2015-09-16 06:24:11 +08:00
2013-09-19 23:14:57 +08:00
```
2020-11-28 07:14:18 +08:00
$ brew install alfred
==> Downloading https://cachefly.alfredapp.com/Alfred_4.2.1_1187.dmg
2016-07-02 12:39:51 +08:00
######################################################################## 100.0%
2020-11-28 07:14:18 +08:00
==> Verifying SHA-256 checksum for Cask 'alfred'.
==> Installing Cask alfred
==> Moving App 'Alfred 4.app' to '/Applications/Alfred 4.app'.
🍺 alfred was successfully installed!
2016-07-02 12:39:51 +08:00
```
2020-11-28 07:14:18 +08:00
And there we have it. An application installed with one quick command: no clicking, no dragging, no dropping.
2015-09-16 06:24:11 +08:00
2016-01-11 21:56:20 +08:00
## Learn More
2012-10-11 02:55:24 +08:00
2021-12-16 08:48:02 +08:00
* Find basic documentation on using Homebrew Cask in [USAGE.md ](USAGE.md ).
* Want to contribute a Cask? Awesome! See [CONTRIBUTING.md ](CONTRIBUTING.md ).
* More project-related details and discussion are available in the [documentation ](doc ).
2013-07-09 22:30:07 +08:00
2016-06-19 23:41:05 +08:00
## Reporting bugs
2013-07-09 22:30:07 +08:00
2021-12-16 08:48:02 +08:00
[**If you ignore this guide, your issue may be closed without review** ](doc/faq/closing_issues_without_review.md )
2013-07-09 22:30:07 +08:00
2019-01-25 00:15:27 +08:00
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.
2017-04-01 22:47:53 +08:00
2019-01-25 00:15:27 +08:00
If your issue persists, [search for it ](https://github.com/Homebrew/homebrew-cask/search?type=Issues ) 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.
2017-04-01 22:47:53 +08:00
2019-01-25 00:15:27 +08:00
If the issue is still not solved, see the guides for common problems:
2013-09-23 02:37:18 +08:00
2019-01-25 00:15:27 +08:00
* [Examples of common errors and their solutions ](doc/reporting_bugs/error_examples.md )
2022-01-17 07:39:13 +08:00
* [`curl` error ](doc/reporting_bugs/error_examples.md#curl-error )
* [`Permission denied` error ](doc/reporting_bugs/error_examples.md#permission-denied-error )
* [`Checksum does not match` error ](doc/reporting_bugs/error_examples.md#checksum-does-not-match-error )
* [`source is not there` error ](doc/reporting_bugs/error_examples.md#source-is-not-there-error )
* [`wrong number of arguments` error ](doc/reporting_bugs/error_examples.md#wrong-number-of-arguments-error )
2021-12-23 08:14:04 +08:00
* [App isn’ t included in `upgrade` ](https://docs.brew.sh/FAQ#why-arent-some-apps-included-during-brew-upgrade )
* [The app can’ t be opened because it is from an unidentified developer ](https://docs.brew.sh/FAQ#why-cant-i-open-a-mac-app-from-an-unidentified-developer )
2021-06-09 08:27:27 +08:00
* [My problem isn’ t listed ](https://github.com/Homebrew/homebrew-cask/issues/new?template=01_bug_report.yml )
2014-02-21 21:58:19 +08:00
2016-06-19 23:41:05 +08:00
## Requests
2016-01-04 17:59:19 +08:00
2021-05-04 11:30:14 +08:00
* Issues requesting new casks will be closed. If you want a cask added to the main repositories, [submit a pull request ](https://github.com/Homebrew/homebrew-cask/blob/HEAD/CONTRIBUTING.md#adding-a-cask ).
2021-07-11 00:57:57 +08:00
* For a feature request, [use this template ](https://github.com/Homebrew/homebrew-cask/issues/new?assignees=&labels=&template=02_feature_request.yml ).
2016-01-04 17:59:19 +08:00
2016-06-19 23:41:05 +08:00
## Questions? Wanna chat?
2016-01-04 17:59:19 +08:00
2016-06-19 23:41:05 +08:00
We’ re really rather friendly! Here are the best places to talk about the project:
2015-12-10 22:47:04 +08:00
2020-01-16 10:28:21 +08:00
* [Open an issue ](https://github.com/Homebrew/homebrew-cask/issues/new/choose ).
2021-12-16 08:48:02 +08:00
* Join us on [GitHub discussions (forum) ](https://github.com/Homebrew/discussions ).
2015-01-11 01:36:08 +08:00
2016-01-11 19:37:41 +08:00
## License
2021-12-16 08:48:02 +08:00
Code is under the [BSD 2 Clause (NetBSD) license ](LICENSE ).