321 lines
12 KiB
Groff
321 lines
12 KiB
Groff
.\" generated with Ronn/v0.7.3
|
|
.\" http://github.com/rtomayko/ronn/tree/0.7.3
|
|
.
|
|
.TH "BREW\-CASK" "1" "February 2019" "Homebrew" "brew-cask"
|
|
.
|
|
.SH "NAME"
|
|
\fBbrew\-cask\fR \- a friendly binary installer for macOS
|
|
.
|
|
.SH "SYNOPSIS"
|
|
\fBbrew cask\fR command [options] [ \fItoken\fR \.\.\. ]
|
|
.
|
|
.SH "DESCRIPTION"
|
|
Homebrew Cask is a tool for installing precompiled macOS binaries (such as Applications) from the command line\. The user is never required to use the graphical user interface\.
|
|
.
|
|
.SH "FREQUENTLY USED COMMANDS"
|
|
.
|
|
.TP
|
|
\fBinstall\fR [\-\-force] [\-\-skip\-cask\-deps] [\-\-require\-sha] [\-\-no\-quarantine] [\-\-language=\fIiso\-language\fR[,\fIiso\-language\fR \.\.\. ]] \fItoken\fR [ \fItoken\fR \.\.\. ]
|
|
Install Cask identified by \fItoken\fR\.
|
|
.
|
|
.TP
|
|
\fBuninstall\fR [\-\-force] \fItoken\fR [ \fItoken\fR \.\.\. ]
|
|
Uninstall Cask identified by \fItoken\fR\.
|
|
.
|
|
.TP
|
|
\fBsearch\fR \fItext\fR | /\fIregexp\fR/
|
|
Perform a substring search of known Cask tokens for \fItext\fR\. If the text is delimited by slashes, it is interpreted as a Ruby regular expression\.
|
|
.
|
|
.IP
|
|
The tokens returned by \fBsearch\fR are suitable as arguments for most other commands, such as \fBinstall\fR or \fBuninstall\fR\.
|
|
.
|
|
.SH "COMMANDS"
|
|
.
|
|
.TP
|
|
\fBaudit\fR [\-\-language=\fIiso\-language\fR[,\fIiso\-language\fR \.\.\. ]] [ \fItoken\fR \.\.\. ]
|
|
Check the given Casks for installability\. If no tokens are given on the command line, all Casks are audited\.
|
|
.
|
|
.TP
|
|
\fBcat\fR \fItoken\fR [ \fItoken\fR \.\.\. ]
|
|
Dump the given Cask definition file to the standard output\.
|
|
.
|
|
.TP
|
|
\fBcreate\fR \fItoken\fR
|
|
Generate a Cask definition file for the Cask identified by \fItoken\fR and open a template for it in your favorite editor\.
|
|
.
|
|
.TP
|
|
\fBdoctor\fR or \fBdr\fR
|
|
Check for configuration issues\. Can be useful to upload as a gist for developers along with a bug report\.
|
|
.
|
|
.TP
|
|
\fBedit\fR \fItoken\fR
|
|
Open the given Cask definition file for editing\.
|
|
.
|
|
.TP
|
|
\fBfetch\fR [\-\-force] [\-\-no\-quarantine] \fItoken\fR [ \fItoken\fR \.\.\. ]
|
|
Download remote application files for the given Cask to the local cache\. With \fB\-\-force\fR, force re\-download even if the files are already cached\. \fB\-\-no\-quarantine\fR will prevent Gatekeeper from enforcing its security restrictions on the Cask\.
|
|
.
|
|
.TP
|
|
\fBhome\fR or \fBhomepage\fR [ \fItoken\fR \.\.\. ]
|
|
Display the homepage associated with a given Cask in a browser\.
|
|
.
|
|
.IP
|
|
With no arguments, display the project page \fIhttps://caskroom\.github\.io/\fR\.
|
|
.
|
|
.TP
|
|
\fBinfo\fR or \fBabv\fR \fItoken\fR [ \fItoken\fR \.\.\. ]
|
|
Display information about the given Cask\.
|
|
.
|
|
.TP
|
|
\fBinstall\fR [\-\-force] [\-\-skip\-cask\-deps] [\-\-require\-sha] [\-\-no\-quarantine] \fItoken\fR [ \fItoken\fR \.\.\. ]
|
|
Install the given Cask\. With \fB\-\-force\fR, re\-install even if the Cask appears to be already present\. With \fB\-\-skip\-cask\-deps\fR, skip any Cask dependencies\. \fB\-\-require\-sha\fR will abort installation if the Cask does not have a checksum defined\. \fB\-\-no\-quarantine\fR will prevent Gatekeeper from enforcing its security restrictions on the Cask\.
|
|
.
|
|
.IP
|
|
\fItoken\fR is usually the ID of a Cask, but see \fIOTHER WAYS TO SPECIFY A CASK\fR for variations\.
|
|
.
|
|
.TP
|
|
\fBlist\fR or \fBls\fR [\-1] [\-\-versions] [ \fItoken\fR \.\.\. ]
|
|
Without any arguments, list all installed Casks\. With \fB\-1\fR, always format the output in a single column\. With \fB\-\-versions\fR, show all installed versions\.
|
|
.
|
|
.IP
|
|
If \fItoken\fR is given, summarize the staged files associated with the given Cask\.
|
|
.
|
|
.TP
|
|
\fBoutdated\fR [\-\-greedy] [\-\-verbose|\-\-quiet] [ \fItoken\fR \.\.\. ]
|
|
Without token arguments, display all the installed Casks that have newer versions available in the tap; otherwise check only the tokens given in the command line\. If \fB\-\-greedy\fR is given then also include in the output the Casks having \fBauto_updates true\fR or \fBversion :latest\fR\. Otherwise they are skipped because there is no reliable way to know when updates are available for them\.
|
|
.
|
|
.br
|
|
\fB\-\-verbose\fR forces the display of the outdated and latest version\.
|
|
.
|
|
.br
|
|
\fB\-\-quiet\fR suppresses the display of versions\.
|
|
.
|
|
.TP
|
|
\fBreinstall\fR [\-\-no\-quarantine] \fItoken\fR [ \fItoken\fR \.\.\. ]
|
|
Reinstall the given Cask\.
|
|
.
|
|
.TP
|
|
\fBsearch\fR or \fB\-S\fR [\fItext\fR | /\fIregexp\fR/]
|
|
Without an argument, display all locally available Casks for install; no online search is performed\. Otherwise perform a substring search of known Cask tokens for \fItext\fR or, if the text is delimited by slashes (/\fIregexp\fR/), it is interpreted as a Ruby regular expression\.
|
|
.
|
|
.TP
|
|
\fBstyle\fR [\-\-fix] [ \fItoken\fR \.\.\. ]
|
|
Check the given Casks for correct style using RuboCop (with custom Cask cops)\. If no tokens are given on the command line, all Casks are checked\. With \fB\-\-fix\fR, auto\-correct any style errors if possible\.
|
|
.
|
|
.TP
|
|
\fBuninstall\fR or \fBrm\fR or \fBremove\fR [\-\-force] \fItoken\fR [ \fItoken\fR \.\.\. ]
|
|
Uninstall the given Cask\. With \fB\-\-force\fR, uninstall even if the Cask does not appear to be present\.
|
|
.
|
|
.TP
|
|
\fBupgrade\fR [\-\-force] [\-\-greedy] \fItoken\fR [ \fItoken\fR \.\.\. ]
|
|
Without token arguments, upgrade all the installed Casks that have newer versions available in the tap; otherwise update the tokens given in the command line\. If \fB\-\-greedy\fR is given then also upgrade the Casks having \fBauto_updates true\fR or \fBversion :latest\fR\.
|
|
.
|
|
.TP
|
|
\fBzap\fR [\-\-force] \fItoken\fR [ \fItoken\fR \.\.\. ]
|
|
Unconditionally remove \fIall\fR files associated with the given Cask\. With \fB\-\-force\fR, zap even if the Cask does not appear to be currently installed\.
|
|
.
|
|
.IP
|
|
Implicitly performs all actions associated with \fBuninstall\fR\.
|
|
.
|
|
.IP
|
|
Removes all staged versions of the Cask distribution found under \fB<Caskroom_path>/\fR\fItoken\fR\.
|
|
.
|
|
.IP
|
|
If the Cask definition contains a \fBzap\fR stanza, performs additional \fBzap\fR actions as defined there, such as removing local preference files\. \fBzap\fR actions are variable, depending on the level of detail defined by the Cask author\.
|
|
.
|
|
.IP
|
|
\fB\fBzap\fR may remove files which are shared between applications\.\fR
|
|
.
|
|
.SH "INTERNAL COMMANDS"
|
|
.
|
|
.TP
|
|
\fB_stanza\fR \fIstanza_name\fR [ \-\-table | \-\-yaml | \-\-inspect | \-\-quiet ] [ \fItoken\fR \.\.\. ]
|
|
Given a \fIstanza_name\fR and a \fItoken\fR, returns the current stanza for a given Cask\. If no \fItoken\fR is given, then data for all Casks is returned\.
|
|
.
|
|
.SH "OPTIONS"
|
|
To make these options persistent, see the \fIENVIRONMENT\fR section, below\.
|
|
.
|
|
.P
|
|
Some of these (such as \fB\-\-prefpanedir\fR) may be subject to removal in a future version\.
|
|
.
|
|
.TP
|
|
\fB\-\-force\fR
|
|
Force an install to proceed even when a previously\-existing install is detected\.
|
|
.
|
|
.TP
|
|
\fB\-\-skip\-cask\-deps\fR
|
|
Skip Cask dependencies when installing\.
|
|
.
|
|
.TP
|
|
\fB\-\-require\-sha\fR
|
|
Abort Cask installation if the Cask does not have a checksum defined\.
|
|
.
|
|
.TP
|
|
\fB\-\-no\-quarantine\fR
|
|
Prevent Gatekeeper from enforcing its security restrictions on the Cask\. This will let you run it straightaway\.
|
|
.
|
|
.TP
|
|
\fB\-\-verbose\fR
|
|
Give additional feedback during installation\.
|
|
.
|
|
.TP
|
|
\fB\-\-appdir=<path>\fR
|
|
Target location for Applications\. The default value is \fB/Applications\fR\.
|
|
.
|
|
.TP
|
|
\fB\-\-language=<iso\-language>[,<iso\-language> \.\.\. ]]\fR
|
|
Set language of the Cask to install\. The first matching language is used, otherwise the default language on the Cask\. The default value is the \fBlanguage of your system\fR\.
|
|
.
|
|
.TP
|
|
\fB\-\-colorpickerdir=<path>\fR
|
|
Target location for Color Pickers\. The default value is \fB~/Library/ColorPickers\fR\.
|
|
.
|
|
.TP
|
|
\fB\-\-prefpanedir=<path>\fR
|
|
Target location for Preference Panes\. The default value is \fB~/Library/PreferencePanes\fR\.
|
|
.
|
|
.TP
|
|
\fB\-\-qlplugindir=<path>\fR
|
|
Target location for QuickLook Plugins\. The default value is \fB~/Library/QuickLook\fR\.
|
|
.
|
|
.TP
|
|
\fB\-\-dictionarydir=<path>\fR
|
|
Target location for Dictionaries\. The default value is \fB~/Library/Dictionaries\fR\.
|
|
.
|
|
.TP
|
|
\fB\-\-fontdir=<path>\fR
|
|
Target location for Fonts\. The default value is \fB~/Library/Fonts\fR\.
|
|
.
|
|
.TP
|
|
\fB\-\-servicedir=<path>\fR
|
|
Target location for Services\. The default value is \fB~/Library/Services\fR\.
|
|
.
|
|
.TP
|
|
\fB\-\-input_methoddir=<path>\fR
|
|
Target location for Input Methods\. The default value is \fB~/Library/Input Methods\fR\.
|
|
.
|
|
.TP
|
|
\fB\-\-internet_plugindir=<path>\fR
|
|
Target location for Internet Plugins\. The default value is \fB~/Library/Internet Plug\-Ins\fR\.
|
|
.
|
|
.TP
|
|
\fB\-\-audio_unit_plugindir=<path>\fR
|
|
Target location for Audio Unit Plugins\. The default value is \fB~/Library/Audio/Plug\-Ins/Components\fR\.
|
|
.
|
|
.TP
|
|
\fB\-\-vst_plugindir=<path>\fR
|
|
Target location for VST Plugins\. The default value is \fB~/Library/Audio/Plug\-Ins/VST\fR\.
|
|
.
|
|
.TP
|
|
\fB\-\-vst3_plugindir=<path>\fR
|
|
Target location for VST3 Plugins\. The default value is \fB~/Library/Audio/Plug\-Ins/VST3\fR\.
|
|
.
|
|
.TP
|
|
\fB\-\-screen_saverdir=<path>\fR
|
|
Target location for Screen Savers\. The default value is \fB~/Library/Screen Savers\fR\.
|
|
.
|
|
.TP
|
|
\fB\-\-no\-binaries\fR
|
|
Do not link "helper" executables to \fB/usr/local/bin\fR\.
|
|
.
|
|
.TP
|
|
\fB\-\-debug\fR
|
|
Output debugging information of use to Cask authors and developers\.
|
|
.
|
|
.SH "INTERACTION WITH HOMEBREW"
|
|
Homebrew Cask is implemented as a external command for Homebrew\. That means this project is entirely built upon the Homebrew infrastructure\. For example, upgrades to the Homebrew Cask tool are received through Homebrew:
|
|
.
|
|
.IP "" 4
|
|
.
|
|
.nf
|
|
|
|
brew update; brew cask upgrade; brew cleanup
|
|
.
|
|
.fi
|
|
.
|
|
.IP "" 0
|
|
.
|
|
.P
|
|
And updates to individual Cask definitions are received whenever you issue the Homebrew command:
|
|
.
|
|
.IP "" 4
|
|
.
|
|
.nf
|
|
|
|
brew update
|
|
.
|
|
.fi
|
|
.
|
|
.IP "" 0
|
|
.
|
|
.SH "OTHER WAYS TO SPECIFY A CASK"
|
|
Most Homebrew Cask commands can accept a Cask token as an argument\. As described above, the argument can take the form of:
|
|
.
|
|
.IP "\(bu" 4
|
|
A simple token, e\.g\. \fBgoogle\-chrome\fR
|
|
.
|
|
.IP "" 0
|
|
.
|
|
.P
|
|
Homebrew Cask also accepts three other forms in place of plain tokens:
|
|
.
|
|
.IP "\(bu" 4
|
|
A fully\-qualified token which includes the Tap name, e\.g\. \fBhomebrew/cask\-fonts/font\-symbola\fR
|
|
.
|
|
.IP "\(bu" 4
|
|
A fully\-qualified pathname to a Cask file, e\.g\. \fB/usr/local/Library/Taps/homebrew/homebrew\-cask/Casks/google\-chrome\.rb\fR
|
|
.
|
|
.IP "\(bu" 4
|
|
A \fBcurl\fR\-retrievable URI to a Cask file, e\.g\. \fBhttps://raw\.githubusercontent\.com/Homebrew/homebrew\-cask/f25b6babcd398abf48e33af3d887b2d00de1d661/Casks/google\-chrome\.rb\fR
|
|
.
|
|
.IP "" 0
|
|
.
|
|
.SH "ENVIRONMENT"
|
|
Homebrew Cask respects many of the environment variables used by the parent command \fBbrew\fR\. Please refer to the \fBbrew\fR(1) man page for more information\.
|
|
.
|
|
.P
|
|
Environment variables specific to Homebrew Cask:
|
|
.
|
|
.TP
|
|
\fBHOMEBREW_CASK_OPTS\fR
|
|
This variable may contain any arguments normally used as options on the command\-line\. This is particularly useful to make options persistent\. For example, you might add to your \.bash_profile or \.zshenv something like:
|
|
.
|
|
.IP "" 4
|
|
.
|
|
.nf
|
|
|
|
export HOMEBREW_CASK_OPTS=\'\-\-appdir=~/Applications \-\-fontdir=/Library/Fonts\'
|
|
.
|
|
.fi
|
|
.
|
|
.IP "" 0
|
|
|
|
.
|
|
.P
|
|
Other environment variables:
|
|
.
|
|
.TP
|
|
\fBSUDO_ASKPASS\fR
|
|
When this variable is set, Homebrew Cask will call \fBsudo\fR(8) with the \fB\-A\fR option\.
|
|
.
|
|
.SH "SEE ALSO"
|
|
The Homebrew Cask home page: \fIhttps://caskroom\.github\.io/\fR
|
|
.
|
|
.P
|
|
The Homebrew Cask GitHub page: \fIhttps://github\.com/Homebrew/homebrew\-cask\fR
|
|
.
|
|
.P
|
|
\fBbrew\fR(1), \fBcurl\fR(1)
|
|
.
|
|
.SH "AUTHORS"
|
|
Paul Hinze and Contributors\.
|
|
.
|
|
.P
|
|
Man page format based on \fBbrew\.1\.md\fR from Homebrew\.
|
|
.
|
|
.SH "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 \fIhttps://github\.com/Homebrew/homebrew\-cask/issues?state=open\fR\.
|
|
.
|
|
.P
|
|
When reporting bugs, remember that Homebrew Cask is an separate repository within Homebrew\. Do your best to direct bug reports to the appropriate repository\. If your command\-line started with \fBbrew cask\fR, bring the bug to us first!
|