A CLI workflow for the administration of Mac applications distributed as binaries
Ruby Shell
Pull request Compare This branch is 25353 commits behind Homebrew:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.github
Casks
ci/travis
cmd
developer
doc
lib
man/man1
spec
test
.editorconfig
.gitattributes
.gitignore
.rspec
.rubocop.yml
.simplecov
.travis.yml
CONDUCT.md
CONTRIBUTING.md
Gemfile
Gemfile.lock
LICENSE
README.md
Rakefile
USAGE.md
brew-cask.rb

README.md

Homebrew-Cask

Important: Homebrew-Cask changed its behaviour from linking apps to moving them. See the relevant issue and pull request 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
==> Moving App 'Google Chrome.app' to '/Applications/Google Chrome.app'
🍺  google-chrome staged at '/opt/homebrew-cask/Caskroom/google-chrome/latest' (3 files, 288K)

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

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