Skip to content
A CLI workflow for the administration of Mac applications distributed as binaries http://caskroom.io
Ruby Shell
Latest commit 69d8ea9 @vitorgalvao vitorgalvao Merge pull request #18437 from miccal/patch-6
Update rejected-casks.md
Failed to load latest commit information.
Casks updated avocode (2.5.3)
ci/travis Run brew update in before_install
cmd Don't explicitly exit with 0 after success
developer dev/bin/find_sparkle_appcast: send browser headers
doc Merge pull request #18437 from miccal/patch-6
lib Update rubocop and rubocop-cask dependencies
man/man1 Add `style` subcommand to run RuboCop against args
spec Merge pull request #17279 from jawshooah/fix-optionparser-help
test Merge pull request #17279 from jawshooah/fix-optionparser-help
.editorconfig add .editorconfig file
.gitattributes Create .gitattributes
.gitignore minor updates to ignores
.rspec install rspec; move first few tests over
.rubocop.yml Move cask-specific rubocop configuration to Casks/.rubocop.yml
.simplecov Exclude non-core folders from test coverage
.travis.yml Travis: only build master branch
CONDUCT.md Update CONDUCT.md
CONTRIBUTING.md Update CONTRIBUTING.md
Gemfile Update rubocop and rubocop-cask dependencies
Gemfile.lock Update rubocop and rubocop-cask dependencies
LICENSE Bump year to 2016
README.md Update README.md
Rakefile initial document breaks
USAGE.md Fix many URLs in the documentation
brew-cask.rb brew-cask 0.60.1

README.md

Homebrew-Cask

Important December 2015 update: Homebrew-Cask will now be kept up to date together with Homebrew (see #15381 for details). If you haven’t yet, run brew uninstall --force brew-cask; brew update to switch to the new system.

Important: At some point in the future Homebrew-Cask will change its behaviour from linking apps to moving them. See issue #13201 for details.


“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 Mac applications such as Google Chrome and Adium.

We do this by providing a friendly Homebrew-style CLI workflow for the administration of Mac applications distributed as binaries.

It’s implemented as a homebrew external command called cask.

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

Let’s try it!

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

$ brew cask install google-chrome
==> Downloading https://dl.google.com/chrome/mac/stable/GGRO/googlechrome.dmg
==> Symlinking App 'Google Chrome.app' to '/Users/Your_Account_Name/Applications/Google Chrome.app'
🍺  google-chrome staged at '/opt/homebrew-cask/Caskroom/google-chrome/latest' (208 files, 184M)

And there we have it. Google Chrome installed with a few quick commands: no clicking, no dragging, no dropping.

$ open ~/Applications/"Google Chrome.app"

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

Questions? Wanna chat?

We’re really rather friendly! Here are the best places to talk about the project:

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. Always search for your issue before posting a new one.

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:

$ brew update; brew cleanup; brew cask cleanup

In addition, if you haven’t yet, run the following once to switch to the new system:

$ brew uninstall --force brew-cask; brew update

Finally, if it's been a while since you last updated Homebrew-Cask, you may still have the old phinze/cask tap installed. Run the following to clean up, then try your command again:

$ brew untap phinze/cask; brew untap caskroom/cask; brew update

If the issue persists, please use our bug report template to report the output of running the problematic command with the --verbose flag, along with the output of brew cask doctor.

License

Code is under the BSD 2 Clause (NetBSD) license

Something went wrong with that request. Please try again.